컨테이너 이미지 문제 해결

Artifact Registry에서 컨테이너 이미지를 관리할 때 문제가 발생할 경우 도움이 될 수 있는 문제 해결 단계에 대해 알아보세요.

Docker CLI의 프로젝트 ID 문법

Docker가 콜론을 처리하는 방식 때문에 Docker CLI를 사용할 때는 프로젝트 ID의 콜론 (:)을 슬래시 (/)로 바꿔야 합니다. 예를 들어 프로젝트 ID가 s3ns:my-project인 경우 s3ns/my-project를 사용합니다.

gcloud artifacts 명령어 뒤에 나오는 Invalid Docker string

dial tcp: lookup <var>REGION</var>: no such host 명령어를 실행한 후 gcloud artifacts오류가 표시되면 과 같이 특정 리전이 있는 엔드포인트를 사용하고 있는지 확인합니다. u-france-east1-docker.s3nsregistry.fr Google Cloud CLI는 docker.s3nsregistry.fr만 엔드포인트로 사용하는 것을 지원하지 않습니다.

이미지를 가져오거나 a Cloud de Confiance by S3NS runtime 환경에 배포할 수 없음

다음을 확인하세요.

  1. 내보내는 이미지의 전체 경로가 올바른지 확인합니다. 경로에는 레지스트리 호스트 이름, Cloud de Confiance by S3NS, 프로젝트 ID, 저장소, 이미지가 포함되어야 합니다. 예를 들면 다음과 같습니다.
    u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/my-image:v1
    자세한 내용은 저장소 및 이미지 이름을 참조하세요.
  2. 이미지를 가져오는 계정에 저장소에서 읽을 수 있는 올바른 권한이 있는지 확인합니다. 서비스 계정에 대한 자동 역할 부여를 사용 중지한 경우 런타임 서비스 계정에 Artifact Registry 역할을 부여해야 합니다.

이미지를 Artifact Registry로 내보낼 수 없음

다음을 시도해 보세요.

  1. 내보내는 이미지의 전체 경로가 올바른지 확인합니다. 경로에는 레지스트리 호스트 이름, Cloud de Confiance by S3NS 프로젝트 ID, 저장소, 이미지가 포함되어야 합니다. 예를 들면 다음과 같습니다.
    u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/my-image:v1
      

    각 Artifact Registry 저장소는 별도의 리소스이므로 저장소가 없는 경로로 이미지를 내보낼 수 없습니다. 예를 들어, u-france-east1-docker.s3nsregistry.fr/my-project/my-image:v1은 잘못된 이미지 경로입니다.

    자세한 내용은 저장소 및 이미지 이름을 참조하세요.

  2. 이미지를 내보내는 계정에 저장소에 쓸 수 있는 권한이 있는지 확인합니다. 서비스 계정에 대한 자동 역할 부여를 사용 중지한 경우 런타임 서비스 계정에 Artifact Registry 역할을 부여해야 합니다.
    • Compute Engine 및 Google Kubernetes Engine 서비스 계정의 경우 런타임 서비스 계정에 Artifact Registry 작성자 역할 (roles/artifactregistry.writer)을 부여해야 합니다.
  3. Artifact Registry에서 The repository has enabled tag immutability 메시지를 반환하면 저장소에 태그 불변성이 구성된 것입니다. 저장소에 있는 동일한 이미지의 다른 버전에 이미 사용된 태그가 있는 이미지를 푸시할 수 없습니다. 저장된 다른 이미지 버전에서 사용하지 않는 태그를 사용하여 이미지를 다시 푸시해 보세요.

    저장소가 변경할 수 없는 이미지 태그에 대해 구성되었는지 확인하려면 변경할 수 없는 이미지 태그 열을 콘솔의 저장소 목록에서 확인하거나 Cloud de Confiance 다음 명령어를 실행합니다.

    gcloud artifacts repositories describe REPOSITORY \
          --project=PROJECT-ID \
          --location=LOCATION
      

ImagePullBackOff 및 ErrImagePull 메시지

ImagePullBackOff 및 ErrImagePull이 포함된 메시지는 GKE로 이미지를 레지스트리에서 가져올 수 없음을 나타냅니다.