자체 호스트형 실행기로 레이블 사용

레이블을 사용하여 특성에 따라 자체 호스트형 실행기를 구성할 수 있습니다.

사용자 고유의 실행기 호스트

학습 경로의 8 중 5
다음:워크플로에서 자체 호스트형 실행기 사용

이 문서의 내용

레이블을 사용하여 특정 유형의 자체 호스팅 러너에게 작업을 라우팅하는 방법에 대한 자세한 내용은 "워크플로에서 자체 호스트형 실행기 사용"을 참조하세요. 특정 그룹의 러너에게 작업을 라우팅할 수도 있습니다. 자세한 내용은 "작업에 대한 실행기 선택"을(를) 참조하세요.

자체 호스트형 실행기는 리포지토리, 조직 또는 GitHub의 엔터프라이즈 계정 설정에서 찾을 수 있습니다. 자체 호스트 실행기를 관리하려면 자체 호스트 실행기를 추가한 위치에 따라 다음 권한이 있어야 합니다.

  • 사용자 리포지토리: 리포지토리 소유자여야 합니다.

  • 조직: 조직 소유자여야 합니다.

  • 조직 리포지토리: 조직 소유자거나 리포지토리에 대한 관리자 액세스 권한이 있어야 합니다.

  • 엔터프라이즈 계정: 엔터프라이즈 소유자여야 합니다.

Note

작업 실행기 컨트롤러는 다중 레이블을 지원하지 않으므로 자세한 내용은 작업 실행기 컨트롤러 설명서를 참조하세요.

사용자 지정 레이블 만들기

리포지토리, 조직, 엔터프라이즈 수준에서 실행기에 대한 사용자 지정 레이블을 생성할 수 있습니다.

참고: 레이블은 대/소문자를 구분하지 않습니다.

리포지토리 러너를 위한 사용자 지정 레이블 만들기

  1. 자체 호스팅 실행기 그룹이 등록된 리포지토리의 기본 페이지로 이동합니다.
  2. 설정을 클릭합니다.
  3. 왼쪽 사이드바에서 작업을 클릭한 다음 실행기를** 클릭합니다**.
  4. 실행기 목록에서 구성할 실행기 이름을 클릭합니다.
  5. “레이블” 섹션에서 을 클릭합니다.
  6. “레이블 찾기 또는 만들기” 필드에 새 레이블의 이름을 입력하고 새 레이블 만들기를 클릭합니다. 사용자 지정 레이블이 생성되어 자체 호스팅 실행기에 할당됩니다. 자체 호스팅 실행기에서 사용자 지정 레이블을 제거할 수 있지만 현재 수동으로 삭제할 수는 없습니다. 실행기에 할당되지 않은 사용되지 않는 레이블은 24시간 이내에 자동으로 삭제됩니다.

조직 주자를 위한 사용자 지정 레이블 만들기

  1. 자체 호스트 실행기 그룹을 등록한 조직의 기본 페이지로 이동합니다.
  2. 설정을 클릭합니다.
  3. 왼쪽 사이드바에서 작업을 클릭한 다음 실행기를** 클릭합니다**.
  4. 실행기 목록에서 구성할 실행기 이름을 클릭합니다.
  5. “레이블” 섹션에서 을 클릭합니다.
  6. “레이블 찾기 또는 만들기” 필드에 새 레이블의 이름을 입력하고 새 레이블 만들기를 클릭합니다. 사용자 지정 레이블이 생성되어 자체 호스팅 실행기에 할당됩니다. 자체 호스팅 실행기에서 사용자 지정 레이블을 제거할 수 있지만 현재 수동으로 삭제할 수는 없습니다. 실행기에 할당되지 않은 사용되지 않는 레이블은 24시간 이내에 자동으로 삭제됩니다.

엔터프라이즈 러너를 위한 사용자 지정 레이블 만들기

  1. GitHub.com의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 Your enterprises(내 엔터프라이즈)를 클릭합니다.

  2. 엔터프라이즈 목록에서 보려는 엔터프라이즈를 클릭합니다.

  3. 엔터프라이즈 계정 사이드바에서 정책을 클릭합니다.

  4. " 정책"에서 작업을 클릭합니다.

  5. 실행기 탭을 클릭합니다.

  6. 실행기 목록에서 구성할 실행기 이름을 클릭합니다.

  7. “레이블” 섹션에서 을 클릭합니다.

  8. “레이블 찾기 또는 만들기” 필드에 새 레이블의 이름을 입력하고 새 레이블 만들기를 클릭합니다. 사용자 지정 레이블이 생성되어 자체 호스팅 실행기에 할당됩니다. 자체 호스팅 실행기에서 사용자 지정 레이블을 제거할 수 있지만 현재 수동으로 삭제할 수는 없습니다. 실행기에 할당되지 않은 사용되지 않는 레이블은 24시간 이내에 자동으로 삭제됩니다.

자체 호스트형 실행기에 레이블 할당

리포지토리, 조직 및 엔터프라이즈 수준에서 자체 호스트형 실행기에 레이블을 할당할 수 있습니다.

리포지토리 러너에 레이블 할당하기

  1. 자체 호스팅 실행기 그룹이 등록된 리포지토리의 기본 페이지로 이동합니다.
  2. 설정을 클릭합니다.
  3. 왼쪽 사이드바에서 작업을 클릭한 다음 실행기를** 클릭합니다**.
  4. “레이블” 섹션에서 을 클릭합니다.
  5. 자체 호스팅 실행기에 레이블을 할당하려면 “레이블 찾기 또는 만들기” 필드에서 레이블을 클릭합니다.

조직 러너에게 레이블 할당하기

  1. 자체 호스트 실행기 그룹을 등록한 조직의 기본 페이지로 이동합니다.
  2. 설정을 클릭합니다.
  3. 왼쪽 사이드바에서 작업을 클릭한 다음 실행기를** 클릭합니다**.
  4. “레이블” 섹션에서 을 클릭합니다.
  5. 자체 호스팅 실행기에 레이블을 할당하려면 “레이블 찾기 또는 만들기” 필드에서 레이블을 클릭합니다.

엔터프라이즈 러너에게 레이블 할당하기

  1. GitHub.com의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 Your enterprises(내 엔터프라이즈)를 클릭합니다.

  2. 엔터프라이즈 목록에서 보려는 엔터프라이즈를 클릭합니다.

  3. 엔터프라이즈 계정 사이드바에서 정책을 클릭합니다.

  4. " 정책"에서 작업을 클릭합니다.

  5. 실행기 탭을 클릭합니다.

  6. 실행기 목록에서 구성할 실행기 이름을 클릭합니다.

  7. “레이블” 섹션에서 을 클릭합니다.

  8. 자체 호스팅 실행기에 레이블을 할당하려면 “레이블 찾기 또는 만들기” 필드에서 레이블을 클릭합니다.

자체 호스트형 실행기에서 사용자 지정 레이블 제거

리포지토리, 조직 및 엔터프라이즈 수준에서 자체 호스트형 실행기로부터 사용자 지정 레이블을 제거할 수 있습니다.

리포지토리 러너에서 사용자 지정 레이블 제거하기

  1. 자체 호스팅 실행기 그룹이 등록된 리포지토리의 기본 페이지로 이동합니다.
  2. 설정을 클릭합니다.
  3. 왼쪽 사이드바에서 작업을 클릭한 다음 실행기를** 클릭합니다**.
  4. “레이블” 섹션에서 을 클릭합니다.
  5. “레이블 찾기 또는 만들기” 필드에서 할당된 레이블은 아이콘으로 표시됩니다. 표시된 레이블을 클릭하여 자체 호스팅 실행기에서 할당을 취소합니다.

조직 러너에서 사용자 지정 레이블 제거하기

  1. 자체 호스트 실행기 그룹을 등록한 조직의 기본 페이지로 이동합니다.
  2. 설정을 클릭합니다.
  3. 왼쪽 사이드바에서 작업을 클릭한 다음 실행기를** 클릭합니다**.
  4. “레이블” 섹션에서 을 클릭합니다.
  5. “레이블 찾기 또는 만들기” 필드에서 할당된 레이블은 아이콘으로 표시됩니다. 표시된 레이블을 클릭하여 자체 호스팅 실행기에서 할당을 취소합니다.

엔터프라이즈 러너에서 사용자 지정 레이블 제거하기

  1. GitHub.com의 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 Your enterprises(내 엔터프라이즈)를 클릭합니다.

  2. 엔터프라이즈 목록에서 보려는 엔터프라이즈를 클릭합니다.

  3. 엔터프라이즈 계정 사이드바에서 정책을 클릭합니다.

  4. " 정책"에서 작업을 클릭합니다.

  5. 실행기 탭을 클릭합니다.

  6. 실행기 목록에서 구성할 실행기 이름을 클릭합니다.

  7. “레이블” 섹션에서 을 클릭합니다.

  8. “레이블 찾기 또는 만들기” 필드에서 할당된 레이블은 아이콘으로 표시됩니다. 표시된 레이블을 클릭하여 자체 호스팅 실행기에서 할당을 취소합니다.

프로그래밍 방식으로 라벨 할당

자체 호스팅 러너를 생성한 후 또는 초기 구성 중에 프로그래밍 방식으로 레이블을 할당할 수 있습니다.

  • 프로그래밍 방식으로 기존 자체 호스팅 러너에 레이블을 할당하려면 REST API를 사용해야 합니다. 자세한 내용은 "자체 호스트형 실행기에 대한 REST API 엔드포인트"을(를) 참조하세요.

  • 초기 러너 구성 중에 자체 호스팅 러너에 레이블을 프로그래밍 방식으로 할당하려면 labels 매개 변수를 사용하여 config 스크립트에 레이블 이름을 전달할 수 있습니다.

    참고: config 스크립트를 사용하여 기존 자체 호스팅 러너에 레이블을 할당할 수는 없습니다.

    예를 들어, 이 명령은 새 자체 호스팅 러너를 구성할 때 gpu이라는 레이블을 할당합니다:

    ./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu

    레이블이 아직 없는 경우 생성됩니다. 이 방법을 사용하여 실행기에 기본 레이블(예: x64 또는 linux)을 할당할 수도 있습니다. 구성 스크립트를 사용하여 기본 레이블이 할당된 경우 GitHub Actions은(는) 기본 레이블을 지정된 대로 수락하며 실행기에서 실제로 해당 운영 체제 또는 아키텍처를 사용하고 있는지 확인하지 않습니다.

    쉼표 구분을 사용하여 여러 레이블을 할당할 수 있습니다. 예:

    ./config.sh --url <REPOSITORY_URL> --token <REGISTRATION_TOKEN> --labels gpu,x64,linux

    참고: 기존 러너를 교체하는 경우 모든 사용자 지정 레이블을 다시 할당해야 합니다.

이전자체 호스트형 실행기를 사용하는 프록시 서버 사용다음워크플로에서 자체 호스트형 실행기 사용