GitHub Actions에 대한 외부 스토리지 정보
GitHub Actions는 외부 blob 스토리지를 사용하여 워크플로 실행으로 생성된 데이터터를 저장합니다. 저장된 데이터에는 워크플로 로그, 캐시 및 사용자가 업로드한 빌드 아티팩트가 포함됩니다. 자세한 내용은 “GitHub Enterprise Server용 GitHub Actions 시작”을(를) 참조하세요.
필수 조건
GitHub Actions를 사용하도록 설정하기 전에 다음 단계를 완료했는지 확인합니다.
-
워크플로 실행에서 생성된 데이터를 저장하기 위한 MinIO 버킷을 만듭니다. MinIO 설치 및 구성에 대한 자세한 내용은 MinIO 설명서에서 "MinIO 고성능 개체 스토리지" 및 "mc mb"를 참조하세요.
어플라이언스에서 리소스 경합을 방지하려면 MinIO를 GitHub Enterprise Server 인스턴스과(와) 별도로 호스트하는 것이 좋습니다.
GitHub Actions에는 버킷에 액세스하는 액세스 키에 대한 다음 권한이 필요합니다.
s3:PutObject
s3:GetObject
s3:ListBucketMultipartUploads
s3:ListMultipartUploadParts
s3:AbortMultipartUpload
s3:DeleteObject
s3:ListBucket
kms:GenerateDataKey
(키 관리 서비스(KMS) 암호화를 사용 설정한 경우)
-
GitHub Actions에 대한 하드웨어 요구 사항을 검토합니다. 자세한 내용은 "GitHub Enterprise Server용 GitHub Actions 시작"을(를) 참조하세요.
-
GitHub Enterprise Server의 도메인에 대해 TLS를 구성해야 합니다. 자세한 내용은 "TLS 구성"을(를) 참조하세요.
Note
신뢰할 수 있는 기관에서 서명한 인증서를 사용하여 GitHub Enterprise Server에서 TLS를 구성하는 것이 좋습니다. 자체 서명된 인증서가 작동할 수 있지만 자체 호스팅 실행기에는 추가 구성이 필요하며 프로덕션 환경에는 권장되지 않습니다.
-
GitHub에 HTTP 프록시 서버가 구성되어 있는 경우:
-
HTTP 프록시 제외 목록에
.localhost
및127.0.0.1
,::1
을(를) 이 순서로 추가해야 합니다. -
외부 스토리지 위치를 라우팅할 수 없는 경우, 외부 스토리지 URL도 제외 목록에 추가해야 합니다.
프록시 설정 또는 변경에 대한 자세한 내용은 "아웃바운드 웹 프록시 서버 구성"(을)를 참조하세요.
MinIO 스토리지를 사용하여 GitHub Actions 활성화
-
페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.
-
“Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.
-
" 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.
-
"설정" 사이드바에서 작업을 클릭합니다.
-
"GitHub Actions"에서 GitHub Actions 활성화를 선택합니다.
-
"아티팩트 및 로그 스토리지"의 "Amazon S3" 옆에 있는 설치 프로그램을 클릭합니다.
-
"인증"에서 자격 증명 기반을 선택하고 스토리지 버킷의 세부 정보를 입력합니다.
Note
MinIO의 경우 OIDC(OpenID Connect) 인증을 사용할 수 없습니다. 자격 증명 기반 인증을 사용해야 합니다.
- AWS 서비스 URL: MinIO 서비스에 대한 URL입니다. 예들 들어
https://my-minio.example:9000
입니다. - AWS S3 버킷: S3 버킷의 이름입니다.
- AWS S3 액세스 키 및 AWS S3 비밀 키: MinIO 인스턴스에 사용되는
MINIO_ACCESS_KEY
및MINIO_SECRET_KEY
입니다.
- AWS 서비스 URL: MinIO 서비스에 대한 URL입니다. 예들 들어
-
“아티팩트 및 로그 스토리지”에서 경로 스타일 강제를 선택합니다.
-
스토리지 설정 테스트 버튼을 클릭하여 스토리지 설정의 유효성을 확인합니다.
스토리지 설정의 유효성을 검증할 떄 오류가 있으면 스토리지 공급자와 설정을 확인하고 다시 검사합니다.
-
"설정" 사이드바에서 설정 저장을 클릭합니다.
Note
관리 콘솔에 설정을 저장하면 시스템 서비스가 다시 시작되어 사용자에게 표시되는 가동 중지 시간이 발생할 수 있습니다.
-
구성 실행이 완료될 때까지 기다립니다.
다음 단계
구성 실행이 성공적으로 완료되면 GitHub Actions가 GitHub에서 사용 설정됩니다. GitHub Actions 액세스 권한 관리 및 자체 호스팅 실행기 추가와 같은 다음 단계는 "GitHub Enterprise Server용 GitHub Actions 시작"으로 돌아갑니다.