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-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 개발자 계정에 추가할 수 있습니다.
  • macOS 실행기는 GHE.com의 하위 도메인에서 사용할 수 없습니다(예: octocorp.ghe.com).

더 큰 실행기을(를) 위한 추가 기능

표준 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자 이미지에 대한 피드백을 제공하거나 문제를 보고하는 장소이기도 합니다.

청구 이해

Note

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

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

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

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

일반 대형 러너에 대한 사양

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

실행기 그룹 정보

Note

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

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

대형 러너의 아키텍처 개요

Note

이 아키텍처 다이어그램은 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 실행기의 다음 사용 가능한 인스턴스에서 실행됩니다.

대형 러너 자동 크기 조정

Note

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

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

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

정적 IP 주소를 대형 러너에 할당하고 있습니다.

Linux 또는 윈도우즈 운영 체제를 사용하는 대형 러너에만 정적 IP 주소를 할당할 수 있습니다.

할당된 고정 IP 주소는 모두 사용할 수 있으며 CIDR 표기법을 사용하지 않습니다.

GitHub-호스트형 실행기용 개인 네트워킹은 대형 실행기에 고정 IP 주소를 지원하지 않습니다. GitHub-호스트형 실행기의 개인 네트워킹에 대한 자세한 내용은 "엔터프라이즈의 GitHub 호스트형 실행기에 대한 Azure 개인 네트워킹 정보"을(를) 참조하세요.

대형 러너용 네트워킹

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

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

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

Note

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