Mengelola gambar

Halaman ini menjelaskan cara mengelola image container di repositori Docker. Pengelolaan image meliputi mencantumkan image di repositori, menambahkan tag, menghapus tag, menyalin image ke repositori baru, dan menghapus image.

Untuk informasi tentang mendorong dan menarik gambar, lihat Mendorong dan menarik gambar.

Sebelum memulai

1. Jika repositori target tidak ada, buat repositori baru.
2. Pastikan Anda memiliki izin yang diperlukan untuk repositori.
3. (Opsional) Konfigurasi default untuk perintah gcloud.

Peran yang diperlukan

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

• Melihat image, file dalam image, dan tag: Artifact Registry Reader (roles/artifactregistry.reader)
• Beri tag pada image atau edit tag menggunakan Artifact Registry: Artifact Registry Writer (roles/artifactregistry.writer)
• Menghapus image atau menghapus tag: Artifact Registry Repository Administrator (roles/artifactregistry.repoAdmin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

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

Gambar listingan

Mode repositori: standar, jarak jauh

Anda dapat menampilkan daftar image menggunakan Google Cloud Console atau gcloud CLI.

Daftar repositori mencakup repositori Artifact Registry dan Container Registry. Untuk menggunakan image di repositori Container Registry, lihat dokumentasi Container Registry untuk mengelola image.

gcloud artifacts docker images list

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE \
--include-tags

us-docker.pkg.dev/my-project/my-repo

us-docker.pkg.dev/my-project/my-repo/my-image

Membuat listingan file

Mode repositori: standar, jarak jauh

Anda dapat mencantumkan file dalam repositori, file dalam semua versi image container tertentu, atau file dalam versi image tertentu.

Untuk semua perintah berikut, Anda dapat menetapkan jumlah file maksimum yang akan ditampilkan dengan menambahkan flag --limit ke perintah.

Untuk mencantumkan semua file dalam project, repositori, dan lokasi default saat nilai default dikonfigurasi:

gcloud artifacts files list

Untuk menampilkan daftar file dalam project, repositori, dan lokasi yang ditentukan, jalankan perintah:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

Untuk menampilkan daftar file bagi semua versi image container tertentu:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

Untuk mencantumkan file untuk versi image container tertentu:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --tag=TAG

Ganti nilai berikut:

• LOCATION: lokasi regional atau multi-regional repositori.
• PROJECT: project ID Google Cloud Anda. Jika project ID Anda berisi titik dua (:), lihat Project cakupan domain.
• REPOSITORY: nama repositori tempat image disimpan.
• PACKAGE: nama image.
• VERSION: ringkasan gambar, string yang dimulai dengan sha256:.
• TAG: tag yang terkait dengan image penampung.

Contoh

Perhatikan informasi gambar berikut:

• Project: my-project
• Repositori: my-repo
• Lokasi repositori: us-central1
• Image: my-app

Perintah berikut mencantumkan semua file dalam repositori my-repo di lokasi us-central1 dalam project default:

gcloud artifacts files list \
    --location=us-central1 \
    --repository=my-repo

gcloud artifacts files list \
    --project=my-project \
    --location=us-central1 \
    --repository=my-repo \
    --package=my-app \
    --version=sha256:88b205d7995332e10e836514fbfd59ecaf8976fc15060cd66e85cdcebe7fb356

gcloud artifacts files list \
    --project=my-project \
    --location=us-central1 \
    --repository=my-repo \
    --package=my-app \
    --tag=1.0-dev

Memberi tag pada gambar

Anda dapat memberi tag pada image yang ada di repositori Artifact Registry atau memberi tag pada image sebelum mengirimkannya ke repositori.

Memberi tag pada image di repositori

Mode repositori: standar

Anda dapat menambahkan tag ke image di repositori Artifact Registry menggunakan Google Cloud Console atau command line. Di repositori, tag bersifat unik untuk versi suatu image. Jadi, jika Anda memiliki beberapa versi sebuah gambar, setiap tag hanya berlaku untuk salah satu versi. Jika Anda memberi tag pada gambar dengan tag yang sudah digunakan, Anda harus memindahkan tag tersebut dari versi asli ke versi yang baru diberi tag.

gcloud artifacts docker tags add IMAGE-VERSION TAG

gcloud artifacts docker tags add \
us-docker.pkg.dev/my-project/my-repo/my-image:iteration6-final \
us-docker.pkg.dev/my-project/my-repo/my-image:release-candidate

Memberi tag pada gambar lokal

Untuk mengirim image lokal ke Artifact Registry, Anda harus terlebih dahulu memberinya tag dengan nama repositori, lalu mengirim image tersebut. Untuk mengetahui petunjuknya, lihat Mendorong dan menarik.

Membatalkan pemberian tag pada gambar

Mode repositori: standar

Anda dapat menghapus tag dari image di Artifact Registry menggunakan Google Cloud Console atau command line.

 gcloud artifacts docker tags delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG

Menghapus beberapa gambar

Mode repositori: standar, jarak jauh

Anda dapat menghapus seluruh image penampung atau menghapus versi image tertentu yang terkait dengan tag atau ringkasan.

• Setelah menghapus gambar, Anda tidak dapat mengurungkan tindakan tersebut.
• Untuk repositori jarak jauh, salinan gambar yang di-cache akan dihapus. Gambar tetap tersedia dari sumber upstream. Jika repositori jarak jauh menerima permintaan baru untuk image yang sama, repositori akan mendownload dan meng-cache-nya lagi.

Alat lainnya tersedia untuk membantu Anda mengelola gambar yang tidak digunakan. Misalnya, alat gcr-cleaner menemukan dan menghapus gambar lama berdasarkan kriteria yang berbeda. Menghapus gambar yang tidak digunakan dapat membantu Anda mengurangi biaya penyimpanan. Alat gcr-cleaner bukan produk resmi Google.

Untuk menghapus image dari Konsol Google Cloud atau gcloud CLI:

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE --delete-tags

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG [--delete-tags]

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE@IMAGE-DIGEST [--delete-tags]

Langkah selanjutnya

• Download masing-masing file yang tersimpan di dalam image tanpa menggunakan perintah Docker. Hal ini dapat berguna untuk memeriksa file manifes dengan cepat.