저장소 및 이미지 이름

Artifact Registry는 API, gcloud, docker 명령어를 사용하여 저장소와 상호작용할 때 이름 및 규칙을 지정하는 명명 규칙을 사용합니다.

Docker 저장소

Docker 저장소의 전체 이름은 다음 형식입니다.

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY

각 항목의 의미는 다음과 같습니다.

  • LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다.

  • PROJECT는 Google Cloud Console 프로젝트 ID입니다. 프로젝트 ID에 콜론(:)이 포함되어 있고 Docker 저장소에서 작업하는 경우 도메인 범위 프로젝트를 참조하세요.

  • REPOSITORY은 저장소 이름입니다.

예를 들어 다음과 같은 특성을 지닌 이미지라고 가정해 보겠습니다.

  • 저장소 위치: us
  • 저장소 형식: docker
  • 저장소 이름: my-repo
  • 프로젝트 ID: my-project

저장소는 다음과 같이 지정됩니다.

us-docker.pkg.dev/my-project/my-repo

컨테이너 이미지 이름

컨테이너 이미지의 전체 이름은 다음 형식 중 하나입니다.

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE

또는

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE:TAG

또는

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE@IMAGE-DIGEST

각 항목의 의미는 다음과 같습니다.

  • LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다.
  • PROJECT는 Google Cloud Console 프로젝트 ID입니다. 프로젝트 ID에 콜론(:)이 포함되어 있으면 도메인 범위 프로젝트를 참조하세요.
  • REPOSITORY은 이미지가 저장된 저장소의 이름입니다.
  • IMAGE은 저장소에 있는 이미지의 이름입니다.
  • TAG는 가져올 이미지 버전의 태그입니다.
  • IMAGE-DIGEST는 이미지 콘텐츠의 sha256 해시 값입니다. Google Cloud Console에서 특정 이미지를 클릭하면 이미지의 메타데이터를 확인할 수 있습니다. 다이제스트는 이미지 다이제스트로 나열됩니다.

    태그 또는 다이제스트를 지정하지 않으면 Artifact Registry가 기본 태그 latest가 있는 이미지를 찾습니다. 버전에 대한 자세한 내용은 컨테이너 이미지 버전을 참조하세요.

예를 들어 다음과 같은 특성을 지닌 이미지라고 가정해 보겠습니다.

  • 저장소 위치: us
  • 저장소 이름: my-repo
  • 프로젝트 ID: my-project
  • 이미지 이름: test
  • 태그: staging

스테이징으로 태그가 지정된 이 이미지 버전은 다음과 같이 지정됩니다.

us-docker.pkg.dev/my-project/my-repo/test:staging

컨테이너 이미지 버전

레지스트리는 여러 컨테이너 이미지를 포함할 수 있으며, 이러한 이미지는 다양한 버전으로 구성될 수 있습니다. 이미지의 특정 버전을 식별하려면 이미지의 태그 또는 다이제스트를 지정하면 됩니다. 태그는 레지스트리 내에서 이미지별로 고유합니다. 다이제스트는 자동으로 생성되고 이미지 버전별로 고유하며 @[IMAGE_DIGEST] 형식입니다. 여기서 [IMAGE_DIGEST]는 이미지 콘텐츠의 sha256 해시 값입니다.

예를 들어 다음과 같은 특성을 지닌 이미지라고 가정해 보겠습니다.

  • 저장소 위치: us
  • 저장소 이름: my-repo
  • 프로젝트 ID: my-project
  • 이미지 이름: test
  • 태그: staging
  • 다이제스트: sha256:4d11e24ba8a615cc85a535daa17b47d3c0219f7eeb2b8208896704ad7f88ae2d

태그를 사용하여 이미지를 식별하려면 다음을 사용합니다.

us-docker.pkg.dev/my-project/my-repo/test:staging

다이제스트로 확인하려면 다음을 사용하세요.

us-docker.pkg.dev/my-project/my-repo/test@sha256:4d11e24ba8a615cc85a535daa17b47d3c0219f7eeb2b8208896704ad7f88ae2d

프로젝트 ID에 콜론(:)이 포함된 경우 아래의 도메인 범위 프로젝트를 참조하세요.

Console에서 이미지 화면의 태그 열에는 이미지의 태그가 나열됩니다. 이미지 다이제스트를 포함한 메타데이터를 확인하려면 이미지의 버전을 클릭하세요.

태그 지정에 대한 자세한 내용은 이미지에 태그 지정을 참조하세요.

도메인 범위 프로젝트

프로젝트 범위가 도메인인 경우 프로젝트 ID의 도메인 이름 뒤에 콜론(:)이 포함됩니다. Docker가 콜론을 처리하는 방법으로 인해 Artifact Registry에서 이미지 다이제스트를 지정할 때 콜론 문자를 슬래시로 바꾸어야 합니다. 다음 형식을 사용하여 이러한 유형의 프로젝트에서 이미지를 식별합니다.

LOCATION-docker.pkg.dev/DOMAIN/PROJECT-ID/REPOSITORY/IMAGE@IMAGE-DIGEST

예를 들어 ID가 example.com:my-project인 프로젝트는 다음 이미지를 포함할 수 있습니다.

us-docker.pkg.dev/example.com/my-project/my-repo/image-name