Artifact Registry 작업 시 모든 아티팩트 형식에 적용되는 문제 해결 단계를 알아봅니다. 아티팩트 형식 관련 문제는 형식별 페이지를 참조하세요.
잘못된 명령어의 저장소 또는 위치
다음 정보를 사용하여 잘못된 저장소 위치 또는 잘못된 저장소 이름 오류를 진단할 수 있습니다.
gcloud의 위치 및 저장소 기본값
gcloud artifacts 명령어에서 --location 및 --repository 플래그를 생략할 수 있도록 Google Cloud CLI에서 기본 저장소 및 위치를 설정한 경우, 플래그 및 해당 값으로 실패한 명령어를 실행해 봅니다. 특정 명령어의 구문에 대한 자세한 내용을 보려면 --help 플래그와 함께 명령어를 실행하세요.
--repository 플래그 없이 저장소 이름을 지정하는 gcloud artifacts 명령어에는 기본 저장소 설정이 적용되지 않습니다. 예를 들어 다음 예시와 같이 gcloud artifact repositories describe 명령어에 저장소 이름을 지정해야 합니다.
gcloud artifacts repositories describe my-repo --location=us-west1
명령어가 계속 실패하면 저장소 또는 위치에 유효한 값을 지정했는지 확인해야 할 수 있습니다.
저장소 위치
지원되는 Artifact Registry 위치를 모두 나열하려면 다음 명령어를 실행합니다.
gcloud artifacts locations list
조직 정책에 위치 제한이 포함될 수 있습니다. Artifact Registry는 저장소 생성 시 이러한 제한을 적용합니다. Artifact Registry는 위치 제한 이전의 저장소에 정책을 소급 적용하지 않습니다.
gcloud 명령어의 저장소 이름
저장소를 나열하여 지정된 프로젝트 또는 위치에 있는 저장소 이름을 볼 수 있습니다.
프로젝트의 모든 저장소를 나열하려면 다음 명령어를 실행합니다.
gcloud artifacts repositories list --project=PROJECT-ID \
--location=all
특정 위치의 모든 저장소를 나열하려면 다음 명령어를 실행합니다.
gcloud artifacts repositories list --project=PROJECT-ID \
--location=LOCATION
PROJECT-ID를 Google Cloud 프로젝트 ID로 바꾸고 LOCATION을 저장소 위치로 바꿉니다.
이 명령어는 다음 예시와 비슷한 각 저장소의 정보를 반환합니다.
REPOSITORY: my-repo
FORMAT: MAVEN
DESCRIPTION:
LOCATION: us-east1
LABELS:
ENCRYPTION: Google-managed key
CREATE_TIME: 2021-09-23T19:39:10
UPDATE_TIME: 2021-09-23T19:39:10
REPOSITORY 값은 저장소 이름을 매개변수로 포함하는 gcloud artifacts 명령어와 함께 사용하는 값입니다.
예를 들어 이 명령어는 --repository 플래그를 사용합니다.
gcloud artifacts packages list --location=us-east1 --repository=my-repo
이 명령어는 플래그 없이 저장소 이름만 사용합니다.
gcloud artifacts repositories describe my-repo --location=us-west1
타사 클라이언트가 있는 저장소 이름
타사 클라이언트의 경우 일반적으로 us-east1-docker.pkg.dev/my-project/my-repo와 같이 클라이언트를 구성할 때 전체 저장소 경로를 사용합니다. 그런 다음 패키지를 업로드하고 다운로드하는 클라이언트의 규칙을 따릅니다. 클라이언트 구성 및 사용량 세부정보는 작업 중인 형식에 대한 문서를 참조하세요.
Container Registry에서 전환하는 경우 모든 이미지 경로에 Artifact Registry 저장소 이름이 포함되어야 합니다. 프로젝트 ID만 포함된 이미지 경로는 지정할 수 없습니다.
- 잘못된 경로:
us-east1-docker.pkg.dev/my-project/my-image - 유효한 경로:
us-east1-docker.pkg.dev/my-project/my-repo/my-image
삭제 취소된 저장소를 푸시하거나 가져올 수 없음
Google Cloud 프로젝트를 삭제 취소하거나 Artifact Registry API를 사용 중지한 후 사용 설정하면 저장소가 더 이상 제대로 작동하지 않습니다.
Artifact Registry API를 사용 중지하거나 프로젝트를 삭제하면 Artifact Registry 서비스를 사용할 수 없습니다. Artifact Registry는 7일이 지나면 저장소 데이터를 삭제합니다.