Skip to main content

대규모 실행기 정보

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

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

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

대형 러너 개요

표준 GitHub 호스트형 실행기 외에도 GitHub은(는) GitHub Team 및 GitHub Enterprise Cloud 플랜 고객에게 고급 기능을 갖춘 다양한 관리형 가상 머신을 제공합니다.

  • 더 많은 RAM, CPU 및 디스크 공간
  • 고정 IP 주소
  • 주자를 그룹화할 수 있는 기능
  • 동시 워크플로를 지원하기 위한 자동 크기 조정

이러한 대형 러너는 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)YAML 워크플로 레이블
LargeIntel1230GB14 GBmacos-latest-large, macos-12-large, macos-13-large[최신], macos-14-large[베타]
XLargearm64(M1)6 CPU 및 8 GPU14 GB14 GBmacos-latest-xlarge, macos-13-xlarge[최신], macos-14-xlarge[베타]

macOS 대형 러너의 제한 사항

  • GitHub에서 제공하는 모든 작업은 arm64 GitHub 호스트된 실행기와 호환됩니다. 그러나 커뮤니티 작업은 arm64와 호환되지 않을 수 있으며 런타임에 수동으로 설치해야 합니다. 자세한 내용은 "더 큰 실행기에서 작업 실행"을 참조하세요.
  • 하이퍼바이저에서 사용하는 Apple 가상화 프레임워크의 제한으로 인해, arm64 실행기에서는 중첩 가상화가 지원되지 않습니다.

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

표준 GitHub 호스트 실행기와 비교하여 대형 러너에는 추가 기능이 있으며, 그 가용성은 더 큰 실행기의 운영 체제에 따라 달라집니다.

운영 체제UbuntuWindowsmacOS
고정 IP 주소
자동 확장
실행기 그룹

이러한 기능은 다음과 같은 방법으로 CI/CD 파이프라인을 향상시킬 수 있습니다.

  • 대형 러너에 특정 범위의 고정 IP 주소를 할당하면 방화벽 허용 목록 구성에 이 범위를 사용할 수 있습니다. 자세한 내용은 "대형 러너을(를) 위한 네트워킹"을 참조하세요.
  • 자동 크기 조정은 대형 러너을(를) 사용자 설정 최대 한도까지 자동으로 확장 가능케 하기 때문에, 사용자는 워크플로를 동시에 실행할 수 있습니다. 자세한 내용은 "대형 러너 자동 크기 조정"을 참조하세요.
  • 실행기 그룹을 사용하면 조직, 리포지토리 및 워크플로를 위한 대형 러너 액세스를 제어할 수 있습니다. 자세한 내용은 "더 큰 실행기 액세스 제어"을(를) 참조하세요.

실행기 이미지

실행기 이미지](https://github.com/actions/runner-images) 리포지토리를 참조하세요.

파트너 이미지: 파트너 이미지는 GitHub에서 관리하지 않으며 Azure Marketplace에서 가져옵니다. Windows 11 데스크톱 이미지에 대한 자세한 내용은 Microsoft Windows 11 Desktop을 참조하세요. GPU 실행기 호환 이미지에 대한 더 자세한 정보는 NVIDIA GPU 최적화 VMIData Science Virtual Machine - Windows 2019를 참조하세요.

청구 이해

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

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

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

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

일반 대형 러너에 대한 사양

CPU메모리(RAM)스토리지(SSD)OS(운영 체제)
614 GB14 GBmacOS
1230GB14 GBmacOS
28GB75GBUbuntu
416GB150GBUbuntu, Windows
832GB300GBUbuntu, Windows
1664GB600GBUbuntu, Windows
32128GB1200GBUbuntu, Windows
64256GB2040GBUbuntu, Windows

Note

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

GPU 대형 러너에 대한 사양

참고: 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 주소 범위가 자동으로 제거되고 복구할 수 없습니다.