Pemecahan masalah umum

Pelajari langkah-langkah pemecahan masalah yang berlaku untuk semua format artefak saat bekerja dengan 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 nama repositori atau lokasi repositori yang 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 untuk perintah tertentu, jalankan perintah dengan flag --help.

Setelan repositori default tidak berlaku untuk perintah gcloud artifacts saat 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 masih gagal, Anda mungkin perlu memverifikasi bahwa Anda telah menentukan nilai yang valid untuk repositori atau lokasi.

Lokasi repositori

Untuk menampilkan daftar 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 waktu pembuatan repositori. Artifact Registry tidak menerapkan kebijakan secara retroaktif pada repositori yang dibuat sebelum pembatasan lokasi.

Nama repositori dalam perintah gcloud

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

Untuk mencantumkan semua repositori dalam project, jalankan perintah:

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

Untuk menampilkan semua repositori di lokasi, jalankan perintah:

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

Ganti PROJECT-ID dengan project ID Google Cloud 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-managed 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 detail penggunaan dan konfigurasi klien, lihat dokumentasi untuk format yang Anda gunakan.

Jika Anda bertransisi 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 tidak dihapus

Repositori tidak lagi berfungsi dengan benar setelah Anda membatalkan penghapusan project Google Cloudatau mengaktifkan Artifact Registry API setelah menonaktifkannya.

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

Pelajari lebih lanjut penghapusan data di Google Cloud.