대형 러너 개요
GitHub Team 및 GitHub Enterprise Cloud 플랜을 사용하는 고객은 표준 GitHub 호스트형 실행기보다 더 많은 리소스를 제공하는 다양한 관리형 가상 머신 중에서 선택할 수 있습니다. 이러한 컴퓨터를 "더 큰 실행기"라고 합니다. 다음과 같은 고급 기능을 제공합니다.
- 더 많은 RAM, CPU 및 디스크 공간
- 고정 IP 주소
- Azure 개인 네트워킹
- 주자를 그룹화할 수 있는 기능
- 동시 워크플로를 지원하기 위한 자동 크기 조정
- GPU 지원 및 ARM 지원 실행기
이러한 대형 러너는 GitHub에서 호스팅되며 실행기 애플리케이션 및 기타 도구가 미리 설치되어 있습니다.
GitHub은(는) macOS, Ubuntu 또는 Windows 운영 체제에서 대형 러너을(를) 제공하며, 사용하는 운영 체제에 따라 다양한 기능 및 크기로 이용이 가능합니다. 자세한 내용은 "대형 러너을(를) 위한 추가 기능"을 참조하세요.
Ubuntu 및 Windows 정보대형 러너
Ubuntu 또는 Windows 운영 체제를 갖춘 대형 러너은(는) 조직이나 엔터프라이즈에서 구성됩니다. 더 큰 실행기을(를) 추가하는 경우, 사용 가능한 하드웨어 사양 및 운영 체제 이미지 중에서 선택하여 컴퓨터 유형을 정의합니다. GitHub은(는) 정의한 자동 크기 조정 제한에 따라 조직의 작업 요구에 맞게 확장 및 축소되는 이 실행기의 인스턴스를 여러 개 만듭니다. 자세한 내용은 "대형 실행기 관리하기"을(를) 참조하세요.
Ubuntu 및 Windows 대형 러너은(는) 자동 크기 조정 기능 및 특정 범위에서 실행기 고정 IP 주소를 할당하는 기능을 제공합니다. 실행기 그룹을 사용하여 관리할 수도 있습니다. 이를 통해 대형 러너에 대한 액세스를 제어할 수 있습니다. 자세한 내용은 "대형 러너을(를) 위한 추가 기능"을 참조하세요.
macOS 대형 러너 정보
macOS 운영 체제의 대형 러너은(는) YAML 워크플로 레이블을 원하는 실행기 이미지로 업데이트하는 데 사용됩니다. macOS 더 큰 실행기에서 워크플로를 실행하려면 runs-on 키를 업데이트하여 GitHub 정의 macOS GitHub 레이블 중 하나를 사용합니다. 추가 구성은 필요하지 않습니다. 자세한 내용은 "더 큰 실행기에서 작업 실행"을(를) 참조하세요.
다음과 같은 컴퓨터 용량을 macOS 대형 러너에 대해 사용할 수 있습니다.
| 실행기 크기 | 아키텍처 | 프로세서(CPU) | 메모리(RAM) | 스토리지(SSD) | 워크플로 레이블 |
|---|---|---|---|---|---|
| 대형 | Intel | 12 | 30GB | 14 GB | macos-latest-large, macos-12-large, macos-13-large, macos-14-large[최신], macos-15-large[베타] |
| XLarge | arm64(M1) | 6(+ 8 GPU 하드웨어 가속) | 14 GB | 14 GB | macos-latest-xlarge, macos-13-xlarge, macos-14-xlarge[최신], macos-15-xlarge[베타] |
macOS 대형 러너의 제한 사항
- GitHub에서 제공하는 모든 작업은 arm64 GitHub 호스트된 실행기와 호환됩니다. 그러나 커뮤니티 작업은 arm64와 호환되지 않을 수 있으며 런타임에 수동으로 설치해야 합니다.
- Apple의 가상화 프레임워크 제한으로 인해 MPS(Nested-virtualization and Metal Performance Shaders)는 지원되지 않습니다.
- Azure 개인 네트워킹 및 정적 IP 할당과 같은 네트워킹 기능은 현재 macOS 대규모 실행기에서 사용할 수 없습니다.
- arm64 macOS 실행기에는 Apple이 이 기능을 지원하지 않기 때문에 할당된 정적 UUID/UDID가 없습니다. 그러나 Intel MacOS 실행기에서는 정적 UDID, 특히
4203018E-580F-C1B5-9525-B745CECA79EB가 할당됩니다. 빌드를 테스트하려는 동일한 호스트에서 빌드 및 서명하는 경우 개발 프로비저닝 프로필로 서명할 수 있습니다. 정적 UDID가 필요한 경우 Intel 실행기를 사용하고 해당 UDID를 Apple 개발자 계정에 추가할 수 있습니다.
더 큰 실행기을(를) 위한 추가 기능
표준 GitHub 호스트 실행기와 비교하여 대형 러너에는 추가 기능이 있으며, 그 가용성은 더 큰 실행기의 운영 체제에 따라 달라집니다.
| Ubuntu | Windows | macOS | |
|---|---|---|---|
| 고정 IP 주소 | |||
| Azure 개인 네트워킹 | |||
| 자동 확장 | |||
| 실행기 그룹 |
이러한 기능은 다음과 같은 방법으로 CI/CD 파이프라인을 향상시킬 수 있습니다.
- 대형 러너에 특정 범위의 고정 IP 주소를 할당하면 방화벽 허용 목록 구성에 이 범위를 사용할 수 있습니다. 자세한 내용은 "대형 러너을(를) 위한 네트워킹"을 참조하세요.
- 자동 크기 조정은 대형 러너을(를) 사용자 설정 최대 한도까지 자동으로 확장 가능케 하기 때문에, 사용자는 워크플로를 동시에 실행할 수 있습니다. 자세한 내용은 "대형 러너 자동 크기 조정"을 참조하세요.
- 실행기 그룹을 사용하면 조직, 리포지토리 및 워크플로를 위한 대형 러너 액세스를 제어할 수 있습니다. 자세한 내용은 "더 큰 실행기 액세스 제어"을(를) 참조하세요.
실행기 이미지
대형 러너은(는) VM(가상 머신)에서 실행되고 GitHub는 VM 생성 프로세스 중에 이 컴퓨터에 VHD(가상 하드 디스크)를 설치합니다. 다른 VM 이미지 중에서 선택하여 실행기에서 설치할 수 있습니다.
GitHub 소유 이미지: 이러한 이미지는 GitHub에서 유지 관리하며 Linux x64, Windows x64 및 macOS(x64 및 arm) 실행기에서 사용할 수 있습니다. 이 이미지에 대한 더 자세한 정보와 각 실행기 운영 체제에 대해 포함된 도구의 전체 목록은 GitHub Actions 실행기 이미지 리포지토리를 참조하세요.
파트너 이미지: 파트너 이미지는 GitHub에서 관리하지 않으며 Azure Marketplace에서 가져옵니다. Windows 11 데스크톱 이미지에 대한 자세한 내용은 Microsoft Windows 11 Desktop을 참조하세요. GPU 실행기 호환 이미지에 대한 더 자세한 정보는 NVIDIA GPU 최적화 VMI 및 Data Science Virtual Machine - Windows 2019를 참조하세요. ARM 지원 실행기 이미지에 대한 자세한 내용은 actions/partner-runner-images 리포지토리를 참조하세요. 제3자 이미지에 대한 피드백을 제공하거나 문제를 보고하는 장소이기도 합니다.
청구 이해
참고: 대형 러너은(는) 프라이빗 리포지토리에 포함된 시간(분)을 사용할 수 없습니다. 프라이빗 및 퍼블릭 리포지토리에서 대형 러너을(를) 사용하는 경우, 항상 분당 요금이 청구됩니다.
표준 GitHub호스팅 실행기와 비교하면 대형 러너는 다르게 청구됩니다. 대형 러너은(는) 워크플로가 실행된 시간에 대해서만 분당 요금이 청구됩니다. 워크플로에서 사용되지 않는 더 큰 실행기 만들기와 관련된 비용은 없습니다. 자세한 내용은 "About billing for GitHub Actions"을(를) 참조하세요.
대형 러너을(를) 위한 컴퓨터 용량
대형 러너에 대한 여러 사양 중에서 선택할 수 있습니다.
일반 대형 러너에 대한 사양
참고: arm64 실행기는 현재 베타 버전이며 변경될 수 있습니다.
| CPU | 메모리(RAM) | 스토리지(SSD) | 아키텍처 | OS(운영 체제) |
|---|---|---|---|---|
| 6 | 14 GB | 14 GB | arm64 | macOS |
| 12 | 30GB | 14 GB | X64 | macOS |
| 2 | 8GB | 75GB | X64, ARM64 | Ubuntu |
| 4 | 16GB | 150GB | X64, ARM64 | Ubuntu, Windows |
| 8 | 32GB | 300GB | X64, ARM64 | Ubuntu, Windows |
| 16 | 64GB | 600GB | X64, ARM64 | Ubuntu, Windows |
| 32 | 128GB | 1200GB | X64, ARM64 | Ubuntu, Windows |
| 64 | 208GB | 2040GB | arm64 | Ubuntu, Windows |
| 64 | 256GB | 2040GB | X64 | Ubuntu, Windows |
Note
4-vCPU Windows 실행기는 Windows 11 데스크톱 이미지에서만 작동합니다.
GPU 대형 러너에 대한 사양
| CPU | GPU | GPU 카드 | 메모리(RAM) | GPU 메모리(VRAM) | 스토리지(SSD) | OS(운영 체제) |
|---|---|---|---|---|---|---|
| 4 | 1 | Tesla T4 | 28GB | 16GB | 176GB | Ubuntu, Windows |
실행기 그룹 정보
참고: Linux 또는 Windows 운영 체제를 사용하는 대형 러너만 실행기 그룹에 할당할 수 있습니다.
실행기 그룹은 조직 및 엔터프라이즈 수준에서 실행기 액세스를 제어하는 데 사용됩니다. 실행기 그룹을 사용해 실행기 집합을 수집하고 주위에 보안 경계를 만들 수 있습니다. 그런 다음 해당 컴퓨터 집합에서 작업을 실행할 수 있는 조직 또는 리포지토리를 결정할 수 있습니다. 더 큰 실행기 배포 프로세스 중에 실행기를 기존 그룹에 추가하거나 기본 그룹에 합류시킬 수 있습니다. "더 큰 실행기 액세스 제어"의 단계에 따라 그룹을 만들 수 있습니다.
대형 러너의 아키텍처 개요
참고: 이 아키텍처 다이어그램은 Linux 또는 Windows 운영 체제의 대형 러너에만 적용됩니다.
대형 러너은(는) 조직 수준에서 관리되며, 실행기의 인스턴스를 여러 개 포함할 수 있는 그룹으로 정렬됩니다. 또한 엔터프라이즈 수준에서 만들고 계층 구조의 조직과 공유할 수도 있습니다. 그룹을 만든 후 그룹에 실행기를 추가하고 워크플로를 업데이트하여 더 큰 실행기에 할당된 그룹 이름 또는 레이블을 대상으로 지정할 수 있습니다. 처리를 위해 그룹에 작업을 보낼 수 있는 리포지토리를 제어할 수도 있습니다. 그룹에 대한 자세한 내용은 "더 큰 실행기 액세스 제어"을(를) 참조하세요.
다음 다이어그램에서는 사용자 지정된 하드웨어 및 운영 체제 구성을 사용하여 ubuntu-20.04-16core라는 호스트된 실행기 클래스를 정의했습니다.
- 이 실행기의 인스턴스는 자동으로 만들어지고 라는
grp-ubuntu-20.04-16core그룹에 추가됩니다. - 실행기에
ubuntu-20.04-16core레이블이 할당되었습니다. - 워크플로 작업은
runs-on키의ubuntu-20.04-16core레이블을 사용하여 작업을 실행하는 데 필요한 실행기 유형을 나타냅니다. - GitHub Actions는 실행기 그룹을 확인하여 리포지토리가 실행기에게 작업을 보낼 권한이 있는지 확인합니다.
- 이 작업은
ubuntu-20.04-16core실행기의 다음 사용 가능한 인스턴스에서 실행됩니다.
대형 러너 자동 크기 조정
참고: 자동 크기 조정은 Linux 또는 Windows 운영 체제의 대형 러너에만 사용할 수 있습니다.
대형 러너은(는) 필요에 따라 크기를 자동 조정할 수 있습니다. 처리를 위해 작업이 제출될 때 지정된 최대 작업 수를 실행하도록 컴퓨터를 프로비전할 수 있습니다. 각 컴퓨터는 한 번에 하나의 작업만 처리하므로 이러한 설정은 동시에 실행할 수 있는 작업 수를 효과적으로 결정합니다.
이 집합을 사용하여 실행할 수 있는 최대 병렬 작업 수를 설정함으로써 비용을 제어할 수 있는 최대 작업 동시성을 구성할 수 있습니다. 여기서 값이 높을수록 병렬 처리로 인해 워크플로가 차단되지 않게 방지할 수 있습니다. 한도 설정 방법에 대한 자세한 내용은 "대형 실행기 관리하기"을(를) 참조하세요. GitHub 호스트형 실행기에서 최대 자동 크기 조정 한도에 대한 자세한 내용은 "사용 제한, 청구, 관리"을(를) 참조하세요.
대형 러너용 네트워킹
참고:
- 실행기에 고정 IP 주소를 할당하는 것은 Linux 또는 Windows 운영 체제의 대형 러너에만 사용할 수 있습니다.
- GitHub-호스트형 실행기용 개인 네트워킹은 대형 실행기에 고정 IP 주소를 지원하지 않습니다. GitHub-호스트형 실행기의 개인 네트워킹에 대한 자세한 내용은 "엔터프라이즈의 GitHub 호스트형 실행기에 대한 Azure 개인 네트워킹 정보"을(를) 참조하세요.
기본적으로 대형 러너는 각 작업 실행에 대해 변경되는 동적 IP 주소를 받습니다. 필요에 따라 GitHub Enterprise Cloud 고객은 대형 러너을(를) 구성하여 GitHub의 IP 주소 풀에서 고정 IP 주소를 받을 수 있습니다. 자세한 내용은 "GitHub IP 주소 정보"을(를) 참조하세요.
활성화된 더 큰 실행기 인스턴스는 실행기 고유의 범위에서 주소를 수신하므로 이 범위를 사용하여 방화벽 허용 목록을 구성할 수 있습니다. 에서 고정 IP 주소 범위를 가진 최대 10개의 대형 러너을(를) 사용할 수 있습니다. 엔터프라이즈 수준에서 만들어진 대형 러너에서 고정 IP 주소 범위 가진 최대 10개의 대형 러너을(를) 사용할 수 있습니다. 또한 엔터프라이즈의 각 조직에 대해 조직 수준에서 만든 대형 러너에서 고정 IP 주소 범위를 가진 최대 10개의 대형 러너을(를) 사용할 수 있습니다. 자세한 내용은 "대형 실행기 관리하기"을(를) 참조하세요.
고정 IP 주소 범위에서 10개 이상의 실행기를 사용하려면 GitHub 지원 포털 사용에 문의하세요.
참고: 실행기를 30일 넘게 사용하지 않으면 해당 IP 주소 범위가 자동으로 제거되고 복구할 수 없습니다.