Nama repositori dan image

Artifact Registry menggunakan konvensi penamaan untuk mengidentifikasi repositori dan image saat Anda menggunakan perintah API, gcloud, dan docker untuk berinteraksi dengan repositori.

Repositori Docker

Nama lengkap untuk repositori docker menggunakan format berikut:

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY

Dengan keterangan:

  • LOCATION adalah lokasi regional atau multi-regional repositori.
  • PROJECT adalah project ID Konsol Google Cloud Anda. Jika project ID Anda berisi titik dua (:), lihat Project cakupan domain.
  • REPOSITORY adalah nama repositori.

Misalnya, pertimbangkan gambar dengan karakteristik berikut:

  • Lokasi repositori: us-west1
  • Format repositori: docker
  • Nama repositori: my-repo
  • Project ID: my-project

Repositori ditentukan sebagai:

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

Nama image container

Nama lengkap untuk image container adalah salah satu format berikut: 

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE

atau

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE:TAG

atau

LOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY/IMAGE@IMAGE-DIGEST

dengan:

  • LOCATION adalah lokasi regional atau multi-regional repositori.
  • PROJECT adalah project ID Konsol Google Cloud Anda. Jika project ID Anda berisi titik dua (:), lihat Project cakupan domain.
  • REPOSITORY adalah nama repositori tempat gambar disimpan.
  • IMAGE adalah nama image di repositori.
  • TAG adalah tag untuk versi image yang ingin Anda tarik.
  • IMAGE-DIGEST adalah nilai hash sha256 dari konten gambar. Di konsol Google Cloud, klik gambar tertentu untuk melihat metadata-nya. Ringkasan tercantum sebagai Ringkasan image. Jika Anda tidak menentukan tag atau ringkasan, Artifact Registry akan mencari image dengan tag default latest. Lihat Versi image container untuk mengetahui informasi tentang versi.

Misalnya, pertimbangkan gambar dengan karakteristik berikut:

  • Lokasi repositori: us-west1
  • Nama repositori: my-repo
  • Project ID: my-project
  • Nama image: test
  • Tag: staging

Versi image yang diberi tag dengan staging ini ditentukan sebagai:

us-west1-docker.pkg.dev/my-project/my-repo/test:staging

Versi image container

Repositori dapat berisi banyak image container, dan image ini dapat memiliki versi yang berbeda. Untuk mengidentifikasi versi image tertentu, Anda dapat menentukan ringkasan atau tag image.

Ringkasan
Ringkasan image adalah hash yang dibuat secara otomatis dari indeks image atau manifes image. Setiap ringkasan image adalah ID unik untuk versi image dan tidak dapat diubah. Ringkasan adalah nilai hash sha256 dari konten gambar.
Tag

Tag gambar adalah label dan sering kali berupa string yang dapat dibaca manusia seperti v1.1 atau development. Tag hanya dapat mengarah ke satu versi gambar. Di Artifact Registry, Anda dapat mengonfigurasi repositori Docker untuk mengizinkan tag image yang dapat diubah atau menerapkan tag image yang tidak dapat diubah.

  • Dapat diubah: Tag hanya mengarah ke satu versi gambar, tetapi ringkasan tertentu yang dirujuknya dapat berubah.

    Pendekatan umum adalah memberi tag pada image dengan ID versi, seperti v1.1 pada waktu build. Saat build mendorong beberapa versi image ke registry dengan tag v1.1 yang sama, tag tersebut akan mereferensikan ringkasan versi terakhir yang didorong ke registry. Meskipun tag gambar yang dapat diubah memberikan cara yang mudah untuk memberi label pada versi, tag tersebut juga dapat dimanipulasi oleh pelaku jahat untuk mengaitkan tag dengan versi gambar berbahaya.

  • Tidak dapat diubah: Di repositori, tag selalu mengarah ke ringkasan gambar yang sama. Jika repositori Artifact Registry dikonfigurasi untuk tag gambar yang tidak dapat diubah, tindakan berikut tidak diizinkan:

    • Menghapus gambar yang diberi tag. Penghapusan gambar yang tidak diberi tag masih diizinkan.
    • Menghapus tag dari gambar.
    • Mendorong image dengan tag yang sudah digunakan oleh versi lain image di repositori.

Misalnya, pertimbangkan gambar dengan karakteristik berikut:

  • Lokasi repositori: us-west1
  • Nama repositori: my-repo
  • Project ID: my-project
  • Nama image: test
  • Tag: staging
  • Ringkasan: sha256:4d11e24ba8a615cc85a535daa17b47d3c0219f7eeb2b8208896704ad7f88ae2d

Untuk mengidentifikasi gambar dengan tag, tambahkan :staging ke nama gambar:

us-west1-docker.pkg.dev/my-project/my-repo/test:staging

Untuk mengidentifikasinya dengan ringkasan, tambahkan @ ke nama image, diikuti dengan ringkasan:

us-west1-docker.pkg.dev/my-project/my-repo/test@sha256:4d11e24ba8a615cc85a535daa17b47d3c0219f7eeb2b8208896704ad7f88ae2d
Jika project ID Anda berisi titik dua (:), lihat Project cakupan domain.

Di konsol, pada layar Images, kolom Tags mencantumkan tag gambar. Klik versi gambar untuk melihat metadata, termasuk Ringkasan gambar.

Lihat Memberi Tag pada Gambar untuk mengetahui informasi selengkapnya tentang pemberian tag.

Project cakupan domain

Jika project Anda dicakup ke domain, project ID akan menyertakan nama domain diikuti dengan titik dua (:). Karena cara Docker memperlakukan titik dua, Anda harus mengganti karakter titik dua dengan garis miring ketika menentukan ringkasan image di Artifact Registry. Identifikasi gambar dalam jenis project ini menggunakan format berikut:

LOCATION-docker.pkg.dev/DOMAIN/PROJECT-ID/REPOSITORY/IMAGE@IMAGE-DIGEST

Misalnya, project dengan ID example.com:my-project dapat memiliki gambar berikut:

us-west1-docker.pkg.dev/example.com/my-project/my-repo/image-name

Nama repositori sebagai URL

Untuk mengakses repositori atau artefak di repositori di konsol Google Cloud, tambahkan https:// ke nama lengkapnya.

Misalnya, untuk melihat repositori us-west1-maven.pkg.dev/my-project/my-repo, gunakan URL berikut:

https://us-west1-maven.pkg.dev/my-project/my-repo

Untuk melihat gambar us-west1-docker.pkg.dev/example.com/my-project/my-repo/my-image, gunakan URL berikut:

https://us-west1-docker.pkg.dev/example.com/my-project/my-repo/my-image

Setiap pengguna terautentikasi yang memiliki izin untuk mengakses repositori dapat menggunakan link ini.