GitHub Enterprise Server에서 GitHub Actions 시작하기

GitHub Actions의 GitHub Enterprise Server 소개

이 문서에서는 사이트 관리자가 GitHub Enterprise Server에서 GitHub Actions을 사용하도록 구성하는 방법을 설명합니다.

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에 대한 성능 목표를 보여 줍니다.

vCPUs	메모리	최대 연결된 러너
8	64GB	주자 740명
32	160GB	달리기 참가자 2700명
96	384GB	주자 7000명

GitHub 여러 리포지토리, 약 10분의 작업 실행 시간, 그리고 10 MB 아티팩트 업로드 조건에서 연결된 최대 러너 수를 측정했습니다. 인스턴스의 전체 활동 수준에 따라 성능이 다를 수 있습니다.

GitHub Enterprise Server 3.5GitHub부터 내부 테스트는 3세대 CPU를 사용하여 일반적인 고객 구성을 보다 잘 반영합니다. CPU의 이러한 변경은 이 버전의 성능 대상에 대한 변경 내용의 GitHub Enterprise Server작은 부분을 나타냅니다.

기존 인스턴스의 사용자를 사용하도록 설정 GitHub Actions 하려는 경우 인스턴스의 사용자 및 자동화에 대한 활동 수준을 검토하고 사용자에게 적절한 CPU 및 메모리를 프로비전했는지 확인합니다. 용량 및 성능 GitHub Enterprise Server모니터링에 대한 자세한 내용은 인스턴스 모니터링을 참조하세요.

최소 하드웨어 요구 사항에 대한 GitHub Enterprise Server 인스턴스자세한 내용은 인스턴스 플랫폼에 대한 하드웨어 고려 사항을 참조하세요.

• AWS
• Azure
• Google Cloud Platform
• Hyper-V
• OpenStack KVM
• VM웨어

기존 인스턴스의 리소스 조정에 대한 자세한 내용은 스토리지 용량 늘리기 및 CPU 또는 메모리 리소스 늘리기을(를) 참조하세요.

필요에 따라 에 대한 GitHub Enterprise Server 인스턴스GitHub Actions속도 제한을 구성하여 리소스 사용량을 제한할 수 있습니다. 자세한 내용은 속도 제한 구성을(를) 참조하세요.

외부 스토리지 요구 사항

GitHub Actions에서 GitHub Enterprise Server을 사용하도록 설정하려면 외부 Blob Storage에 대한 액세스 권한이 있어야 합니다.

GitHub Actions는 외부 blob 스토리지를 사용하여 워크플로 실행으로 생성된 데이터터를 저장합니다. 저장된 데이터에는 워크플로 로그, 캐시 및 사용자가 업로드한 빌드 아티팩트가 포함됩니다. 필요한 스토리지의 양은 사용량에 GitHub Actions따라 달라집니다. 단일 외부 스토리지 구성만 지원되며 동시에 여러 스토리지 공급자를 사용할 수 없습니다.

리포지토리의 파일 구조에 있는 워크플로 파일과 같은 다른 GitHub Actions 모든 데이터는 데이터 스토리지 볼륨 GitHub Enterprise Server 인스턴스에 저장됩니다.

GitHub Actions 에서는 다음 스토리지 공급자를 지원합니다.

• Azure Blob Storage (Azure 블롭 스토리지)
• 아마존 S3
• Google 클라우드 Storage
• S3 호환 MinIO 클러스터

네트워킹 고려 사항

엔터프라이즈에 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 Actions 워크플로를 실행하려면 자체 호스팅 실행기를 추가해야 합니다. 엔터프라이즈, 조직 또는 리포지토리 수준에서 자체 호스트된 실행기를 추가할 수 있습니다. 자세한 내용은 자체 호스트형 실행기 추가을(를) 참조하세요.

엔터프라이즈에서 사용할 수 있는 작업 관리

엔터프라이즈에서 사용자가 사용할 수 있는 작업을 제어할 수 있습니다. 여기에는 GitHub Connect의 작업에 자동으로 액세스할 수 있도록 GitHub.com를 설정하거나, GitHub.com의 작업을 수동으로 동기화하는 것이 포함됩니다.

자세한 내용은 엔터프라이즈에서 작업 사용 정보을(를) 참조하세요.

GitHub Actions에 대한 일반적인 보안 강화

보안 사례 GitHub Actions에 대해 자세히 알아보려면 안전 사용 참조을 참조하세요.

예약된 이름

GitHub Actions를 엔터프라이즈에서 사용하도록 설정하면 두 개의 조직(github 및 actions)이 생성됩니다. 기업에서 이미 github 조직 이름을 사용하는 경우(또는 github-org 또한 사용 중인 경우 github-github-org) github-org가 대신 사용됩니다. 기업에서 이미 actions 조직 이름을 사용하는 경우(또는 github-actions 또한 사용 중인 경우 github-actions-org) github-actions가 대신 사용됩니다. 작업을 사용하도록 설정하면 이 이름들을 더 이상 사용할 수 없습니다.