이미지 관리

이 페이지에서는 Docker 저장소에서 컨테이너 이미지를 관리하는 방법을 설명합니다. 저장소에 이미지 나열, 태그 추가, 태그 삭제, 새 저장소에 이미지 복사, 이미지 삭제 등이 대표적인 이미지 관리 작업입니다.

이미지 가져오기 및 내보내기에 대한 자세한 내용은 이미지 가져오기 및 내보내기를 참조하세요.

시작하기 전에

1. 대상 저장소가 없으면 새 저장소를 만듭니다.
2. 저장소에 대해 필요한 권한이 있는지 확인합니다.
3. (선택사항) gcloud 명령어의 기본값을 구성합니다.

필요한 역할

이미지를 관리하는 데 필요한 권한을 얻으려면 관리자에게 저장소에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

• 이미지, 이미지의 파일, 태그 보기: Artifact Registry 리더 (roles/artifactregistry.reader)
• Artifact Registry를 사용하여 이미지에 태그 지정 또는 태그 수정: Artifact Registry 작성자 (roles/artifactregistry.writer)
• 이미지 삭제 또는 태그 삭제: Artifact Registry 저장소 관리자 (roles/artifactregistry.repoAdmin)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

이미지 나열

저장소 모드: 표준, 원격

Google Cloud console 또는 gcloud CLI를 사용하여 이미지를 나열할 수 있습니다.

gcloud artifacts docker images list

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE \
--include-tags

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

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

파일 나열

저장소 모드: 표준, 원격

저장소의 파일, 지정된 컨테이너 이미지의 모든 버전에 있는 파일, 이미지의 특정 버전에 있는 파일을 나열할 수 있습니다.

다음 모든 명령어에 대해 --limit 플래그를 명령어에 추가하여 반환할 최대 파일 수를 설정할 수 있습니다.

기본값이 구성된 경우 기본 프로젝트, 저장소, 위치의 모든 파일을 나열하려면 다음 명령어를 실행합니다.

gcloud artifacts files list

지정된 프로젝트, 저장소, 위치의 파일을 나열하려면 다음 명령어를 실행합니다.

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

특정 컨테이너 이미지의 모든 버전에 대한 파일을 나열하려면 다음 명령어를 실행합니다.

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

특정 컨테이너 이미지 버전의 파일을 나열하려면 다음 명령어를 실행합니다.

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --tag=TAG

다음 값을 바꿉니다.

• LOCATION: 저장소의 리전 또는 멀티 리전 위치입니다.
• PROJECT: Google Cloud 프로젝트 ID 프로젝트 ID에 콜론 (:)이 포함되어 있으면 도메인 범위 프로젝트를 참고하세요.
• REPOSITORY: 이미지가 저장된 저장소의 이름입니다.
• PACKAGE: 이미지의 이름입니다.
• VERSION: sha256:으로 시작하는 문자열인 이미지 다이제스트입니다.
• TAG: 컨테이너 이미지와 연결된 태그입니다.

예시

다음 이미지 정보를 살펴보세요.

• 프로젝트: my-project
• 저장소: my-repo
• 저장소 위치: us-west1
• 이미지: my-app

다음 명령어는 기본 프로젝트 내의 us-west1 위치에 있는 my-repo 저장소의 모든 파일을 나열합니다.

gcloud artifacts files list \
    --location=us-west1 \
    --repository=my-repo

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --version=sha256:88b205d7995332e10e836514fbfd59ecaf8976fc15060cd66e85cdcebe7fb356

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --tag=1.0-dev

이미지에 태그 지정

Artifact Registry 저장소의 기존 이미지에 태그를 지정하거나 이미지를 저장소로 내보내기 전에 태그를 지정할 수 있습니다.

저장소의 이미지 태그 지정

저장소 모드: 표준

Google Cloud console 또는 명령줄을 사용하여 Artifact Registry 저장소의 이미지에 태그를 추가할 수 있습니다. 저장소에서 태그는 이미지 버전별로 고유합니다. 따라서 한 이미지의 버전이 여러 개라면, 각 태그는 하나의 버전에만 적용됩니다. 이미지에 이미 사용 중인 태그를 지정하면, 태그는 원래 버전에서 새로 태그가 지정된 버전으로 이동합니다.