잡 라우터

잡 라우터 (Job router)

이 기능의 사용 가능 여부는 기능 플래그(feature flag)로 제어돼요. 자세한 내용은 히스토리를 참고하세요. 이 기능은 테스트용으로 제공되며 프로덕션 사용에는 아직 준비되지 않았어요.

잡 라우터는 GitLab CI/CD에 고급 잡 오케스트레이션 기능을 제공하는 GitLab Relay(KAS)의 구성요소예요. 러너가 GitLab을 직접 폴링해서 잡을 가져오는 대신, 러너는 잡 라우터에 연결하고, 잡 라우터가 잡 분배를 관리하며 허용 제어 같은 기능을 제공해요.

출처: 문서

본문

아키텍처

GitLab Instance → Job Router (KAS) → Runner
                        ↓
              Runner Controller (optional)

잡 라우터는:

  • 러너로부터 잡 요청을 받아요
  • 실행할 잡을 러너에게 응답해요
  • 선택적으로 허용 결정을 위해 러너 컨트롤러를 참조해요

전제 조건

잡 라우터를 사용하려면 다음이 필요해요:

  • 다음 기능 플래그를 true로 설정한 GitLab 인스턴스:job_router: 그룹·프로젝트 러너용 · job_router_instance_runners: 인스턴스 러너용 · job_router_admission_control: 허용 제어용 (선택 사항)
  • FF_USE_JOB_ROUTER 환경 변수를 true로 설정한 GitLab Runner 18.9 이상.

잡 라우터 정보 발견하기

러너는 잡 라우터 발견 API를 사용해 잡 라우터 URL을 알아낼 수 있어요.

러너 컨트롤러

러너 컨트롤러는 잡 라우터를 통해 라우팅되는 잡에 대한 허용 제어를 활성화해요. 자세한 내용은 러너 컨트롤러를 참고하세요.

관련 주제

더 알아보기

다음으로는 러너 컨트롤러 문서를 읽고, 잡 라우터 발견 API로 러너가 라우터 정보를 어떻게 찾는지 익힌 뒤, 러너 허용 컨트롤러 튜토리얼을 따라가며 직접 구현해보세요.