참고: GitHub 호스트 실행기는 현재 GitHub Enterprise Server에서 지원되지 않습니다. GitHub public roadmap에 예정된 향후 지원에 대해 자세히 알아볼 수 있습니다.
GitHub Enterprise Server의 GitHub Actions 정보
이 문서에서는 사이트 관리자가 GitHub Actions를 사용하도록 GitHub Enterprise Server를 구성하는 방법을 설명합니다.
GitHub Actions는 기본적으로 GitHub Enterprise Server에 대해 사용하도록 설정되어 있지 않습니다. 인스턴스에 성능 저하를 일으키지 않고 GitHub Actions의 로드를 처리할 수 있는 적절한 CPU 및 메모리 리소스가 있는지 확인하고 해당 리소스를 늘릴 수 있는지 확인해야 합니다. 또한 워크플로 실행에 의해 생성된 아티팩트 및 캐시 저장에 필요한 Blob Storage에 사용할 스토리지 공급자를 결정해야 합니다. 그런 다음 엔터프라이즈에 GitHub Actions를 사용하도록 설정하고, 액세스 권한을 관리하고, 자체 호스트된 실행기를 추가하여 워크플로를 실행합니다.
시작하기 전에 엔터프라이즈에 GitHub Actions를 도입하는 방법에 대한 계획을 세워야 합니다. 자세한 내용은 "엔터프라이즈에 GitHub Actions 도입"을(를) 참조하세요.
엔터프라이즈를 다른 공급자의 GitHub Actions로 마이그레이션하는 경우 추가로 고려할 사항이 있습니다. 자세한 내용은 "GitHub Actions로 엔터프라이즈 마이그레이션"을(를) 참조하세요.
하드웨어 요구 사항 검토
GitHub Enterprise Server 인스턴스에 사용할 수 있는 CPU 및 메모리 리소스는 성능 손실 없이 구성할 수 있는 실행기 수를 결정합니다. GitHub은 GitHub Actions를 실행하기 위해 최소 8개의 vCPU 및 64GB 메모리가 필요합니다.
성능 손실 없는 연결된 실행기의 최대 수량은 작업 기간, 아티팩트 사용량, Actions를 실행하는 리포지토리 수 및 인스턴스가 수행하는 Actions와 관련이 없는 다른 작업의 양과 같은 요인에 따라 달라집니다. GitHub 내부 테스트는 다양한 CPU 및 메모리 구성에서 GitHub Enterprise Server에 대한 성능 목표를 보여 줍니다.
| vCPU | 메모리 | 최대 연결 실행기 |
|---|---|---|
| 8 | 64GB | 실행기 740개 |
| 32 | 160GB | 실행기 2700개 |
| 96 | 384 GB | 실행기 7000개 |
GitHub는 여러 리포지토리, 작업 기간 10분, 아티팩트 업로드 10MB를 사용하여 최대 연결 실행기를 측정했습니다. 인스턴스의 전체 활동 수준에 따라 성능이 다를 수 있습니다.
참고:
-
GitHub Enterprise Server 3.6부터 GitHub에서는 동시 작업이 아닌 연결된 실행기를 문서화합니다. 연결된 실행기는 사용자가 연결할 수 있으며 활용할 것으로 예상되는 대부분의 실행기를 나타냅니다. 또한 활용할 것으로 예상되는 것보다 많은 실행기를 연결하면 성능에 부정적인 영향을 줄 수 있습니다.
-
GitHub Enterprise Server 3.5부터 GitHub의 내부 테스트는 일반적인 고객 구성을 더 잘 반영하기 위해 3세대 CPU를 사용합니다. 이러한 CPU 변경은 이 버전의 GitHub Enterprise Server에서 성능 목표 변경 내용 중 일부를 나타냅니다.
기존 인스턴스의 사용자에 대해 GitHub Actions를 사용하도록 설정할 계획인 경우 인스턴스의 사용자 및 자동화의 활동 수준을 검토하고 사용자에게 적절한 CPU 및 메모리를 프로비저닝했는지 확인합니다. GitHub Enterprise Server의 용량 및 성능 모니터링에 대한 자세한 내용은 "인스턴스 모니터링"을(를) 참조하세요.
GitHub Enterprise Server 인스턴스에 대한 최소 하드웨어 요구 사항에 대한 자세한 내용은 인스턴스 플랫폼에 대한 하드웨어 고려 사항을 참조하세요.
기존 인스턴스의 리소스 조정에 대한 자세한 내용은 "스토리지 용량 늘리기" 및 "CPU 또는 메모리 리소스 늘리기"를 참조하세요.
필요에 따라 GitHub Enterprise Server 인스턴스에 대한 속도 제한을 구성하여 GitHub Actions에서의 리소스 사용을 제한할 수 있습니다. 자세한 내용은 "속도 제한 구성"을(를) 참조하세요.
외부 스토리지 요구 사항
GitHub Enterprise Server에서 GitHub Actions를 사용하도록 설정하려면 외부 Blob Storage에 액세스할 수 있어야 합니다.
GitHub Actions는 외부 blob 스토리지를 사용하여 워크플로 실행으로 생성된 데이터터를 저장합니다. 저장된 데이터에는 워크플로 로그, 캐시 및 사용자가 업로드한 빌드 아티팩트가 포함됩니다. 필요한 스토리지 양은 GitHub Actions의 사용량에 따라 달라집니다. 단일 외부 스토리지 구성만 지원되며 동시에 여러 스토리지 공급자를 사용할 수 없습니다.
다른 모든 GitHub Actions 데이터(예: 리포지토리의 파일 구조에 있는 워크플로 파일)는 GitHub Enterprise Server 인스턴스의 데이터 스토리지 볼륨에 저장됩니다.
GitHub Actions는 다음 스토리지 공급자를 지원합니다.
- Azure Blob 스토리지
- Amazon S3
- Google Cloud Storage
- S3 호환 MinIO 클러스터
참고: 이들은 GitHub에서 지원하고 도움을 제공할 수 있는 유일한 스토리지 공급자입니다.
GitHub 파트너가 GitHub Enterprise Server에서 GitHub Actions으로 작업하는 것으로 자체 유효성을 검사한 다른 S3 API 호환 스토리지 제품이 있습니다. 자세한 내용은 GHES Storage Partners 리포지토리를 참조하세요.
GitHub 기술 파트너 관계 프로그램을 통해 유효성을 검사한 스토리지 제품의 경우, 스토리지 공급자는 GitHub Actions에서 스토리지 제품을 사용하기 위한 지원 및 설명서를 담당합니다.
네트워킹 고려 사항
엔터프라이즈에 GitHub Actions을 사용하도록 설정하면 HTTP 프록시만 지원됩니다. SOCKS5 및 HTTPS 프록시는 지원되지 않습니다. GitHub Enterprise Server에서 프록시를 사용하는 방법에 대한 자세한 내용은 “아웃바운드 웹 프록시 서버 구성”을(를) 참조하세요.
스토리지 공급자에서 GitHub Actions 사용
선택한 스토리지 공급자에서 GitHub Actions를 사용하도록 설정하려면 아래 절차 중 하나를 따르세요.
- Azure Blob Storage에서 GitHub Actions 사용
- Amazon S3 스토리지에서 GitHub Actions 사용
- Google Cloud Storage에서 GitHub Actions 사용
- MinIO 스토리지에서 GitHub Actions 사용
엔터프라이즈에서 GitHub Actions에 대한 액세스 권한 관리
정책을 사용하여 GitHub Actions에 대한 액세스를 관리할 수 있습니다. 자세한 내용은 "엔터프라이즈에서 GitHub Actions에 대한 정책 적용"을(를) 참조하세요.
자체 호스트형 실행기 추가
참고: GitHub 호스트 실행기는 현재 GitHub Enterprise Server에서 지원되지 않습니다. GitHub public roadmap에 예정된 향후 지원에 대해 자세히 알아볼 수 있습니다.
GitHub Actions 워크플로를 실행하려면 자체 호스트된 실행기를 추가해야 합니다. 엔터프라이즈, 조직 또는 리포지토리 수준에서 자체 호스트된 실행기를 추가할 수 있습니다. 자세한 내용은 "자체 호스트형 실행기 추가"을(를) 참조하세요.
엔터프라이즈에서 사용할 수 있는 작업 관리
엔터프라이즈에서 사용자가 사용할 수 있는 작업을 제어할 수 있습니다. 여기에는 GitHub.com의 작업에 자동으로 액세스하기 위해 GitHub Connect를 설정하거나 GitHub.com의 작업을 수동으로 동기화하는 작업이 포함됩니다.
자세한 내용은 "엔터프라이즈에서 작업 사용 정보"을(를) 참조하세요.
GitHub Actions에 대한 일반적인 보안 강화
GitHub Actions에 대한 보안 사례에 대해 자세히 알아보려면 "GitHub Actions에 대한 보안 강화"을 참조하세요.
예약된 이름
엔터프라이즈에서 GitHub Actions를 사용하도록 설정하면 github 및 actions라는 두 개의 조직이 만들어집니다. 기업에서 이미 github 조직 이름을 사용하는 경우(또는 github-org 또한 사용 중인 경우 github-github-org) github-org가 대신 사용됩니다. 기업에서 이미 actions 조직 이름을 사용하는 경우(또는 github-actions 또한 사용 중인 경우 github-actions-org) github-actions가 대신 사용됩니다. 작업을 사용하도록 설정하면 이름을 더 이상 사용할 수 없습니다.