[Github] Action: Self Hosted Runner 구성

Github Action은 훌륭하고 사용감 괜찮은 CI/CD용 서비스지만, 그냥 기본 제공 호스트만 써서는 한계가 있을 때가 많다.

1. 프로비저닝 시간이 좀 걸리고

2. 서버 성능도 그렇게 좋은 편은 아니고

3. 요금도 많진 않지만 조금 나오는데다

4. 온프레미스 머신에 직접 접근해서 처리하는게 불편하기 때문이다.

그래서 추가적인 요구사항이 있다면 Github Action에서 사용하는 Self-Hosted Runner를 사용해서 빌드 환경을 확장할 수 있다.

이렇게 설정할 경우에는 트리거와 Github 코드 복제까지만 Github에서 제공해주고, 각 머신에서 독립적으로 동작한다. 가상화도 없다. github action cache 같은 부가적인 기능들도 활용하는데 제한이 있다.

그리고 가상화 없이 해당 머신에 직접 실행되는 것이라서 빠르긴 한데, 보안이나 빌드 리소스 cleanup에 대한 고려가 조금 필요할 수 있다.

설정해보기

각 레포의 Runner 페이지로 가면,

New Self Hosted Runner... 버튼 누르면 편리하게 가이드해주는 페이지가 있다.

적당히 따라지면 된다. 고민할건 별로 없다.

# Create a folder
$ mkdir actions-runner && cd actions-runner
Copied!# Download the latest runner package
$ curl -o actions-runner-linux-x64-2.321.0.tar.gz -L https://github.com/actions/runner/releases/download/v2.321.0/actions-runner-linux-x64-2.321.0.tar.gz
# Optional: Validate the hash
$ echo "ba46ba7ce3a4d7236b16fbe44419fb453bc08f866b24f04d549ec89f1722a29e  actions-runner-linux-x64-2.321.0.tar.gz" | shasum -a 256 -c
# Extract the installer
$ tar xzf ./actions-runner-linux-x64-2.321.0.tar.gz

./config.sh --url https://github.com/..레포지토리 --token 토큰

대화형으로 설정값을 몇개 물어보는데, label만 잘 주면 된다.
내 경우에는 이름은 고유하게 onpremise-crawler-1, 그룹 단위인 label에는 onpremise-crawler로 지었다.
레이블을 기반으로 여러개의 러너를 그룹화해서 관리할 수도 있다.

그리고 실행하면 바로 뜬다.

그러면 github의 러너 페이지에서도 뜨기 시작할 것이다.

이러면 사용할 준비가 완료된 것이다.

Daemon 구성하기 (Linux)

github action runner는 그냥 실행하기에는 충분하지만, 지속적으로 사용할 수 있는 데몬에 대한 구성은 사전 제공하지 않는 것 같다.

머신이 재부팅되어도 알아서 잘 뜨고, 항상 살아있게 만들려면 systemd를 활용하는게 간편하다.
https://blog.naver.com/sssang97/223374364520

설정파일 만들고

sudo vi /etc/systemd/system/action-runner-1.service

[Unit]
Description=Github Action Runner

[Service]
Type=simple
Restart=on-failure
RestartSec=1
User=user
WorkingDirectory=/home/user/actions-runner
ExecStart=/home/user/actions-runner/run.sh

[Install]
WantedBy=network-online.target

적당히 이렇게 넣어준다.
User가 현재 사용중인 유저 정보가 되어야 한다. root는 안된다.

그리고 활성화하면

sudo systemctl enable --now action-runner-1.service
sudo systemctl status action-runner-1.service

잘 살아날 것이다.

워크플로 정의하기

self hosted runner에서 돌게 하려면, 워크플로에 runs-on으로 조건을 적당히 걸면 된다.

레이블 기반으로 명시해서 저 레이블에 속하는 러너만 선택되도록 했다.

그리고 워크플로를 어떤 방식으로든 트리거하면

러너가 받아서 잘 실행할 것이다.
이 워크플로는 중간에 뭐 터져서 실패하긴 했는데, 일단 돌긴 잘 돈 것이다.

그리고 러너가 받아서 실행한 베이스 코드는 앞서 지정했던 action-runner 베이스 경로의 work 경로에 차곡차곡 쌓인다.