Skip to main content

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

레이블을 사용하여 셀프 호스팅 러너를 특성에 따라 구성할 수 있습니다.

데이터 재사용 가능.작업.엔터프라이즈-깃허브-호스티드-러너 %}

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

루너 관리 권한 필요{(data 재사용 가능).actions.self-hosted-runner 관리 권한 필요}%

사용자 지정 레이블 만들기

리포지토리 및 조직 수준에서 러너에 대한 사용자 지정 레이블을 생성할 수 있습니다.

  •         [리포지토리 러너를 위한 사용자 지정 레이블 만들기](#creating-a-custom-label-for-a-repository-runner)
    
  •         [조직 실행기에 대한 맞춤형 레이블 만들기](#creating-a-custom-label-for-an-organization-runner)
    

참고

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

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

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

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

(Assuming placeholders are correct and no extra translation is intended directly in this format, maintain the placeholders as given)

ko-KR: 1. 자체 호스트 실행기 그룹을 등록한 조직의 기본 페이지로 이동합니다.

  1. Settings를 클릭합니다.
  2. 왼쪽 사이드바에서 Actions를 클릭한 다음, Runners를 클릭합니다.
  3. 실행기 목록에서 구성할 실행기 이름을 클릭합니다.
  4. "레이블" 섹션에서 을 클릭합니다.
  5. "레이블 찾기 또는 만들기" 필드에 새 레이블의 이름을 입력하고 새 레이블 만들기를 클릭합니다. 사용자 지정 레이블이 생성되어 자체 호스트형 실행기에 할당됩니다. 자체 호스트형 실행기에서 사용자 지정 레이블을 제거할 수 있지만 현재 수동으로 삭제할 수는 없습니다. 실행기에 할당되지 않은 사용되지 않는 레이블은 24시간 이내에 자동으로 삭제됩니다.

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

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

  •         [리포지토리 러너에 레이블 할당하기](#assigning-a-label-to-a-repository-runner)
    
  •         [조직 실행기에 레이블 할당](#assigning-a-label-to-an-organization-runner)
    

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

  1. 자체 호스트 실행기 그룹이 등록된 리포지토리의 기본 페이지로 이동합니다.
  2. Settings를 클릭합니다.
  3. 왼쪽 사이드바에서 Actions를 클릭한 다음, Runners를 클릭합니다.
  4. "레이블" 섹션에서 을 클릭합니다.
  5. 자체 호스트형 실행기에 레이블을 할당하려면 "레이블 찾기 또는 만들기" 필드에서 레이블을 클릭합니다.

조직 실행기에 레이블 할당

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

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

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

  •         [리포지토리 러너에서 사용자 지정 레이블 제거하기](#removing-a-custom-label-from-a-repository-runner)
    
  •         [조직 러너에서 사용자 지정 레이블 제거](#removing-a-custom-label-from-an-organization-runner)
    

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

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

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

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

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

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

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

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

    참고

            `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
    

    참고

    기존 실행기를 대체하는 경우, 맞춤형 지정 레이블을 재할당해야 합니다.