더 큰 러너(Larger runners) 참조

더 큰 러너(Larger runners) 참조

더 큰 러너의 사양과 사용자 지정 옵션에 대한 정보를 알려드릴게요. 표준 러너보다 더 많은 CPU와 메모리·GPU가 필요할 때 살펴보면 돼요.

출처: 문서

본문

더 큰 러너의 사양과 사용자 지정 옵션을 포함한 정보를 확인할 수 있습니다.

더 큰 러너의 머신 크기

더 큰 러너에는 여러 사양 중에서 선택할 수 있습니다.

일반 더 큰 러너의 사양

CPU Memory (RAM) Storage (SSD) Architecture Operating system (OS)
5 14 GB 14 GB arm64 (M2) macOS
12 30 GB 14 GB x64 (Intel) macOS
2 8 GB 75 GB x64, arm64 Ubuntu
4 16 GB 150 GB x64, arm64 Ubuntu, Windows
8 32 GB 300 GB x64, arm64 Ubuntu, Windows
16 64 GB 600 GB x64, arm64 Ubuntu, Windows
32 128 GB 1200 GB x64, arm64 Ubuntu, Windows
64 208 GB 2040 GB arm64 Ubuntu, Windows
64 256 GB 2040 GB x64 Ubuntu, Windows
96 384 GB 2040 GB x64 Ubuntu, Windows

[!NOTE] 4-vCPU Windows 러너는 Windows Server 2025 또는 Base Windows 11 Desktop 이미지에서만 작동합니다.

GPU 더 큰 러너의 사양

CPU GPU GPU card Memory (RAM) GPU memory (VRAM) Storage (SSD) Operating system (OS)
4 1 Tesla T4 28 GB 16 GB 176 GB Ubuntu, Windows

러너 이미지

더 큰 러너는 가상 머신(VM)에서 실행되며, GitHub는 VM 생성 과정에서 이 머신에 가상 하드 디스크(VHD)를 설치합니다. 러너에 설치할 다양한 VM 이미지 중에서 선택할 수 있습니다.

GitHub 소유 이미지: 이 이미지는 GitHub가 유지 관리하며 Linux(x64 및 arm64), Windows(x64 및 arm64), macOS(x64 및 arm64) 러너에 사용할 수 있습니다. 이 이미지와 각 러너 운영 체제에 포함된 전체 도구 목록에 대한 자세한 내용은 GitHub Actions Runner Images 저장소를 참고하세요.

파트너 이미지: 파트너 이미지는 GitHub가 관리하지 않으며 Azure Marketplace에서 가져옵니다. 파트너 이미지에 대한 자세한 정보와 문제 보고 위치는 아래를 참고하세요.

사용 가능한 macOS 더 큰 러너와 라벨

macOS 더 큰 러너에 다음 머신을 사용할 수 있습니다. macOS 더 큰 러너를 만들면 러너 이름이 runs-on과 함께 사용할 수 있는 워크플로 라벨로도 사용할 수 있습니다.

Runner Size Architecture Processor (CPU) Memory (RAM) Storage (SSD) Workflow label
Large Intel 12 30 GB 14 GB macos-latest-large, macos-14-large, macos-15-large (최신), macos-26-large
XLarge arm64 (M2) 5 (+ 8 GPU hardware acceleration) 14 GB 14 GB macos-latest-xlarge, macos-14-xlarge, macos-15-xlarge (최신), macos-26-xlarge, xcode-27-xlarge (공개 미리보기)

macOS 더 큰 러너의 제한 사항

  • GitHub가 제공하는 모든 액션은 arm64 GitHub 호스팅 러너와 호환됩니다. 그러나 커뮤니티 액션은 arm64와 호환되지 않을 수 있으며 런타임 시 수동으로 설치해야 합니다.
  • Apple의 Virtualization Framework의 제한으로 인해 중첩 가상화는 지원되지 않습니다.
  • Azure 비공개 네트워킹과 정적 IP 할당 같은 네트워킹 기능은 현재 macOS 더 큰 러너에서 사용할 수 없습니다.
  • arm64 macOS 러너에는 정적 UUID/UDID가 할당되지 않습니다. Apple이 이 기능을 지원하지 않기 때문입니다. 그러나 Intel macOS 러너에는 정적 UDID, 구체적으로 4203018E-580F-C1B5-9525-B745CECA79EB가 할당됩니다. 빌드와 서명을 같은 호스트에서 수행하고 그 빌드를 테스트할 계획이라면 개발 프로비저닝 프로파일로 서명할 수 있습니다. 정적 UDID가 필요하다면 Intel 러너를 사용하고 UDID를 Apple Developer 계정에 추가하면 됩니다.

더 큰 러너 문제 해결

더 큰 러너를 대상으로 하는 잡이 지연되거나 실행되지 않는 것을 발견하면 다음과 같은 여러 요인이 원인일 수 있습니다.

  • 동시성 설정: 최대 동시성 한도에 도달했을 수 있습니다. 더 많은 잡을 병렬로 실행하려면 자동 확장(autoscaling) 설정을 더 큰 숫자로 업데이트할 수 있습니다. Managing larger runners를 참고하세요.
  • 저장소 권한: 더 큰 러너에 적절한 저장소 권한이 활성화되어 있는지 확인하세요. 기본적으로 엔터프라이즈 러너는 저장소 레벨에서 사용할 수 없으며 조직 관리자가 수동으로 활성화해야 합니다. Managing larger runners를 참고하세요.
  • 결제 정보: 더 큰 러너를 사용하려면 유효한 신용카드가 등록되어 있어야 합니다. 계정에 신용카드를 추가하면 더 큰 러너 사용이 활성화되기까지 최대 10분이 걸릴 수 있습니다. Managing your payment and billing information을 참고하세요.
  • 지출 한도: GitHub Actions 지출 한도가 0보다 큰 값으로 설정되어야 합니다. Setting up budgets to control spending on metered products를 참고하세요.
  • 공정 사용 정책: GitHub에는 실행 중인 잡 수나 GitHub Actions 전체에서 실행 중인 잡 수 같은 여러 요인을 기준으로 잡을 제한(throttle)하기 시작하는 공정 사용 정책이 있습니다.
  • 잡 할당 대기열 시간: 잡 할당 대기열 시간은 잡 요청과 GitHub가 잡을 실행할 VM을 할당하는 사이의 시간을 말합니다. ubuntu-latest 같은 지정된 YAML 워크플로 라벨을 사용하는 표준 GitHub 호스팅 러너는 항상 "warm" 상태입니다. 더 큰 러너의 경우 이 머신들의 풀이 더 작기 때문에 warm VM이 첫 요청에서 잡을 바로 받지 못할 수 있습니다. 결과적으로 GitHub가 새 VM을 만들어야 할 수 있으며, 이로 인해 할당 대기열 시간이 늘어납니다. 일단 러너가 사용되면 VM은 5분 이내에 이후의 워크플로 실행에 사용할 준비가 됩니다. 그 시간 안에 다시 사용되지 않으면 해당 머신 중 일부가 warm 상태로 유지되어 이후 24시간 동안의 워크플로 실행에 대한 할당 대기열 시간을 줄여줍니다. 실행하는 잡의 양이 많을수록 warm 풀에 더 많은 VM이 유지됩니다.

더 큰 러너의 네트워킹

기본적으로 더 큰 러너는 각 잡 실행마다 변경되는 동적 IP 주소를 받습니다. 선택적으로 GitHub Enterprise Cloud 고객은 GitHub의 IP 주소 풀에서 정적 IP 주소를 받도록 더 큰 러너를 구성할 수 있습니다. 자세한 내용은 About GitHub's IP addresses를 참고하세요.

활성화되면 더 큰 러너의 인스턴스는 러너에 고유한 특정 범위에서 IP 주소를 받으므로, 이 범위를 사용해서 방화벽 허용 목록을 구성할 수 있습니다. 각 더 큰 러너는 구성된 최대 동시성까지 자동으로 확장되는 풀이며, 해당 풀의 모든 잡은 같은 정적 IP 주소 범위를 공유합니다. 즉 더 많은 동시 잡을 실행하기 위해 추가 러너를 만들 필요가 없습니다. 전체 더 큰 러너에서 정적 IP 주소 범위를 가진 더 큰 러너 풀을 최대 10개까지 사용할 수 있습니다. 자세한 내용은 Managing larger runners를 참고하세요.

정적 IP 주소 범위를 가진 더 큰 러너 풀을 10개보다 많이 사용하려면 GitHub Support 포털을 통해 문의하세요.

[!NOTE] 러너가 90일 이상 사용되지 않으면 해당 러너의 IP 주소 범위가 자동으로 제거되며 복구할 수 없습니다.

더 큰 러너의 통신 요구 사항

더 큰 러너는 필수 통신 작업을 수행하려면 GitHub 소유 엔드포인트에 연결을 설정해야 합니다. 또한 러너는 액션 내에서 지정하거나 사용하는 추가 네트워크에 접근해야 할 수도 있습니다.

구성 내 네트워크 간에 더 큰 러너의 적절한 통신을 보장하려면 다음 통신을 허용해야 합니다.

[!NOTE] 나열된 도메인 중 일부는 CNAME 레코드로 구성됩니다. 일부 방화벽은 모든 CNAME 레코드에 대해 재귀적으로 규칙을 추가해야 할 수 있습니다. CNAME 레코드는 나중에 변경될 수 있으며 나열된 도메인만 일정하게 유지된다는 점에 유의하세요.

필수 작업에 필요:

github.com
api.github.com
*.actions.githubusercontent.com

액션 다운로드에 필요:

codeload.github.com

잡 요약, 로그, 워크플로 아티팩트, 캐시 업로드/다운로드에 필요:

results-receiver.actions.githubusercontent.com
*.blob.core.windows.net

러너 버전 업데이트에 필요:

objects.githubusercontent.com
objects-origin.githubusercontent.com
github-releases.githubusercontent.com
github-registry-files.githubusercontent.com

OIDC 토큰 가져오기에 필요:

*.actions.githubusercontent.com

GitHub Packages에 패키지나 컨테이너를 다운로드하거나 게시하는 데 필요:

*.pkg.github.com
pkg-containers.githubusercontent.com
ghcr.io

Git Large File Storage에 필요

github-cloud.githubusercontent.com
github-cloud.s3.amazonaws.com

Dependabot 업데이트 잡에 필요

dependabot-actions.githubapp.com

릴리스 자산 다운로드에 필요:

release-assets.githubusercontent.com

VNet에 필요:

api.snapcraft.io
*.core.windows.net

더 알아보기 (Learn more)