Mengelola metadata artefak

Halaman ini menjelaskan cara mengelola metadata yang terkait dengan artefak yang disimpan di Artifact Registry sebagai lampiran.

Lampiran adalah file yang menyimpan metadata tentang artefak terkait yang disimpan di Artifact Registry. Untuk mempelajari cara membuat lampiran, lihat Menyimpan metadata artefak dalam lampiran.

Sebelum memulai

Opsional: Mengonfigurasi setelan default untuk perintah Google Cloud CLI.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola lampiran, minta administrator untuk memberi Anda peran IAM berikut di repositori:

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat daftar lampiran

Artefak di Artifact Registry dapat memiliki berapa pun lampiran yang merujuk ke artefak tersebut. Anda dapat membuat daftar lampiran menggunakan konsol Google Cloud , gcloud CLI, atau, khusus untuk image penampung berformat Docker, Oras.

Konsol (khusus Docker)

  1. Di Google Cloud console, buka halaman Repositories.

    Buka halaman Repositori

  2. Klik nama repositori untuk melihat image di repositori Anda.

  3. Untuk melihat versi gambar, klik nama gambar.

  4. Klik versi gambar yang sesuai.

  5. Untuk melihat lampiran untuk versi tersebut, klik tab Lampiran.

gcloud

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • TARGET: nama versi yang sepenuhnya memenuhi syarat. Khusus untuk image Docker, Anda juga dapat menggunakan URI Artifact Registry dari artefak yang dirujuk oleh lampiran. Dalam URI, Anda dapat menggunakan ringkasan atau, untuk image Docker, tag—misalnya, us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud artifacts attachments list \
    --target=TARGET

Windows (PowerShell)

gcloud artifacts attachments list `
    --target=TARGET

Windows (cmd.exe)

gcloud artifacts attachments list ^
    --target=TARGET
 Untuk informasi selengkapnya, lihat perintah gcloud artifacts attachments list.

Oras (khusus Docker)

Sebelum menjalankan perintah, buat penggantian berikut:

  • IMAGE_URI: URI gambar target yang dirujuk oleh lampiran yang tercantum.
oras discover --distribution-spec v1.1-referrers-api IMAGE_URI

Contoh berikut mencantumkan lampiran untuk image container, my-image, yang diidentifikasi oleh URI dan tag-nya:

oras discover --distribution-spec v1.1-referrers-api \
us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1

Dengan keterangan:

  • v1.1-referrers-api adalah Referrer API yang digunakan. Untuk informasi selengkapnya, lihat detail dalam spesifikasi distribusi.

  • us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1 adalah URI yang menyertakan tag versi image container untuk mencantumkan lampiran.

Untuk panduan lengkap dan contoh lainnya, lihat dokumentasi oras discover.

Menjelaskan lampiran

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • ATTACHMENT: nama lengkap lampiran, seperti projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. Atau, berikan hanya ID lampiran dan gunakan flag --location dan --repository.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud artifacts attachments describe ATTACHMENT

Windows (PowerShell)

gcloud artifacts attachments describe ATTACHMENT

Windows (cmd.exe)

gcloud artifacts attachments describe ATTACHMENT
 Untuk informasi selengkapnya, lihat perintah gcloud artifacts attachments describe.

Mendownload lampiran

Anda dapat mendownload lampiran menggunakan gcloud CLI atau, khusus untuk image penampung berformat Docker, Oras.

gcloud

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • ATTACHMENT: nama lengkap lampiran, seperti projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. Atau, berikan hanya ID lampiran dan gunakan flag --location dan --repository.
  • DESTINATION: jalur di sistem file lokal Anda untuk mendownload lampiran.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud artifacts attachments download ATTACHMENT \
    --destination=DESTINATION

Windows (PowerShell)

gcloud artifacts attachments download ATTACHMENT `
    --destination=DESTINATION

Windows (cmd.exe)

gcloud artifacts attachments download ATTACHMENT ^
    --destination=DESTINATION
 Untuk lampiran dalam repositori berformat Docker, sebagai alternatif untuk menyediakan ATTACHMENT, Anda dapat memberikan tanda --oci-version-name, diikuti dengan nama versi lengkap lampiran atau URI Artifact Registry. Anda dapat menggunakan ringkasan atau tag—misalnya, projects/my-project/locations/us-west1/repositories/my-repo/packages/my-package/versions/sha256:abc123.

Untuk informasi selengkapnya, lihat perintah gcloud artifacts attachments download.

Oras (khusus Docker)

Sebelum menjalankan perintah, buat penggantian berikut:

  • DESTINATION: direktori tujuan untuk lampiran Anda.

  • ATTACHMENT_URI: URI lampiran yang akan didownload. Ini adalah URI untuk penampung gambar yang dirujuk lampiran, diikuti dengan SHA unik lampiran.

oras pull -o DESTINATION ATTACHMENT_URI

Contoh berikut mendownload lampiran yang diidentifikasi oleh URI dan ringkasannya:

oras pull -o . us-west1-docker.pkg.dev/my-project/my-repo/my-image@sha256:xxxx

Dengan keterangan:

  • -o . memberi nama direktori saat ini sebagai tujuan download.

  • us-west1-docker.pkg.dev/my-project/my-repo/my-image@sha256:xxxx adalah URI gambar yang menyertakan ringkasan lampiran yang akan didownload.

Untuk panduan lengkap dan contoh lainnya, lihat dokumentasi oras pull.

Menghapus lampiran

Anda dapat menghapus lampiran secara langsung menggunakan konsol Google Cloud atau gcloud CLI. Anda dapat menghapus lampiran secara tidak langsung dengan menghapus artefak yang dirujuknya.

Menghapus lampiran secara langsung

Anda dapat menghapus lampiran secara langsung dengan salah satu opsi berikut:

Konsol (khusus Docker)

  1. Di Google Cloud console, buka halaman Repositories.

    Buka halaman Repositori

  2. Klik nama repositori untuk melihat image di repositori Anda.

  3. Klik nama gambar untuk melihat versi gambar tersebut.

  4. Klik versi gambar yang ingin Anda lihat lampirannya.

  5. Klik tab Lampiran untuk melihat lampiran untuk versi tersebut.

  6. Klik ringkasan lampiran yang akan dihapus.

  7. Klik HAPUS.

  8. Pada dialog konfirmasi, klik DELETE.

gcloud

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • ATTACHMENT: nama lengkap lampiran, seperti projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. Atau, berikan hanya ID lampiran dan gunakan flag --location dan --repository.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud artifacts attachments delete ATTACHMENT

Windows (PowerShell)

gcloud artifacts attachments delete ATTACHMENT

Windows (cmd.exe)

gcloud artifacts attachments delete ATTACHMENT
 Untuk informasi selengkapnya, lihat perintah gcloud artifacts attachments delete.

Menghapus lampiran secara tidak langsung

Jika artefak dihapus, semua lampiran dengan nama versi artefak yang dihapus sebagai target juga akan dihapus. Hal ini berlaku untuk penghapusan artefak secara manual dan penghapusan yang disebabkan oleh kebijakan pembersihan.

Langkah berikutnya