그룹을 사용해 자체 호스팅 러너 접근 관리하기

정책을 사용해 조직에 추가된 자체 호스팅 러너에 대한 접근을 제한할 수 있어요. 러너 그룹은 어떤 저장소가 자체 호스팅 러너에서 작업을 실행할 수 있는지 제어해요.

출처: 문서

본문

조직용 자체 호스팅 러너 그룹 만들기

Warning

자체 호스팅 러너는 비공개 저장소에만 사용할 것을 권장해요. 공개 저장소의 포크는 워크플로에서 코드를 실행하는 풀 리퀘스트를 만들어 자체 호스팅 러너 머신에서 위험한 코드를 잠재적으로 실행할 수 있기 때문이에요.

자세한 내용은 안전한 사용 참조를 참고하세요.

Note

러너 그룹을 만들 때는 어떤 저장소가 러너 그룹에 접근할지 정의하는 정책을 선택해야 해요. 어떤 저장소와 워크플로가 러너 그룹에 접근할 수 있는지 변경하려면 조직 소유자가 조직에 대한 정책을 설정할 수 있어요. 자세한 내용은 그룹을 사용해 자체 호스팅 러너 접근 관리하기를 참고하세요.

모든 조직에는 단일 기본 러너 그룹이 있어요. GitHub Team 플랜을 사용하는 조직 소유자는 추가 조직 수준 러너 그룹을 만들 수 있어요.

등록 과정에서 그룹을 지정하지 않으면 러너가 자동으로 기본 그룹에 추가돼요. 나중에 러너를 기본 그룹에서 커스텀 그룹으로 이동할 수 있어요.

REST API로 러너 그룹을 만드는 방법은 GitHub Actions를 위한 REST API 엔드포인트를 참고하세요.

GitHub에서 조직의 메인 페이지로 이동해요.
조직 이름 아래에서 Settings 탭을 클릭해요.
왼쪽 사이드바에서 Actions을 클릭한 다음 Runner groups을 클릭해요.
"Runner groups" 섹션에서 New runner group을 클릭해요.
러너 그룹의 이름을 입력해요.
저장소 접근에 대한 정책을 할당해요.

러너 그룹을 특정 저장소 목록에 접근 가능하도록 구성하거나, 조직의 모든 저장소에 접근 가능하도록 구성할 수 있어요. 기본적으로 비공개 저장소만 러너 그룹의 러너에 접근할 수 있지만, 이를 재정의할 수 있어요. 엔터프라이즈가 공유한 조직의 러너 그룹을 구성하는 경우 이 설정은 재정의할 수 없어요.
Create group을 클릭해 그룹을 만들고 정책을 적용해요.

러너 그룹에 접근할 수 있는 저장소 변경하기

Warning

자체 호스팅 러너는 비공개 저장소에만 사용할 것을 권장해요. 공개 저장소의 포크는 워크플로에서 코드를 실행하는 풀 리퀘스트를 만들어 자체 호스팅 러너 머신에서 위험한 코드를 잠재적으로 실행할 수 있기 때문이에요.

자세한 내용은 안전한 사용 참조를 참고하세요.

조직의 러너 그룹에 대해, 조직 내 어떤 저장소가 러너 그룹에 접근할 수 있는지 변경할 수 있어요.

러너 그룹이 있는 조직의 메인 페이지로 이동해요.
조직 이름 아래에서 Settings 탭을 클릭해요.
왼쪽 사이드바에서 Actions을 클릭한 다음 Runner groups을 클릭해요.
그룹 목록에서 구성할 러너 그룹을 클릭해요.
"Repository access" 아래에서 드롭다운 메뉴를 사용해 Selected repositories을 클릭해요.
1. 드롭다운 메뉴 오른쪽에서 설정 아이콘(기어)을 클릭해요.
2. 팝업에서 이 러너 그룹에 접근할 수 있는 저장소를 선택하려면 체크박스를 사용해요.
Save group을 클릭해요.

러너 그룹 이름 변경하기

러너 그룹이 있는 조직의 메인 페이지로 이동해요.
조직 이름 아래에서 Settings 탭을 클릭해요.
왼쪽 사이드바에서 Actions을 클릭한 다음 Runner groups을 클릭해요.
그룹 목록에서 구성할 러너 그룹을 클릭해요.
"Group name" 아래의 텍스트 필드에 새 러너 그룹 이름을 입력해요.
Save을 클릭해요.

자체 호스팅 러너를 그룹에 자동으로 추가하기

구성 스크립트를 사용해 새 러너를 그룹에 자동으로 추가할 수 있어요. 예를 들어 이 명령은 새 러너를 등록하고 --runnergroup 파라미터를 사용해 rg-runnergroup이라는 그룹에 추가해요.

./config.sh --url $org_or_enterprise_url --token $token --runnergroup rg-runnergroup

러너 그룹이 존재하지 않으면 명령이 실패해요:

Could not find any self-hosted runner group named "rg-runnergroup".

자체 호스팅 러너를 그룹으로 이동하기

등록 과정에서 러너 그룹을 지정하지 않으면 새 러너가 자동으로 기본 그룹에 할당되며, 이후 다른 그룹으로 이동할 수 있어요.

GitHub에서 조직의 메인 페이지로 이동해요.
조직 이름 아래에서 Settings 탭을 클릭해요.
왼쪽 사이드바에서 Actions을 클릭한 다음 Runners을 클릭해요.
"Runners" 목록에서 구성할 러너를 클릭해요.
Runner group 드롭다운을 선택해요.
"Move runner to group"에서 러너의 대상 그룹을 선택해요.

자체 호스팅 러너 그룹 제거하기

러너 그룹을 제거하려면 먼저 그 그룹의 모든 러너를 이동하거나 제거해야 해요.

러너 그룹이 있는 조직의 메인 페이지로 이동해요.
조직 이름 아래에서 Settings 탭을 클릭해요.
왼쪽 사이드바에서 Actions을 클릭한 다음 Runner groups을 클릭해요.
그룹 목록에서 삭제할 그룹 오른쪽의 케밥(세로 점 3개) 아이콘을 클릭해요.
그룹을 제거하려면 Remove group을 클릭해요.
확인 프롬프트를 검토하고 Remove this runner group을 클릭해요.