Google Cloud 통합 API
Offering: GitLab.com
이 API를 사용하여 Google Cloud 통합과 상호 작용합니다. 프로젝트에 대한 Maintainer 또는 Owner 권한을 가진 사용자는 다음 엔드포인트를 사용하여 Google Cloud에서 워크로드 아이덴티티 페더레이션을 생성하고 구성하는 셸 스크립트를 쿼리할 수 있습니다:
이 API를 사용하여 Google Cloud 통합과 상호 작용합니다. 자세한 내용은 GitLab과 Google Cloud 통합을 참조하세요.
프로젝트 수준 Google Cloud 통합 스크립트#
워크로드 아이덴티티 페더레이션 생성 스크립트#
히스토리
- GitLab 16.10에서 도입됨.
프로젝트에 대한 Maintainer 또는 Owner 권한을 가진 사용자는 다음 엔드포인트를 사용하여 Google Cloud에서 워크로드 아이덴티티 페더레이션을 생성하고 구성하는 셸 스크립트를 쿼리할 수 있습니다:
GET /projects/:id/google_cloud/setup/wlif.sh
지원되는 속성:
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
id |
integer | 예 | 프로젝트의 ID. |
google_cloud_project_id |
string | 예 | 워크로드 아이덴티티 페더레이션을 위한 Google Cloud 프로젝트 ID. |
google_cloud_workload_identity_pool_id |
string | 아니요 | 생성할 Google Cloud 워크로드 아이덴티티 풀의 ID. 기본값은 gitlab-wlif. |
google_cloud_workload_identity_pool_display_name |
string | 아니요 | 생성할 Google Cloud 워크로드 아이덴티티 풀의 표시 이름. 기본값은 WLIF for GitLab integration. |
google_cloud_workload_identity_pool_provider_id |
string | 아니요 | 생성할 Google Cloud 워크로드 아이덴티티 풀 공급자의 ID. 기본값은 gitlab-wlif-oidc-provider. |
google_cloud_workload_identity_pool_provider_display_name |
string | 아니요 | 생성할 Google Cloud 워크로드 아이덴티티 풀 공급자의 표시 이름. 기본값은 GitLab OIDC provider. |
예시 요청:
curl --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.com/api/v4/projects/<your_project_id>/google_cloud/setup/wlif.sh"
Google Cloud 통합 설정 스크립트#
히스토리
- GitLab 16.10에서 도입됨.
프로젝트에 대한 Maintainer 또는 Owner 권한을 가진 사용자는 다음 엔드포인트를 사용하여 Google Cloud 통합을 설정하는 셸 스크립트를 쿼리할 수 있습니다:
GET /projects/:id/google_cloud/setup/integrations.sh
Google Artifact Management 통합만 지원됩니다. 스크립트는 Google Artifact Registry에 접근하기 위한 IAM 정책을 생성합니다:
- Artifact Registry Reader 권한은 최소한 Reporter 권한을 가진 멤버에게 부여됩니다
- Artifact Registry Writer 권한은 최소한 Developer 권한을 가진 멤버에게 부여됩니다
지원되는 속성:
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
id |
integer | 예 | GitLab 프로젝트의 ID. |
enable_google_cloud_artifact_registry |
boolean | 예 | Google Artifact Management 통합 활성화 여부를 나타내는 플래그. |
google_cloud_artifact_registry_project_id |
string | 예 | Artifact Registry를 위한 Google Cloud 프로젝트 ID. |
예시 요청:
curl --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.com/api/v4/projects/<your_project_id>/google_cloud/setup/integrations.sh"
러너 프로비저닝을 위한 Google Cloud 프로젝트 구성 스크립트#
히스토리
- GitLab 16.10에서 도입됨.
프로젝트에 대한 Maintainer 또는 Owner 권한을 가진 사용자는 다음 엔드포인트를 사용하여 러너 프로비저닝 및 실행을 위한 Google Cloud 프로젝트 구성 셸 스크립트를 쿼리할 수 있습니다:
GET /projects/:id/google_cloud/setup/runner_deployment_project.sh
스크립트는 지정된 Google Cloud 프로젝트에서 사전 구성 단계를 수행합니다. 즉, 필요한 서비스를 활성화하고 GRITProvisioner 권한과 grit-provisioner 서비스 계정을 생성합니다.
지원되는 속성:
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
id |
integer | 예 | GitLab 프로젝트의 ID. |
google_cloud_project_id |
string | 예 | Google Cloud 프로젝트의 ID. |
예시 요청:
curl --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.com/api/v4/projects/<your_project_id>/google_cloud/setup/runner_deployment_project.sh?google_cloud_project_id=<your_google_cloud_project_id>"