참고:
- 이 문서의 정보 및 지침은 Linux 및 Windows 운영 체제의 더 큰 실행기에만 적용됩니다.
- ARM 지원 실행기는 현재 베타 버전이며 변경될 수 있습니다.
조직에 더 큰 실행기 추가
조직 소유자는 조직에 더 큰 실행기를 추가하여 이를 사용할 수 있는 리포지토리를 제어할 수 있습니다. 조직을 위한 새 실행기를 만들 때 기본적으로 조직의 모든 리포지토리는 실행기 액세스 권한이 있습니다. 실행기를 사용할 수 있는 리포지토리를 제한하려면 특정 리포지토리에 대한 액세스 권한이 있는 실행기 그룹에 할당합니다. 자세한 내용은 "리포지토리에서 대형 러너에 액세스하도록 허용"을 참조하세요.
사용 가능한 옵션 목록에서 운영 체제 및 하드웨어 구성을 선택할 수 있습니다. 이 실행기의 새 인스턴스가 자동 크기 조정을 통해 배포되면 여기서 정의한 것과 동일한 운영 체제 및 하드웨어 구성을 사용합니다.
새 실행기는 기본 그룹에 자동으로 할당되거나 실행기 생성 프로세스 중에 실행기를 조인해야 하는 그룹을 선택할 수 있습니다. 또한 실행기를 등록한 후 실행기 그룹 멤버 자격을 수정할 수 있습니다. 자세한 내용은 "더 큰 실행기 액세스 제어"을(를) 참조하세요.
-
GitHub.com에서 조직의 기본 페이지로 이동합니다.
-
조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.
-
왼쪽 사이드바에서 작업을 클릭한 다음 길행기를 클릭합니다.
-
새 실행기를 클릭한 다음 새 GitHub 호스트형 실행기를 클릭합니다.
-
새 실행기를 구성하는 데 필요한 세부 정보를 완료합니다.
- 이름새 실행기의 이름을 입력합니다. 보다 쉽게 식별하려면 하드웨어 및 운영 구성(예:
ubuntu-20.04-16core
)을 나타내야 합니다. - 플랫폼: 사용 가능한 옵션에서 플랫폼을 선택합니다. 플랫폼을 선택하면 특정 이미지를 선택할 수 있습니다.
- 이미지: 사용 가능한 옵션에서 이미지를 선택합니다. 이미지를 선택하면 특정 크기를 선택할 수 있습니다.
- GitHub 소유: GitHub에서 관리하는 이미지의 경우 이 탭에서 이미지를 선택합니다.
- 파트너: 파트너가 관리하는 이미지의 경우 이 탭에서 이미지를 선택합니다. Windows 11 바탕 화면 및 GPU 최적화 이미지는 이 탭 아래에 있습니다.
- 크기: 사용 가능한 옵션의 목록에서 하드웨어 구성을 선택합니다. 사용 가능한 크기는 이전 단계에서 선택한 이미지에 따라 달라집니다. GPU 실행기에서 GPU 기반 탭에서 크기를 선택합니다.
- 최대 동시 실행: 언제든지 활성화할 수 있는 최대 작업 수를 선택합니다.
- 실행기 그룹: 실행기가 속할 그룹을 선택합니다. 이 그룹은 수요에 맞게 확장 및 축소되므로 실행기의 여러 인스턴스를 호스트합니다.
참고: 대형 러너의 이름은 해당 기능을 지정할 수 있습니다. 예를 들어 더 큰 실행기을(를) code scanning 기본 설정에 사용하려면 실행기 이름을
code-scanning
로 지정해야 합니다. code scanning 및 대형 러너에 대한 자세한 내용은 "기본 설정에 대해 대형 러너 구성하기"을 참조하세요. - 이름새 실행기의 이름을 입력합니다. 보다 쉽게 식별하려면 하드웨어 및 운영 구성(예:
-
실행기 만들기를 클릭합니다.
-
리포지토리가 더 큰 실행기에 액세스할 수 있도록 하게 사용할 수 있는 리포지토리 목록에 추가합니다. 자세한 내용은 “리포지토리에서 더 큰 실행기에 액세스하도록 허용”을 참조하세요.
리포지토리에서 더 큰 실행기에 액세스하도록 허용
리포지토리에는 실행기 그룹을 통해 더 큰 실행기에 대한 액세스 권한이 부여됩니다. 엔터프라이즈 관리자는 엔터프라이즈 수준 실행기 그룹에 대한 액세스 권한이 부여된 조직을 선택할 수 있으며 조직 소유자는 모든 더 큰 실행기에 대한 리포지토리 수준 액세스를 제어할 수 있습니다.
조직 소유자는 조직의 리포지토리에 대해 엔터프라이즈 수준 실행기 그룹을 사용하고 구성하거나 액세스를 제어하는 조직 수준 실행기 그룹을 만들 수 있습니다.
- 엔터프라이즈 수준의 실행기 그룹: 기본적으로 조직의 리포지토리는 엔터프라이즈 수준 실행기 그룹에 액세스할 수 없습니다. 엔터프라이즈 실행기 그룹에 대한 리포지토리 액세스 권한을 부여하려면 조직 소유자가 각 엔터프라이즈 실행기 그룹을 구성하고 액세스 권한이 있는 리포지토리를 선택해야 합니다.
- 조직 수준의 실행기 그룹: 기본적으로 조직의 모든 리포지토리에는 조직 수준 실행기 그룹에 대한 액세스 권한이 부여됩니다. 액세스 권한이 있는 리포지토리를 제한하려면 조직 소유자는 조직 실행기 그룹을 구성하고 액세스 권한을 가질 리포지토리를 선택해야 합니다.
리포지토리에서 더 큰 실행기에 액세스할 수 있으면 더 큰 실행기을(를) 워크플로 파일에 추가할 수 있습니다. 자세한 내용은 "더 큰 실행기에서 작업 실행"을(를) 참조하세요.
- 실행기 그룹이 있는 조직의 기본 페이지로 이동합니다.
- 설정을 클릭합니다.
- 왼쪽 사이드바에서 작업을 클릭한 다음 실행기 그룹을 클릭합니다.
- 페이지의 목록 중 하나에서 실행기 그룹을 선택합니다. 조직 수준 실행기 그룹은 페이지 맨 위에 나열되고 엔터프라이즈 수준 실행기 그룹은 "엔터프라이즈에서 공유"에 나열됩니다.
- 실행기 그룹 페이지의 "리포지토리 액세스"에서 모든 리포지토리 또는 선택한 리포지토리를 선택합니다. 특정 리포지토리에 대한 액세스 권한을 부여하도록 선택한 경우 을(를) 클릭한 다음 목록에서 액세스 권한을 부여할 리포지토리를 선택합니다.
경고:
고정된 IP 범위를 사용 중이라면, 개인 리포지토리에는 더 큰 실행기만 사용하는 것이 좋습니다. 리포지토리의 포크가 워크플로에서 코드를 실행하는 끌어오기 요청을 만들어 더 큰 실행기에서 위험한 코드를 실행할 수 있기 때문입니다.
자세한 내용은 "더 큰 실행기 액세스 제어"을(를) 참조하세요.
더 큰 실행기의 이름 변경
참고: 대형 러너의 이름은 해당 기능을 지정할 수 있습니다. 예를 들어 더 큰 실행기을(를) code scanning 기본 설정에 사용하려면 실행기 이름을 code-scanning
로 지정해야 합니다. code scanning 및 대형 러너에 대한 자세한 내용은 "기본 설정에 대해 대형 러너 구성하기"을 참조하세요.
-
GitHub.com에서 조직의 기본 페이지로 이동합니다.
-
조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.
-
왼쪽 사이드바에서 작업을 클릭한 다음 길행기를 클릭합니다.
-
실행기 목록에서 편집할 실행기를 선택합니다.
-
“이름” 텍스트 필드에 실행기의 새 이름을 입력합니다.
-
저장을 클릭합니다.
더 큰 실행기 자동 크기 조정 구성
특정 실행기 집합에 대해 동시에 실행할 수 있는 최대 작업 수를 제어할 수 있습니다. 이 필드를 더 높은 값으로 설정하면 병렬 처리로 인해 워크플로가 차단되는 것을 방지할 수 있습니다.
-
GitHub.com에서 조직의 기본 페이지로 이동합니다.
-
조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.
-
왼쪽 사이드바에서 작업을 클릭한 다음 길행기를 클릭합니다.
-
실행기 목록에서 편집할 실행기를 선택합니다.
-
"자동 크기 조정" 섹션의 "동시 최대 작업"에서 동시에 실행할 수 있는 최대 작업 수를 입력합니다.
-
저장을 클릭합니다.
더 큰 실행기에 대한 고정 IP 주소 만들기
참고: 감사 로그 API를 사용하려면 조직에서 GitHub Enterprise Cloud을(를) 사용해야 합니다. GitHub Enterprise Cloud를 체험해 보는 방법에 대한 자세한 내용은 “GitHub Enterprise Cloud 평가판 설정”을 참조하세요.
더 큰 실행기에 대한 고정 IP 주소를 만들 수 있도록 설정할 수 있습니다. 이렇게 하면 더 큰 실행기에 고정 IP 주소 범위가 할당됩니다. 기본적으로 계정에 대한 IP 범위를 사용하여 최대 10개의 다른 더 큰 실행기을(를) 구성할 수 있습니다. 고정 IP 주소 범위에서 10개 이상의 실행기를 사용하려면 GitHub 지원 포털 사용에 문의하세요.
할당된 범위에서 사용 가능한 IP 주소 수는 자동 크기 조정에 지정된 동시 작업 수를 제한하지 않습니다. 실행기 풀 내에는 할당된 범위에서 IP 주소를 많이 재사용할 수 있는 부하 분산 장치가 있습니다. 이렇게 하면 각 컴퓨터에 고정 IP 주소가 할당되는 동안 워크플로가 대규모로 동시에 실행될 수 있습니다.
-
GitHub.com에서 조직의 기본 페이지로 이동합니다.
-
조직 이름에서 설정을 클릭합니다. "설정" 탭이 표시되지 않으면 드롭다운 메뉴를 선택한 다음 설정을 클릭합니다.
-
왼쪽 사이드바에서 작업을 클릭한 다음 길행기를 클릭합니다.
-
실행기 목록에서 편집할 실행기를 선택합니다.
-
실행기에 고정 IP 주소를 할당하려면 "네트워킹"에서 실행기에 고유 및 고정 공용 IP 주소 범위 할당을 확인합니다.
-
저장을 클릭합니다.