Skip to main content
설명서에 자주 업데이트를 게시하며 이 페이지의 번역이 계속 진행 중일 수 있습니다. 최신 정보는 영어 설명서를 참조하세요.
GitHub AE는 현재 제한된 릴리스에 있습니다.

워크플로에서 자체 호스팅 실행기 사용

워크플로에서 자체 호스팅 실행기를 사용하려면 레이블을(를) 사용하여 작업에 대한 실행기를 지정할 수 있습니다.

실행기의 조합을 기반으로 워크플로에서 사용할 자체 호스팅 실행기를 대상으로 지정할 수 있습니다.

자체 호스팅 실행기 레이블 정보

레이블을 사용하면 공유 특성에 따라 특정 유형의 자체 호스팅 실행기에 워크플로 작업을 보낼 수 있습니다. 예를 들어 작업에 특정 하드웨어 구성 요소 또는 소프트웨어 패키지가 필요한 경우 실행기에 사용자 지정 레이블을 할당한 다음, 해당 레이블이 있는 실행기에서만 실행되도록 작업을 구성할 수 있습니다.

작업에 대한 자체 호스팅 실행기를 지정하려면 자체 호스팅 실행기 레이블을 사용하여 워크플로 파일에서 runs-on을 구성합니다.

모든 자체 호스팅 실행기에는 self-hosted 레이블이 있습니다. 이 레이블만 사용하면 자체 호스팅 실행기가 선택됩니다. 운영 체제 또는 아키텍처와 같은 특정 조건을 충족하는 실행기를 선택하려면 self-hosted(먼저 나열되어야 함)로 시작하고 필요에 따라 추가 레이블을 포함하는 레이블 배열을 제공하는 것이 좋습니다. 레이블 배열을 지정하면 지정한 모든 레이블이 있는 실행기에서 작업이 큐에 대기됩니다.

self-hosted 레이블이 필요하지는 않지만 자체 호스팅 실행기를 사용할 때 이 레이블을 지정하여 작업이 의도치 않게 현재 또는 미래의 GitHub 호스팅 실행기를 지정하지 않도록 하는 것이 좋습니다.

사용자 지정 레이블과 기본 레이블을 만드는 방법에 대한 자세한 내용은 “자체 호스팅 실행기에서 레이블 사용”을 참조하세요.

기본 레이블을 사용하여 작업 라우팅

자체 호스팅 실행기는 GitHub Actions에 추가된 특정 레이블을 자동으로 받습니다. 이 레이블은 운영 체제와 하드웨어 플랫폼을 나타내는 데 사용됩니다.

  • self-hosted: 모든 자체 호스팅 실행기에 적용되는 기본 레이블입니다.
  • linux, windows 또는 macOS: 운영 체제에 따라 적용됩니다.
  • x64, ARM 또는 ARM64: 하드웨어 아키텍처에 따라 적용됩니다.

워크플로의 YAML을 사용하여 이 레이블의 조합에 작업을 보낼 수 있습니다. 이 예제에서는 다음 3개 레이블과 모두 일치하는 자체 호스팅 실행기에서 작업을 실행할 수 있습니다.

runs-on: [self-hosted, linux, ARM64]
  • self-hosted - 자체 호스팅 실행기에서 이 작업을 실행합니다.
  • linux - Linux 기반 실행기만 사용합니다.
  • ARM64 - ARM64 하드웨어 기반의 실행기만 사용합니다.

기본 레이블은 고정되어 있으며 변경하거나 제거할 수 없습니다. 작업 라우팅을 더 자세히 제어해야 하는 경우 사용자 지정 레이블을 사용하는 것이 좋습니다.

사용자 지정 레이블을 사용하여 작업 라우팅

언제든지 사용자 지정 레이블을 만들어 자체 호스팅 실행기에 할당할 수 있습니다. 사용자 지정 레이블을 사용하면 레이블 지정 방법에 따라 특정 유형의 자체 호스팅 실행기에 작업을 보낼 수 있습니다.

예를 들어 특정 유형의 그래픽 하드웨어가 필요한 작업이 있는 경우 gpu라는 사용자 지정 레이블을 생성하여 하드웨어가 설치된 실행기에 할당할 수 있습니다. 그런 다음, 할당된 모든 레이블과 일치하는 자체 호스팅 실행기에서 작업을 실행할 수 있습니다.

다음 예제에서는 기본 레이블과 사용자 지정 레이블을 결합하는 작업을 보여 줍니다.

runs-on: [self-hosted, linux, x64, gpu]
  • self-hosted - 자체 호스팅 실행기에서 이 작업을 실행합니다.
  • linux - Linux 기반 실행기만 사용합니다.
  • x64 - x64 하드웨어 기반의 실행기만 사용합니다.
  • gpu - 이 사용자 지정 레이블은 GPU 하드웨어가 설치된 자체 호스팅 실행기에 수동으로 할당되었습니다.

이러한 레이블은 누적해서 작동하므로 4개의 레이블이 모두 있어야 자체 호스팅 실행기에서 작업을 처리할 수 있습니다.

자체 호스팅 실행기의 라우팅 우선 순위

작업을 자체 호스팅 실행기로 라우팅할 때 GitHub는 작업의 runs-on 레이블과 일치하는 실행기를 찾습니다.

  • GitHub에서 작업의 runs-on 레이블과 일치하는 온라인 및 유휴 실행기를 찾으면 작업이 할당되어 실행기로 전송됩니다.
    • 해당 실행기가 할당된 작업을 60초 이내에 선택하지 않으면 새 실행기가 수락할 수 있도록 작업이 다시 큐에 대기됩니다.
  • GitHub이(가) 작업의 runs-on 레이블 과 일치하는 온라인 및 유휴 실행기를 찾지 못하면 실행기가 온라인 상태가 될 때까지 작업이 큐에 대기 상태로 유지됩니다.
  • 24시간 넘게 큐에서 대기한 작업은 실패합니다.