자체 호스팅 러너와 함께 레이블 사용하기

자체 호스팅 러너와 함께 레이블 사용하기

레이블을 사용해 특성에 따라 자체 호스팅 러너를 구성할 수 있어요. 레이블과 설치 시 구성할 수 있는 여러 기본 레이블이 있으며, 커스텀 레이블을 만들어 러너를 더 쉽게 찾고 작업을 라우팅할 수 있어요.

출처: 문서

본문

레이블을 사용해 작업을 특정 유형의 자체 호스팅 러너로 라우팅하는 방법은 워크플로에서 자체 호스팅 러너 사용하기를 참고하세요. 또한 특정 그룹의 러너로 작업을 라우팅할 수도 있어요. 자세한 내용은 작업의 러너 선택하기를 참고하세요.

자체 호스팅 러너는 GitHub 설정의 저장소, 조직, 또는 엔터프라이즈 계정 어디에나 위치할 수 있어요. 자체 호스팅 러너를 관리하려면 러너가 추가된 위치에 따라 다음 권한이 있어야 해요:

  • 사용자 저장소: 저장소 소유자여야 해요.
  • 조직: 조직 소유자여야 해요.
  • 조직 저장소: 조직 소유자이거나 저장소에 대한 admin 접근 권한이 있어야 해요.

커스텀 레이블 만들기

저장소 및 조직 수준에서 러너용 커스텀 레이블을 만들 수 있어요.

Note

레이블은 대소문자를 구분하지 않아요.

저장소 러너용 커스텀 레이블 만들기

  1. 자체 호스팅 러너 그룹이 등록된 저장소의 메인 페이지로 이동해요.
  2. 설정 아이콘(기어)을 클릭해요.
  3. 왼쪽 사이드바에서 Actions을 클릭한 다음 Runners을 클릭해요.
  4. 러너 목록에서 구성할 러너의 이름을 클릭해요.
  5. "Labels" 섹션에서 설정 아이콘(기어)을 클릭해요.
  6. "Find or create a label" 필드에 새 레이블의 이름을 입력하고 Create new label을 클릭해요. 커스텀 레이블이 만들어져 자체 호스팅 러너에 할당돼요. 커스텀 레이블은 자체 호스팅 러너에서 제거할 수 있지만, 현재 수동으로 삭제할 수는 없어요. 러너에 할당되지 않은 사용하지 않는 레이블은 24시간 내에 자동으로 삭제돼요.

조직 러너용 커스텀 레이블 만들기

  1. 자체 호스팅 러너 그룹이 등록된 조직의 메인 페이지로 이동해요.
  2. 설정 아이콘(기어)을 클릭해요.
  3. 왼쪽 사이드바에서 Actions을 클릭한 다음 Runners을 클릭해요.
  4. 러너 목록에서 구성할 러너의 이름을 클릭해요.
  5. "Labels" 섹션에서 설정 아이콘(기어)을 클릭해요.
  6. "Find or create a label" 필드에 새 레이블의 이름을 입력하고 Create new label을 클릭해요. 커스텀 레이블이 만들어져 자체 호스팅 러너에 할당돼요. 커스텀 레이블은 자체 호스팅 러너에서 제거할 수 있지만, 현재 수동으로 삭제할 수는 없어요. 러너에 할당되지 않은 사용하지 않는 레이블은 24시간 내에 자동으로 삭제돼요.

자체 호스팅 러너에 레이블 할당하기

저장소 및 조직 수준에서 자체 호스팅 러너에 레이블을 할당할 수 있어요.

저장소 러너에 레이블 할당하기

  1. 자체 호스팅 러너 그룹이 등록된 저장소의 메인 페이지로 이동해요.
  2. 설정 아이콘(기어)을 클릭해요.
  3. 왼쪽 사이드바에서 Actions을 클릭한 다음 Runners을 클릭해요.
  4. "Labels" 섹션에서 설정 아이콘(기어)을 클릭해요.
  5. 자체 호스팅 러너에 레이블을 할당하려면 "Find or create a label" 필드에서 클릭해요.

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

  1. 자체 호스팅 러너 그룹이 등록된 조직의 메인 페이지로 이동해요.
  2. 설정 아이콘(기어)을 클릭해요.
  3. 왼쪽 사이드바에서 Actions을 클릭한 다음 Runners을 클릭해요.
  4. "Labels" 섹션에서 설정 아이콘(기어)을 클릭해요.
  5. 자체 호스팅 러너에 레이블을 할당하려면 "Find or create a label" 필드에서 클릭해요.

자체 호스팅 러너에서 커스텀 레이블 제거하기

저장소 및 조직 수준에서 자체 호스팅 러너의 커스텀 레이블을 제거할 수 있어요.

저장소 러너에서 커스텀 레이블 제거하기

  1. 자체 호스팅 러너 그룹이 등록된 저장소의 메인 페이지로 이동해요.
  2. 설정 아이콘(기어)을 클릭해요.
  3. 왼쪽 사이드바에서 Actions을 클릭한 다음 Runners을 클릭해요.
  4. "Labels" 섹션에서 설정 아이콘(기어)을 클릭해요.
  5. "Find or create a label" 필드에서 할당된 레이블은 체크 표시 아이콘으로 표시돼요. 표시된 레이블을 클릭해 자체 호스팅 러너에서 할당을 해제해요.

조직 러너에서 커스텀 레이블 제거하기

  1. 자체 호스팅 러너 그룹이 등록된 조직의 메인 페이지로 이동해요.
  2. 설정 아이콘(기어)을 클릭해요.
  3. 왼쪽 사이드바에서 Actions을 클릭한 다음 Runners을 클릭해요.
  4. "Labels" 섹션에서 설정 아이콘(기어)을 클릭해요.
  5. "Find or create a label" 필드에서 할당된 레이블은 체크 표시 아이콘으로 표시돼요. 표시된 레이블을 클릭해 자체 호스팅 러너에서 할당을 해제해요.

프로그래밍 방식으로 레이블 할당하기

러너가 생성된 후 또는 초기 구성 중에 자체 호스팅 러너에 프로그래밍 방식으로 레이블을 할당할 수 있어요.

  • 기존 자체 호스팅 러너에 프로그래밍 방식으로 레이블을 할당하려면 REST API를 사용해야 해요. 자세한 내용은 자체 호스팅 러너를 위한 REST API 엔드포인트를 참고하세요.

  • 초기 러너 구성 중에 자체 호스팅 러너에 프로그래밍 방식으로 레이블을 할당하려면 labels 파라미터를 사용해 config 스크립트에 레이블 이름을 전달할 수 있어요.

    Note

    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

    Note

    기존 러너를 교체한다면 커스텀 레이블을 다시 할당해야 해요.