Runner 설정

~11 min · setup, install, labels

Level 0Apprentice

0 XP0/101 lessons0/10 achievements

0/120 XP to next level120 XP to go0% complete

공식 runner agent

GitHub 가 머신에 설치하는 단일 runner binary (actions/runner) 제공. 일회성 token 으로 GitHub 에 등록, 그 다음 job polling. 단계:

Runner 등록 token 생성 (Repo 또는 Org Settings → Actions → Runners → New self-hosted runner).
OS / arch 용 agent 다운로드.
./config.sh --url ... --token ... --labels gpu,linux-x64,internal
./run.sh (또는 ./svc.sh install 로 service 설치).

Label 이 라우팅 layer

Runner 능력 묘사하는 label 항상 추가:

OS: linux, macos, windows.
Arch: x64, arm64, apple-silicon.
하드웨어: gpu, gpu-h100, large-mem.
네트워크: internal-network, vpn.
신뢰: trusted (아빠 코드만) vs untrusted (PR 빌드).

Workflow 가 label 나열로 opt-in: runs-on: [self-hosted, gpu, linux].

Code

Linux runner 설치 + service·bash

# Create folder
mkdir actions-runner && cd actions-runner

# Download (URL from your repo's Add new self-hosted runner page)
curl -O -L https://github.com/actions/runner/releases/download/v2.320.0/actions-runner-linux-x64-2.320.0.tar.gz
tar xzf actions-runner-linux-x64-2.320.0.tar.gz

# Configure
./config.sh --url https://github.com/my-org/my-repo \
  --token <REGISTRATION_TOKEN> \
  --labels self-hosted,gpu,linux-x64

# Install + start as service
sudo ./svc.sh install
sudo ./svc.sh start
sudo ./svc.sh status

External links

GitHub — Adding self-hosted runners

Exercise

남은 머신 (홈랩, 옛 노트북, ARM test 위한 Raspberry Pi 도 OK) 에 self-hosted runner 한 개 설정. Service 로 설치, 적절히 label, 그걸 타겟하는 작은 workflow 실행.

Progress

Progress is local-only — sign in to sync across devices.

← Previous왜 self-hosted runner Next →Runner label 과 라우팅

이 페이지에서 버그를 발견하셨거나 피드백이 있으세요?문제 신고

🔔 답글 알림 (로그인 필요)

로그인 — 댓글을 남기려면 로그인해 주세요.

아직 댓글이 없어요. 첫 댓글을 남겨보세요.