7. 서버 자동 배포 (2) 서버에 자동 배포를 위한 runner 설치

🔴 앞의 글에서 작성한 github action과 연동되어지는 runner를 서버에 설치하는 방법을 알아보겠습니다.

 

 

1. github 홈페이지에서의 작업

가. 먼저, github의 현재 작업 repository 에서 Settings - Actions - Runners 를 선택해 준 후, New self-hosted runner 버튼을 눌러줍니다.

나. 현재 설명하는 서버는 Ubuntu 리눅스 서버이므로  Create self-hosted runner 창에서  Linux를 선택해 줍니다.

✅ 이제 위에 있는 빨간 점선에 있는 내용들을 하나씩 서버에서 실행해 주어야 합니다. 그러니, 위 github 창과 서버 ssh 접속창을 같이 열어두시고 작업하면 편할 것입니다.

 

2. 서버에서의 작업

🔴🔴 아래의 모든 작업은 반드시 사용자 권한으로 작업하시기 바랍니다.

가. 위 명령을 실행하기 전에, 서버에서 작업할 폴더를 생성할 것입니다. 저는 '/home/(본인의계정이름)' 밑에 www 라는 디렉토리를 만든 후 그 안에서 작업을 할 것입니다. (아래 예시의 경우 현재의 디렉토리는 /home/mungkhs 입니다.)

mkdir www && cd www

 

나. 이제 github 홈페이지에 있는 Download 부분의 명령줄을 하나씩 입력해 줍니다.

✅ 위 해당 명령줄을 클릭하면 저절로 복사가 됩니다.

✅ 위 명령 중 세번째 Optional : Validate the hash 부분의 echo ~~ 명령은 입력하지 않아도 됩니다.

mkdir actions-runner && cd actions-runner
curl -o actions-runner-linux-x64-2.298.2.tar.gz -L https://github.com/actions/runner/releases/download/v2.298.2/actions-runner-linux-x64-2.298.2.tar.gz
tar xzf ./actions-runner-linux-x64-2.298.2.tar.gz

 

다. github의 Configure 부분은 아래 내용을 참고하며 입력해 주어야 합니다.

🔴 위 첫번째 명령어 중 맨 뒤 --token 부분은 현재 repository와 연결된 고유 키입니다. 

🔴 두번째 명령 ./run.sh은 다르게 입력해 주어야 합니다.

 

라. 아래 코드를 github에서 복사하여 서버에 입력합니다. 그럼 아래와 같은 화면이 보일 것입니다. 우선 3가지를 물어보는데 현재는 그냥 3가지 모두 Enter를 쳐서 기본값으로 넘어가도록 하겠습니다.

 

마. 마지막 work folder를 입력하라고 합니다. 기본으로 Enter 를 그냥 치면 나중에 내가 올린 소스가

/home/내계정/www/action-runner/_work 디렉토리 밑으로 저장이 됩니다. 

그래서 저같은 경우는 /home/mungkhs/www 라고 입력하여 줍니다.

 

바. 이제 마지막으로 runner를 실행시켜 주어야 합니다. 그러기 위해 github에서의 마지막 명령어인 ./run.sh 를 입력해도 작동이 되지만, 이럴 경우 ssh창에서 로그아웃 할 경우 runner도 중지가 되버립니다. 

따라서, 아래와 같이 입력을 해주도록 합니다.

sudo ./svc.sh install             #부팅시 자동 실행
sudo ./svc.sh start               #runner 실행

 

사. 이제 서버에 설치한 Runner가 작동 중일 경우, github의 Runners 창에 아래와 같이 나올 것입니다. 이후 로컬에서 소스를 수정한 후에 push를 하면 github에 올라가는 즉시 서버로도 자동으로 전송이 될 것입니다.

🔴 다음 게시글에서는 실제 소스 수정 후 서버까지 바로 배포되는 것을 확인할 것이며, 배포시 도커 컨테이너도 자동 생성이 되도록 구현을 해 볼 것입니다.

 

3. runner 삭제 방법

가. 아래 Runners 창에서 빨간색 부분을 눌러줍니다.

 나. 아래 빨간 부분을 복사 후 서버에 입력하여 실행합니다. 단, 서버의 /home/본인계정/www/actions-runner 디렉토리 안에서 실행을 해야 합니다.

만약, 위와 같이 했는데, 아래와 같이 삭제 실패가 나오는 경우에는 먼저 sudo ./svc.sh uninstall 를 실행하세요.

 

---

🍺🍺 작업한 모든 소스는 아래 링크에서 확인하실 수 있습니다. 🍺🍺

https://github.com/mmssem/progstudy

GitHub - mmssem/progstudy

---

🍺 목차 🍺(보시려면 아래 더보기 를 눌러주세요.)

1. Docker를 사랑하게 된 이유 (Docker+Nginx_proxy+SSL+Github action)

2. Docker 설치 (Docker+Nginx_proxy+SSL+Github action)

3. MobaXterm (Docker+Nginx_proxy+SSL+Github action)

4. 도커를 이용하여 서버에 vnstat 설치 및 삭제하기(Docker+Nginx_proxy+SSL+Github action)

5. 로컬에 nginx(웹서버) 설치해보기 (Docker+Nginx_proxy+SSL+Github action)

6. 서버 자동 배포 (1) 로컬 => github (Docker+Nginx_proxy+SSL+Github action)

7. 서버 자동 배포 (2) 서버에 자동 배포를 위한 runner 설치

8. 서버 자동 배포 (3) 로컬 소스 -> git push -> github -> 서버 자동 배포 확인

9. (tip) git Add, Commit, push 한번에 하기

10. 서버 자동 배포 (4) 배포시 서버에서 docker-compose.yml 자동 실행

11. 서버에 vnstat 설치 (docker-compose.yml 이용)

12. 서버에 도커 설치시 network 설정 변경 사항 확인하기

13. nginx + php + mysql + phpmyadmin 설치하기

14. Nginx - Reverse Proxy, Load Balancing 기능 활용

15. 로컬에서 아이피 대신 도메인명 사용하기(hosts 수정)

16. https를 쓰기 위해 로컬에서 SSL 테스트 하기 (with mkcert)

17. 서버에 SSL 적용하기 (docker + Let's Encrypt + wildcard 인증서 + Cloudflare)

18. 와일드카드 인증서 자동 갱신(docker + Let's Encrypt + wildcard 인증서 + crontab)