Azure DevOps Services
GitHub 호스팅 에이전트는 PAYG(종량제) 청구를 통해 Azure Pipelines 위해 고성능 가상 머신을 제공합니다. 동시성 기반 풀을 사용하는 Microsoft 호스팅 에이전트와 달리 GitHub 호스팅 에이전트는 분당 사용량을 청구하고 보다 강력한 컴퓨터 구성을 제공합니다. 요금은 사용된 에이전트의 운영 체제 및 차원에 따라 달라집니다.
Important
이 기능은 배포 중이며 아직 모든 지역에서 사용할 수 없습니다. 해당 지역에 배포되었는지 확인하려면 Azure DevOps 청구 페이지에서 GitHub 호스팅 에이전트 설정을 확인합니다.
이 기능은 현재 미리 보기로 제공됩니다. 일반 공급 전에 변경될 수 있습니다.
사전 요구 사항
GitHub 호스트된 에이전트를 사용하도록 설정하려면 다음 필수 구성 요소가 있어야 합니다.
| Category | 요구 사항 |
|---|---|
| Permissions | Azure DevOps 조직에서 청구 설정을 구성할 수 있는 권한이 있어야 합니다. 필요한 권한의 전체 목록은 청구 관리: 필수 구성 요소를 참조하세요. |
| Subscription | Microsoft Entra ID에서 Azure DevOps 조직과 동일한 ID의 Azure 구독이 있어야 합니다. |
GitHub 호스팅 에이전트 청구 활성화
GitHub 호스팅 에이전트는 종량제 청구를 사용합니다. 컴퓨터 크기에 따라 파이프라인 실행 시간의 분당 요금이 청구됩니다. 가격 책정 정보는 Azure DevOps 가격 책정 참조하세요.
메모
GitHub 호스팅 에이전트는 무료 플랜이나 무료 사용 시간을 제공하지 않습니다. 모든 사용량은 분당 청구됩니다. 이 종량제 청구 모델은 Microsoft 호스팅 에이전트에 적용되는 병렬 작업 동시 실행 청구와는 별개입니다.
Azure DevOps 조직에서 청구를 아직 사용하도록 설정하지 않은 경우 먼저 조직의 청구 설정 지침에 따라 사용하도록 설정합니다.
청구 설정에서 종량제 청구를 켭니다. GitHub 호스팅 에이전트 사용을 켜기로 설정하고 페이지 하단에서 저장을 선택합니다.
GitHub 호스팅 에이전트 사용
종량제 청구를 사용하도록 설정하면 Azure DevOps 조직에 새 GitHub 호스팅 에이전트 풀을 만듭니다. 이 풀은 분당 요금이 청구되는 추가 이미지 레이블을 제공합니다.
YAML 파이프라인에서 GitHub 호스팅 에이전트를 사용하려면 다음 속성을 사용하여 pool 섹션을 구성합니다.
-
name:'GitHub-hosted Agents' -
vmImage: 사용하려는 VM 이미지 레이블입니다. 사용 가능한 이미지 레이블은 GitHub 호스팅 에이전트 이미지 참조하세요.
pool:
name: 'GitHub-hosted Agents'
vmImage: 'macos-26-arm64'
steps:
- bash: |
echo Hello from macOS Tahoe arm64
uname -a
sw_vers
추가 예제:
pool:
name: 'GitHub-hosted Agents'
vmImage: 'macos-26-arm64-xl'
steps:
- bash: |
echo Hello from XL macOS Tahoe arm64
uname -a
hostinfo | grep memory
GitHub 호스트된 에이전트 이미지
GitHub 호스팅 에이전트는 표준 Microsoft 호스팅 에이전트 구성 비해 더 높은 성능 구성을 제공합니다. GitHub 호스팅 에이전트 풀은 다음과 같은 하드웨어 사양 및 가상 머신 이미지를 제공합니다.
GitHub 호스팅 에이전트는 다음 macOS 버전에 대한 이미지를 제공합니다.
| macOS 버전 | 포함된 소프트웨어 |
|---|---|
| macOS 26 ARM 64 | Link |
이 macOS 이미지는 다음 하드웨어 사양을 사용하여 파이프라인을 실행할 수 있습니다.
| 하드웨어 사양 | vCPU (가상 중앙 처리 장치) | RAM | 스토리지(SSD) | 아키텍처 |
|---|---|---|---|---|
| 표준 | 3 | 7GB | 14GB | arm64(M1) |
| 엑스라지 | 5(+ 8 GPU 하드웨어 가속) | 14GB | 14GB | arm64(M2) |
GitHub 호스팅 에이전트를 사용하여 파이프라인을 실행하려면 다음 목록에서 원하는 운영 체제 및 하드웨어 사양과 일치하는 이미지 레이블을 지정합니다.
| OS(운영 체제) | 하드웨어 사양 | Image | YAML VM 이미지 레이블 |
|---|---|---|---|
| macOS 26 | 표준 | macOS 26 ARM64 | macos-26-arm64 |
| macOS 26 | 엑스라지 | macOS 26 ARM64 XL | macos-26-arm64-xl |
Important
공개 미리 보기 중에 조직은 8개의 Standard 및 8개의 XLarge GitHub 호스팅 에이전트로 제한됩니다. 하드웨어 사양당 8개 이상의 파이프라인 작업 큐가 있는 경우 처음 8개의 작업이 실행되고 초기 작업이 완료될 때까지 나머지 큐가 실행됩니다. 공개 미리 보기 중에 하드웨어 사양당 8개 이상의 에이전트가 필요한 경우 지원 사례를 만듭니다.
사용량 모니터링
풀에서 분석 탭을 사용하거나 Azure Cost Management 사용하는 두 가지 방법으로 파이프라인 사용량을 모니터링할 수 있습니다.
분석 보기
GitHub 호스팅 에이전트 풀에서 Analytics 탭을 선택합니다. 표시할 에이전트 SKU 및 사용 기간을 선택합니다. 이 선택은 그래프를 렌더링하고 선택한 에이전트 SKU를 사용하는 상위 프로젝트를 나열합니다. 프로젝트로 드릴다운한 다음 파이프라인 수준으로 드릴다운하여 에이전트 SKU를 사용하는 작업을 표시할 수 있습니다.
Azure Cost Management
종량제 파이프라인 사용량을 필터링하려면 다음을 선택합니다.
- 미터 카테고리: Azure DevOps
- 미터 하위 범주: Azure Pipelines
- 측정 단위: 1/분
또한 다음을 필터링할 수 있습니다.
- Meter
- 태그:
_organizationname_
Networking
GitHub 호스트된 에이전트는 Microsoft 호스팅 에이전트와 유사한 네트워크 기능을 갖습니다.
GitHub 호스팅 에이전트는 GitHub Actions 더 큰 실행기와 동일한 인프라에서 실행됩니다. GitHub 호스팅 에이전트와 서버 간의 네트워크 트래픽은 공용 네트워크를 통해 이동합니다.
Important
ExpressRoute 또는 VPN과 같은 프라이빗 연결을 사용하여 GitHub 호스트된 에이전트를 회사 네트워크에 연결할 수 없습니다.
보안
GitHub 호스트된 에이전트에는 Microsoft 호스팅된 에이전트와 동일한 보안 기능 있습니다.
GitHub 호스팅 에이전트는 각 작업이 끝난 후 다시 이미지가 적용되는 격리된 가상 머신에서 실행됩니다. 각 에이전트는 단일 조직 전용이며 각 VM은 단일 에이전트만 호스트합니다.
- 에이전트에는 공용 IP 주소가 없으므로 외부 엔터티는 직접 대상을 지정할 수 없습니다.
- 각 작업은 새로 프로비전된 VM에서 실행되므로 작업 간에 데이터가 유지되지 않습니다.
- 호스트된 이미지는 CIS 강화 벤치마크를 준수하지 않습니다. CIS 강화 이미지를 사용하려면 자체 호스팅 에이전트 또는 관리형 DevOps 풀을 고려합니다.
기능 및 제한 사항
GitHub 호스트된 에이전트는 각 작업에 대한 새 가상 머신과 최신 소프트웨어로 이미지를 자동으로 업데이트하는 등 Microsoft 호스팅 에이전트와 비슷한 > 능력 및 제한 사항을 가지며 다음과 같은 주요 차이점이 있습니다.
GitHub 호스트된 에이전트:
- 표준 Microsoft 호스팅 에이전트보다 더 많은 vCPU, RAM 및 디스크 공간이 있는 더 큰 컴퓨터 크기를 제공합니다.
- 무료 제공량 없이 사용 시간 1분당 요금이 청구됩니다.
에이전트 풀 옵션 비교
| 특징 | Microsoft가 호스팅하는 에이전트 | GitHub 호스팅 에이전트(PAYG) | 자체 호스팅 에이전트 |
|---|---|---|---|
| 결제 | 병렬 작업(동시성 기반) | 분당 (종량제) | 자체 인프라 |
| 무료 계층 | 예(제한적) | No | 적용되지 않음 (N/A) |
| 컴퓨터 크기 | 표준(2개 vCPU, 7GB RAM) | 다양(Microsoft 호스팅보다 큼) | 관습 |
| 정비 | 자동 | 자동 | Manual |
| 사용자 지정 소프트웨어 | 파이프라인 실행 중 설치 | 파이프라인 실행 중 설치 | Preinstalled |
| 회사 네트워크 | 직접 액세스 없음 | 직접 액세스 없음 | 직접 액세스 |