VPS에 자체 호스팅 GitHub Actions 러너 설정하는 방법

자체 호스팅 러너는 따뜻한 캐시가 있는 정액 비용 CI를 제공합니다 — 분당 과금 없음, 당신의 툴체인, 당신의 머신. 이것은 최소 설정 가이드입니다. 자체 호스팅이 GitHub 호스팅 분보다 나은 이유와 Docker 작업 세부 사항은 전체 가이드와 GitHub Actions용 VPS 사용 사례를 보세요.

1. non-root 사용자 만들기 (러너는 root를 거부함)

adduser --disabled-password --gecos "" runner
su - runner

2. 러너 내려받기

GitHub에서: Settings → Actions → Runners → New self-hosted runner → Linux, 정확한 다운로드와 일회용 토큰을 제공합니다. 그런 다음:

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

3. 저장소에 등록하기

./config.sh --url https://github.com/YOUR_ORG/YOUR_REPO --token YOUR_TOKEN

4. 서비스로 설치하기 (재부팅에도 살아남음)

./run.sh를 터미널에서 실행하지 마세요 — 설치하세요:

sudo ./svc.sh install runner
sudo ./svc.sh start
sudo ./svc.sh status

러너는 이제 GitHub UI에서 Idle로 표시되며 자신을 대상으로 하는 작업을 받아갑니다.

5. workflow에서 사용하기

jobs:
  build:
    runs-on: self-hosted
    steps:
      - uses: actions/checkout@v4
      - run: make build && make test

Docker 작업 (선택)

Docker를 한 번 설치하면 workflow가 실행 간에 레이어 캐시가 유지된 채 이미지를 빌드할 수 있습니다:

sudo apt install -y docker.io
sudo usermod -aG docker runner

VPS에 Docker 설치를 보세요. 크기 산정: **Small(월 $8)**은 대부분의 CI에 넉넉합니다. 무거운 컴파일에는 한 단계 올리세요. 약 1분이면 root, KYC 없음, 암호화폐로 결제.