Runner label 과 라우팅

~9 min · labels, routing, matchmaking

Level 0Apprentice

0 XP0/101 lessons0/10 achievements

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

GitHub 가 runner 고르는 방법

Job 이 runs-on: [self-hosted, gpu, linux] 선언하면 GitHub 가 셋 모두 label 가진 runner 찾음. 여러 runner 가 자격이면 첫 idle 이 이김. 없으면 가능해질 때까지 큐.

일상 필요할 label

신뢰 계층 — trusted (own-org 코드만) vs untrusted (public PR).
리소스 shape — gpu, gpu-h100, large-mem, fast-disk.
위치 — region-us, region-kr, internal-network.
능력 versioning — cuda12, node22. Runner image 업그레이드 시 label 바꿔서 전환 중 옛 workflow 가 옛 runner 타겟 유지.

그룹 라우팅

Label 너머, runner 는 org level runner group 가능. 그룹이 어느 workflow / repo 가 그 runner 쓸 수 있는지 제한. 한 runner 풀이 다른 신뢰 수준 multiple repo 서빙할 때 그룹 사용.

Code

가장 강한 runner 매칭 패턴·yaml

  fast-test:
    # Prefer a fast runner if available; fall back to any
    runs-on: [self-hosted, fast-disk, linux]
    steps:
      - run: pytest

  any-runner:
    runs-on: [self-hosted, linux]
    steps:
      - run: pytest

External links

Exercise

Runner fleet 의 label 을 README 에 문서화. 각 runner 별 label, 어떤 종류 job 받을지, 누가 유지하는지 나열. 빠지거나 오래된 label 업데이트.

Progress

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

← PreviousRunner 설정 Next →Self-hosted runner 보안

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

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

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

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