Skip to main content

대규모 실행기 정보

GitHub에서는 더 많은 사용자 지정 사용 사례를 지원하기 위해 고급 기능을 갖춘 실행기를 제공합니다.

누가 이 기능을 사용할 수 있나요?

대형 러너은(는) GitHub Team 플랜 또는 GitHub Enterprise Cloud 플랜을 사용하는 조직 및 기업만 사용할 수 있습니다.

대형 러너 개요

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)워크플로 레이블
대형Intel1230GB14 GBmacos-latest-large, macos-12-large, macos-13-large, macos-14-large[최신], macos-15-large[베타]
XLargearm64(M1)6(+ 8 GPU 하드웨어 가속)14 GB14 GBmacos-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 호스트 실행기와 비교하여 대형 러너에는 추가 기능이 있으며, 그 가용성은 더 큰 실행기의 운영 체제에 따라 달라집니다.

UbuntuWindowsmacOS
고정 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 최적화 VMIData Science Virtual Machine - Windows 2019를 참조하세요. ARM 지원 실행기 이미지에 대한 자세한 내용은 actions/partner-runner-images 리포지토리를 참조하세요. 제3자 이미지에 대한 피드백을 제공하거나 문제를 보고하는 장소이기도 합니다.

청구 이해

참고: 대형 러너은(는) 프라이빗 리포지토리에 포함된 시간(분)을 사용할 수 없습니다. 프라이빗 및 퍼블릭 리포지토리에서 대형 러너을(를) 사용하는 경우, 항상 분당 요금이 청구됩니다.

표준 GitHub호스팅 실행기와 비교하면 대형 러너는 다르게 청구됩니다. 대형 러너은(는) 워크플로가 실행된 시간에 대해서만 분당 요금이 청구됩니다. 워크플로에서 사용되지 않는 더 큰 실행기 만들기와 관련된 비용은 없습니다. 자세한 내용은 "About billing for GitHub Actions"을(를) 참조하세요.

대형 러너을(를) 위한 컴퓨터 용량

대형 러너에 대한 여러 사양 중에서 선택할 수 있습니다.

일반 대형 러너에 대한 사양

참고: arm64 실행기는 현재 베타 버전이며 변경될 수 있습니다.

CPU메모리(RAM)스토리지(SSD)아키텍처OS(운영 체제)
614 GB14 GBarm64macOS
1230GB14 GBX64macOS
28GB75GBX64, ARM64Ubuntu
416GB150GBX64, ARM64Ubuntu, Windows
832GB300GBX64, ARM64Ubuntu, Windows
1664GB600GBX64, ARM64Ubuntu, Windows
32128GB1200GBX64, ARM64Ubuntu, Windows
64208GB2040GBarm64Ubuntu, Windows
64256GB2040GBX64Ubuntu, Windows

Note

4-vCPU Windows 실행기는 Windows 11 데스크톱 이미지에서만 작동합니다.

GPU 대형 러너에 대한 사양

CPUGPUGPU 카드메모리(RAM)GPU 메모리(VRAM)스토리지(SSD)OS(운영 체제)
41Tesla T428GB16GB176GBUbuntu, Windows

실행기 그룹 정보

참고: Linux 또는 Windows 운영 체제를 사용하는 대형 러너만 실행기 그룹에 할당할 수 있습니다.

실행기 그룹은 조직 및 엔터프라이즈 수준에서 실행기 액세스를 제어하는 데 사용됩니다. 실행기 그룹을 사용해 실행기 집합을 수집하고 주위에 보안 경계를 만들 수 있습니다. 그런 다음 해당 컴퓨터 집합에서 작업을 실행할 수 있는 조직 또는 리포지토리를 결정할 수 있습니다. 더 큰 실행기 배포 프로세스 중에 실행기를 기존 그룹에 추가하거나 기본 그룹에 합류시킬 수 있습니다. "더 큰 실행기 액세스 제어"의 단계에 따라 그룹을 만들 수 있습니다.

대형 러너의 아키텍처 개요

참고: 이 아키텍처 다이어그램은 Linux 또는 Windows 운영 체제의 대형 러너에만 적용됩니다.

대형 러너은(는) 조직 수준에서 관리되며, 실행기의 인스턴스를 여러 개 포함할 수 있는 그룹으로 정렬됩니다. 또한 엔터프라이즈 수준에서 만들고 계층 구조의 조직과 공유할 수도 있습니다. 그룹을 만든 후 그룹에 실행기를 추가하고 워크플로를 업데이트하여 더 큰 실행기에 할당된 그룹 이름 또는 레이블을 대상으로 지정할 수 있습니다. 처리를 위해 그룹에 작업을 보낼 수 있는 리포지토리를 제어할 수도 있습니다. 그룹에 대한 자세한 내용은 "더 큰 실행기 액세스 제어"을(를) 참조하세요.

다음 다이어그램에서는 사용자 지정된 하드웨어 및 운영 체제 구성을 사용하여 ubuntu-20.04-16core라는 호스트된 실행기 클래스를 정의했습니다.

실행기 레이블 때문에 워크플로에서 사용되는 대규모 실행기를 보여 주는 다이어그램입니다.

  1. 이 실행기의 인스턴스는 자동으로 만들어지고 라는 grp-ubuntu-20.04-16core 그룹에 추가됩니다.
  2. 실행기에 ubuntu-20.04-16core 레이블이 할당되었습니다.
  3. 워크플로 작업은 runs-on 키의 ubuntu-20.04-16core 레이블을 사용하여 작업을 실행하는 데 필요한 실행기 유형을 나타냅니다.
  4. GitHub Actions는 실행기 그룹을 확인하여 리포지토리가 실행기에게 작업을 보낼 권한이 있는지 확인합니다.
  5. 이 작업은 ubuntu-20.04-16core 실행기의 다음 사용 가능한 인스턴스에서 실행됩니다.

대형 러너 자동 크기 조정

참고: 자동 크기 조정은 Linux 또는 Windows 운영 체제의 대형 러너에만 사용할 수 있습니다.

대형 러너은(는) 필요에 따라 크기를 자동 조정할 수 있습니다. 처리를 위해 작업이 제출될 때 지정된 최대 작업 수를 실행하도록 컴퓨터를 프로비전할 수 있습니다. 각 컴퓨터는 한 번에 하나의 작업만 처리하므로 이러한 설정은 동시에 실행할 수 있는 작업 수를 효과적으로 결정합니다.

이 집합을 사용하여 실행할 수 있는 최대 병렬 작업 수를 설정함으로써 비용을 제어할 수 있는 최대 작업 동시성을 구성할 수 있습니다. 여기서 값이 높을수록 병렬 처리로 인해 워크플로가 차단되지 않게 방지할 수 있습니다. 한도 설정 방법에 대한 자세한 내용은 "대형 실행기 관리하기"을(를) 참조하세요. GitHub 호스트형 실행기에서 최대 자동 크기 조정 한도에 대한 자세한 내용은 "사용 제한, 청구, 관리"을(를) 참조하세요.

대형 러너용 네트워킹

참고:

기본적으로 대형 러너는 각 작업 실행에 대해 변경되는 동적 IP 주소를 받습니다. 필요에 따라 GitHub Enterprise Cloud 고객은 대형 러너을(를) 구성하여 GitHub의 IP 주소 풀에서 고정 IP 주소를 받을 수 있습니다. 자세한 내용은 "GitHub IP 주소 정보"을(를) 참조하세요.

활성화된 더 큰 실행기 인스턴스는 실행기 고유의 범위에서 주소를 수신하므로 이 범위를 사용하여 방화벽 허용 목록을 구성할 수 있습니다. 에서 고정 IP 주소 범위를 가진 최대 10개의 대형 러너을(를) 사용할 수 있습니다. 엔터프라이즈 수준에서 만들어진 대형 러너에서 고정 IP 주소 범위 가진 최대 10개의 대형 러너을(를) 사용할 수 있습니다. 또한 엔터프라이즈의 각 조직에 대해 조직 수준에서 만든 대형 러너에서 고정 IP 주소 범위를 가진 최대 10개의 대형 러너을(를) 사용할 수 있습니다. 자세한 내용은 "대형 실행기 관리하기"을(를) 참조하세요.

고정 IP 주소 범위에서 10개 이상의 실행기를 사용하려면 GitHub 지원 포털 사용에 문의하세요.

참고: 실행기를 30일 넘게 사용하지 않으면 해당 IP 주소 범위가 자동으로 제거되고 복구할 수 없습니다.