Google Artifact Management

Tier: Free, Premium, Ultimate Offering: GitLab.com

GitLab 16.10에서 소개됨, google_cloud_support_feature_flag라는 플래그로. 이 기능은 beta 상태입니다.
GitLab 17.1에서 GitLab.com에 활성화됨. google_cloud_support_feature_flag 플래그가 삭제되었습니다.

Google Artifact Management 통합을 사용하여 GitLab 프로젝트에 Google Artifact Registry 리포지토리를 구성하고 연결할 수 있습니다.

Google Artifact Registry를 프로젝트에 연결한 후에는 Google Artifact Registry 리포지토리에서 Docker 및 OCI 이미지를 보고 푸시하고 끌어올 수 있습니다.

GitLab 프로젝트에서 Google Artifact Registry 설정

사전 준비 사항:

GitLab 프로젝트의 최소한 Maintainer 역할이 있어야 합니다.
Artifact Registry 리포지토리에 액세스를 관리할 수 있는 필요한 권한이 있어야 합니다.
워크로드 식별 제어 연합 (WLIF) 풀 및 프로바이더가 구성되어 Google Cloud에 인증해야 합니다.
다음 구성을 갖춘 Google Artifact Registry 리포지토리가 있어야 합니다:
- Docker 포맷.
- 표준 모드. 다른 리포지토리 형식 및 모드는 지원되지 않습니다.

GitLab 프로젝트에 Google Artifact Registry 리포지토리를 연결하려면:

GitLab에서 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
설정 > 통합을 선택합니다.
Google Artifact Management를 선택합니다.
통합 활성화 아래에서 Active 확인란을 선택합니다.
다음 필드를 완성합니다:
- Google Cloud 프로젝트 ID: Artifact Registry 리포지토리가 있는 Google Cloud 프로젝트 ID.
- 리포지토리 이름: Artifact Registry 리포지토리의 이름.
- 리포지토리 위치: Artifact Registry 리포지토리의 Google Cloud 위치.
화면 안내에 따라 Google Cloud Identity 및 Access Management (IAM) 정책을 설정합니다. 정책 유형에 대한 자세한 정보는 IAM 정책을 참조하십시오.
변경 사항 저장을 선택합니다.

이제 배포 아래의 사이드바에서 Google Artifact Registry 항목을 확인할 수 있습니다.

Google Artifact Registry에 저장된 이미지 보기

사전 준비 사항:

프로젝트에 Google Artifact Registry가 구성되어 있어야 합니다.

GitLab UI에서 연결된 Artifact Registry 리포지토리의 이미지 목록을 보려면:

왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
배포 > Google Artifact Registry를 선택합니다.
이미지 세부 정보를 보려면 이미지를 선택합니다.
Google Cloud 콘솔에서 이미지를 보려면 Google Cloud에서 열기를 선택합니다. 해당 Artifact Registry 리포지토리를 보려면 필요한 권한이 있어야 합니다.

CI/CD

미리 정의된 환경 변수

Artifact Registry 통합을 활성화하면 CI/CD에서 다음 미리 정의된 환경 변수를 사용할 수 있습니다. 이러한 환경 변수를 사용하여 연결된 리포지토리로 이미지를 끌어오거나 푸시와 같이 Artifact Registry와 상호 작용할 수 있습니다.

변수	GitLab	Runner	설명
`GOOGLE_ARTIFACT_REGISTRY_PROJECT_ID`	16.10	16.10	Artifact Registry 리포지토리가 있는 Google Cloud 프로젝트 ID.
`GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_NAME`	16.10	16.10	연결된 Artifact Registry 리포지토리의 이름.
`GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_LOCATION`	16.10	16.10	연결된 Artifact Registry 리포지토리의 Google Cloud 위치.

Google Artifact Registry로 인증

파이프라인을 구성하여 파이프라인 실행 중 Google Artifact Registry와 인증할 수 있습니다. GitLab은 구성된 워크로드 식별 풀 IAM 정책을 사용하고 GOOGLE_APPLICATION_CREDENTIALS와 CLOUDSDK_AUTH_CREDENTIAL_FILE_OVERRIDE 환경 자격 증명을 채웁니다. 이러한 환경 자격 증명은 gcloud CLI 및 crane 등의 클라이언트 도구에서 자동으로 감지됩니다.

Google Artifact Registry로 인증하려면 프로젝트의 .gitlab-ci.yml 파일에서 identity 키워드를 google_cloud로 설정하십시오.

IAM 정책

Google Cloud 프로젝트에는 Google Artifact Management 통합을 사용하려면 특정한 IAM 정책이 있어야 합니다. 이 통합을 설정하는 경우, 화면 안내에 따라 다음 IAM 정책을 Google Cloud 프로젝트에 만드는 단계가 제공됩니다:

Artifact Registry Reader 역할을 GitLab 프로젝트 멤버에게 부여하고 Guest 역할 이상을 가진 GitLab 프로젝트 멤버에게 권한을 부여합니다.
Artifact Registry Writer 역할을 GitLab 프로젝트 멤버에게 부여하고 Developer 역할 이상을 가진 GitLab 프로젝트 멤버에게 권한을 부여합니다.

이러한 IAM 정책을 수동으로 만들려면 다음 gcloud 명령을 사용하십시오. 다음 값을 대체하십시오:

<your_google_cloud_project_id>: Artifact Registry 리포지토리가 있는 Google Cloud 프로젝트의 ID.
<your_workload_identity_pool_id>: 워크로드 식별 풀의 ID. 이 값은 Google Cloud IAM 통합에 사용된 동일한 값입니다.
<your_google_cloud_project_number>: 워크로드 식별 풀이 있는 Google Cloud 프로젝트의 번호. 이 값은 Google Cloud IAM 통합에 사용된 동일한 값입니다.

gcloud projects add-iam-policy-binding '<your_google_cloud_project_id>' \
  --member='principalSet://iam.googleapis.com/projects/<your_google_cloud_project_number>/locations/global/workloadIdentityPools/<your_workload_identity_pool_id>/attribute.guest_access/true' \
  --role='roles/artifactregistry.reader'

gcloud projects add-iam-policy-binding '<your_google_cloud_project_id>' \
  --member='principalSet://iam.googleapis.com/projects/<your_google_cloud_project_number>/locations/global/workloadIdentityPools/<your_workload_identity_pool_id>/attribute.developer_access/true' \
  --role='roles/artifactregistry.writer'

사용 가능한 클레임 목록에 대한 자세한 정보는 OIDC 사용자 정의 클레임을 참조하십시오.

예시

gcloud CLI를 사용하여 이미지 목록 나열

list-images:
  image: gcr.io/google.com/cloudsdktool/google-cloud-cli:466.0.0-alpine
  identity: google_cloud
  script:
    - gcloud artifacts docker images list $GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_LOCATION-docker.pkg.dev/$GOOGLE_ARTIFACT_REGISTRY_PROJECT_ID/$GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_NAME/app

crane을 사용하여 이미지 목록 나열

list-images:
  image:
    name: gcr.io/go-containerregistry/crane:debug
    entrypoint: [""]
  identity: google_cloud
  before_script:
    # https://github.com/google/go-containerregistry/issues/1886에 대한 임시 해결책
    - wget -q "https://github.com/GoogleCloudPlatform/docker-credential-gcr/releases/download/v2.1.22/docker-credential-gcr_linux_amd64-2.1.22.tar.gz" -O - | tar xz -C /tmp && chmod +x /tmp/docker-credential-gcr && mv /tmp/docker-credential-gcr /usr/bin/
    - docker-credential-gcr configure-docker --registries=$GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_LOCATION-docker.pkg.dev
  script:
    - crane ls $GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_LOCATION-docker.pkg.dev/$GOOGLE_ARTIFACT_REGISTRY_PROJECT_ID/$GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_NAME/app

Docker를 사용하여 이미지 가져오기

다음 예시에서는 Google에서 제공하는 독립 실행형 Docker 자격 증명 도우미를 사용하여 Docker의 인증을 설정하는 방법을 보여줍니다.

pull-image:
  image: docker:24.0.5
  identity: google_cloud
  services:
    - docker:24.0.5-dind
  variables:
    # 다음 두 변수는 DinD 서비스가 TLS 모드로 시작되고 도커 CLI가 API와 통신하도록 올바르게 구성되도록합니다.
    # 이 중요성에 대한 자세한 내용은 https://docs.gitlab.com/ee/ci/docker/using_docker_build.html#use-the-docker-executor-with-docker-in-docker에서 확인할 수 있습니다.
    DOCKER_HOST: tcp://docker:2376
    DOCKER_TLS_CERTDIR: "/certs"
  before_script:
    - wget -q "https://github.com/GoogleCloudPlatform/docker-credential-gcr/releases/download/v2.1.22/docker-credential-gcr_linux_amd64-2.1.22.tar.gz" -O - | tar xz -C /tmp && chmod +x /tmp/docker-credential-gcr && mv /tmp/docker-credential-gcr /usr/bin/
    - docker-credential-gcr configure-docker --registries=$GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_LOCATION-docker.pkg.dev
  script:
    - docker pull $GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_LOCATION-docker.pkg.dev/$GOOGLE_ARTIFACT_REGISTRY_PROJECT_ID/$GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_NAME/app:v0.1.0

CI/CD 구성 요소를 사용하여 이미지 복사

Google은 이미지를 GitLab 컨테이너 레지스트리에서 Artifact Registry로 복사하는 데 사용할 수있는 upload-artifact-registry CI/CD 구성 요소를 제공합니다.

upload-artifact-registry 구성 요소를 사용하려면 .gitlab-ci.yml에 다음을 추가하십시오:

include:
  - component: gitlab.com/google-gitlab-components/artifact-registry/upload-artifact-registry@main
    inputs:
      stage: deploy
      source: $CI_REGISTRY_IMAGE:$CI_COMMIT_SHORT_SHA
      target: $GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_LOCATION-docker.pkg.dev/$GOOGLE_ARTIFACT_REGISTRY_PROJECT_ID/$GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_NAME/$CI_PROJECT_NAME:$CI_COMMIT_SHORT_SHA

자세한 내용은 구성 요소 문서를 참조하십시오.

upload-artifact-registry 구성 요소를 사용하면 이미지를 Artifact Registry로 복사하는 것이 간단해지며, 이 통합의 목적에 맞는 방법입니다. Docker 또는 Crane을 사용하려는 경우 다음 예시를 참조하십시오.

Docker를 사용하여 이미지 복사

다음 예시에서는 대체로 독립 실행형 Docker 자격 증명 도우미를 사용하여 Docker의 인증을 설정하는 대체 방법으로 gcloud CLI를 사용하는 방법을 보여줍니다.

copy-image:
  image: gcr.io/google.com/cloudsdktool/google-cloud-cli:466.0.0-alpine
  identity: google_cloud
  services:
    - docker:24.0.5-dind
  variables:
    SOURCE_IMAGE: $CI_REGISTRY_IMAGE:v0.1.0
    TARGET_IMAGE: $GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_LOCATION-docker.pkg.dev/$GOOGLE_ARTIFACT_REGISTRY_PROJECT_ID/$GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_NAME/app:v0.1.0
    DOCKER_HOST: tcp://docker:2375
  before_script:
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    - gcloud auth configure-docker $GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_LOCATION-docker.pkg.dev
  script:
    - docker pull $SOURCE_IMAGE
    - docker tag $SOURCE_IMAGE $TARGET_IMAGE
    - docker push $TARGET_IMAGE

Crane을 사용하여 이미지 복사

copy-image:
  image:
    name: gcr.io/go-containerregistry/crane:debug
    entrypoint: [""]
  identity: google_cloud
  variables:
    SOURCE_IMAGE: $CI_REGISTRY_IMAGE:v0.1.0
    TARGET_IMAGE: $GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_LOCATION-docker.pkg.dev/$GOOGLE_ARTIFACT_REGISTRY_PROJECT_ID/$GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_NAME/app:v0.1.0
  before_script:
    # https://github.com/google/go-containerregistry/issues/1886에 대한 임시 해결책
    - wget -q "https://github.com/GoogleCloudPlatform/docker-credential-gcr/releases/download/v2.1.22/docker-credential-gcr_linux_amd64-2.1.22.tar.gz" -O - | tar xz -C /tmp && chmod +x /tmp/docker-credential-gcr && mv /tmp/docker-credential-gcr /usr/bin/
    - docker-credential-gcr configure-docker --registries=$GOOGLE_ARTIFACT_REGISTRY_REPOSITORY_LOCATION-docker.pkg.dev
  script:
    - crane auth login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    - crane copy $SOURCE_IMAGE $TARGET_IMAGE

Google Artifact Management

GitLab 프로젝트에서 Google Artifact Registry 설정

Google Artifact Registry에 저장된 이미지 보기

CI/CD

미리 정의된 환경 변수

Google Artifact Registry로 인증

IAM 정책

예시

gcloud CLI를 사용하여 이미지 목록 나열

crane을 사용하여 이미지 목록 나열

Docker를 사용하여 이미지 가져오기

CI/CD 구성 요소를 사용하여 이미지 복사

Docker를 사용하여 이미지 복사

Crane을 사용하여 이미지 복사

도움말

기능 사용 가능성과 제품 평가판

도움받기