러너 설정

~11 min · setup, install, labels

Level 0견습생

0 XP0/101 lessons0/10 achievements

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

공식 러너 에이전트

GitHub에서 머신에 설치하는 단일 러너 바이너리(actions/runner)를 제공해. 일회성 토큰으로 GitHub에 등록하고, 그다음에 작업을 폴링하지. 단계는 이거야:

러너 등록 토큰 생성 (저장소 또는 조직 설정 → 액션 → 러너 → 새 셀프 호스티드 러너).
운영체제와 아키텍처에 맞는 에이전트 다운로드.
./config.sh --url ... --token ... --labels gpu,linux-x64,internal
./run.sh (또는 ./svc.sh install로 서비스 설치).

라벨이 라우팅 계층이야

러너의 능력을 묘사하는 라벨은 항상 추가해:

운영체제: linux, macos, windows.
아키텍처: x64, arm64, apple-silicon.
하드웨어: gpu, gpu-h100, large-mem.
네트워크: internal-network, vpn.
신뢰도: trusted (네 코드만) vs untrusted (PR 빌드).

워크플로는 라벨을 나열해서 선택해: runs-on: [self-hosted, gpu, linux].

Code

리눅스 러너 설치 + 서비스·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 — 셀프 호스티드 러너 추가

Exercise

남은 머신(홈랩, 옛 노트북, ARM 테스트용 라즈베리 파이도 좋아)에 셀프 호스티드 러너 하나 설정해 봐. 서비스로 설치하고, 적절히 라벨 붙인 다음, 그 러너를 타겟하는 작은 워크플로를 실행해.

Progress

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

← Previous왜 자체 호스팅 러너를 써야 할까 Next →러너 라벨과 라우팅

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

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

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

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