Pemecahan masalah umum

Pelajari langkah-langkah pemecahan masalah yang berlaku untuk semua format artefak saat menggunakan Artifact Registry. Untuk masalah khusus format artefak, lihat halaman khusus format.

Repositori atau lokasi tidak valid dalam perintah

Gunakan informasi berikut untuk membantu Anda mendiagnosis error lokasi repositori tidak valid atau nama repositori tidak valid.

Default lokasi dan repositori untuk gcloud

Jika Anda menetapkan repositori dan lokasi default di Google Cloud CLI sehingga Anda dapat menghilangkan flag --location dan --repository dari perintah gcloud artifacts, coba jalankan perintah yang gagal dengan flag dan nilai yang sesuai. Untuk mengetahui detail tentang sintaksis perintah tertentu, jalankan perintah dengan flag --help.

Setelan repositori default tidak berlaku untuk perintah gcloud artifacts jika Anda menentukan nama repositori tanpa tanda --repository. Misalnya, Anda harus menentukan nama repositori dalam perintah gcloud artifacts repositories describe seperti contoh berikut:

gcloud artifacts repositories describe my-repo --location=us-west1

Jika perintah Anda masih gagal, Anda mungkin perlu memverifikasi bahwa Anda menentukan nilai yang valid untuk repositori atau lokasi.

Lokasi repositori

Untuk mencantumkan semua lokasi Artifact Registry yang didukung, jalankan perintah:

gcloud artifacts locations list

Kebijakan organisasi Anda mungkin menyertakan pembatasan lokasi. Artifact Registry menerapkan batasan ini pada saat pembuatan repositori. Artifact Registry tidak menerapkan kebijakan secara retroaktif pada repositori yang ada sebelum pembatasan lokasi.

Nama repositori dalam perintah gcloud

Anda dapat mencantumkan repositori untuk melihat nama repositori dalam project atau lokasi tertentu.

Untuk mencantumkan semua repositori dalam project, jalankan perintah:

gcloud artifacts repositories list --project=PROJECT-ID \
    --location=all

Untuk mencantumkan semua repositori di suatu lokasi, jalankan perintah:

gcloud artifacts repositories list --project=PROJECT-ID \
    --location=LOCATION

Ganti PROJECT-ID dengan project ID Google Cloud Anda dan LOCATION dengan lokasi repositori.

Perintah ini menampilkan informasi untuk setiap repositori yang mirip dengan contoh berikut:

REPOSITORY: my-repo
FORMAT: DOCKER
DESCRIPTION:
LOCATION: us-west1
LABELS:
ENCRYPTION: Google-owned and Google-managed encryption key
CREATE_TIME: 2021-09-23T19:39:10
UPDATE_TIME: 2021-09-23T19:39:10

Nilai untuk REPOSITORY adalah nilai yang Anda gunakan dengan perintah gcloud artifacts yang menyertakan nama repositori sebagai parameter.

Misalnya, perintah ini menggunakan flag --repository:

gcloud artifacts packages list --location=us-west1 --repository=my-repo

Perintah ini hanya menggunakan nama repositori tanpa flag:

gcloud artifacts repositories describe my-repo --location=us-west1

Nama repositori dengan klien pihak ketiga

Untuk klien pihak ketiga, Anda umumnya menggunakan jalur repositori lengkap saat mengonfigurasi klien, seperti us-west1-docker.pkg.dev/my-project/my-repo. Kemudian, Anda mengikuti konvensi klien untuk mengupload dan mendownload paket. Untuk mengetahui detail konfigurasi dan penggunaan klien, lihat dokumentasi untuk format yang Anda gunakan.

Jika Anda beralih dari Container Registry, perhatikan bahwa semua jalur image harus menyertakan nama repositori Artifact Registry. Anda tidak dapat menentukan jalur gambar yang hanya menyertakan project ID.

  • Jalur tidak valid: us-east1-docker.pkg.dev/my-project/my-image
  • Jalur yang valid: us-east1-docker.pkg.dev/my-project/my-repo/my-image

Tidak dapat melakukan push atau pull dari repositori yang belum dihapus

Repositori tidak lagi berfungsi dengan benar setelah Anda mengurungkan penghapusan project Google Cloud atau mengaktifkan Artifact Registry API setelah menonaktifkannya.

Jika Anda menonaktifkan Artifact Registry API atau menghapus project, layanan Artifact Registry akan menjadi tidak tersedia. Artifact Registry menghapus data repositori setelah 7 hari.

Pelajari lebih lanjut penghapusan data di Google Cloud.

Error saat menarik file bantuan Prometheus untuk Cloud Run dalam perimeter layanan

Anda menggunakan Artifact Registry dengan Kontrol Layanan VPC dan Anda mencoba menarik image file bantuan Prometheus untuk Cloud Run dalam perimeter layanan. Anda menerima error 403 permission denied.

Untuk mengatasi masalah ini, izinkan egress ke project cloud-ops-agents-artifacts dalam aturan egress yang Anda konfigurasi untuk menggunakan mirror.gcr.io di perimeter layanan Anda. Untuk melakukannya, tambahkan projects/1042947621568 sebagai resource dalam aturan keluar Anda.