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 defaultlatest
. 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
ataudevelopment
. 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 tagv1.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.