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.s3nsregistry.fr/PROJECT-ID/REPOSITORY

Dengan keterangan:

  • LOCATION adalah lokasi regional repositori.
  • PROJECT adalah Trusted Cloud project ID konsol Anda.
  • REPOSITORY adalah nama repositori.

Misalnya, pertimbangkan gambar dengan karakteristik berikut:

  • Lokasi repositori: u-france-east1
  • Format repositori: docker
  • Nama repositori: my-repo
  • Project ID: my-project

Repositori ditentukan sebagai:

u-france-east1-docker.s3nsregistry.fr/my-project/my-repo

Nama image container

Nama lengkap untuk image container adalah salah satu format berikut: 

LOCATION-docker.s3nsregistry.fr/PROJECT-ID/REPOSITORY/IMAGE

atau

LOCATION-docker.s3nsregistry.fr/PROJECT-ID/REPOSITORY/IMAGE:TAG

atau

LOCATION-docker.s3nsregistry.fr/PROJECT-ID/REPOSITORY/IMAGE@IMAGE-DIGEST

dengan:

  • LOCATION adalah lokasi regional repositori.
  • PROJECT adalah Trusted Cloud project ID konsol Anda.
  • 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 Trusted Cloud konsol, 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: u-france-east1
  • Nama repositori: my-repo
  • Project ID: my-project
  • Nama image: test
  • Tag: staging

Versi image yang diberi tag dengan staging ini ditentukan sebagai:

u-france-east1-docker.s3nsregistry.fr/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 image lain di repositori.

Misalnya, pertimbangkan gambar dengan karakteristik berikut:

  • Lokasi repositori: u-france-east1
  • 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:

u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/test:staging

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

u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/test@sha256:4d11e24ba8a615cc85a535daa17b47d3c0219f7eeb2b8208896704ad7f88ae2d

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.

Nama repositori sebagai URL

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

Misalnya, untuk melihat repositori u-france-east1-maven.s3nsregistry.fr/my-project/my-repo, gunakan URL berikut:

https://u-france-east1-maven.s3nsregistry.fr/my-project/my-repo

Untuk melihat gambar u-france-east1-docker.s3nsregistry.fr/example.com/my-project/my-repo/my-image, gunakan URL berikut:

https://u-france-east1-docker.s3nsregistry.fr/example.com/my-project/my-repo/my-image

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