Notifikasi Pub/Sub memungkinkan Anda melacak perubahan pada repositori Docker Artifact Registry, termasuk chart Helm 3 yang dipaketkan dalam format OCI. Anda dapat membuat aplikasi berlangganan notifikasi ini untuk memicu peristiwa otomatis, mencatat aktivitas repositori, atau berkomunikasi antar-layanan saat image diupload, diberi tag, atau dihapus.
Ringkasan
Pub/Sub memublikasikan pesan tentang repositori Anda ke resource bernama yang disebut topik. Aplikasi yang berlangganan ke topik Pub/Sub akan menerima pesan ini dan menerima notifikasi saat status repositori berubah.
Artifact Registry memublikasikan pesan dalam topik bernama gcr untuk
perubahan berikut:
- Upload gambar
- Tag baru ditambahkan ke gambar
- Penghapusan image
Selain itu, Anda dapat mengonfigurasi peran dan izin untuk memublikasikan atau berlangganan notifikasi.
Untuk menerima notifikasi, Anda harus:
- Buat topik bernama
gcrdi project dengan Artifact Registry. - Buat langganan ke topik.
- Siapkan aplikasi pelanggan Anda untuk menerima pesan tentang perubahan repositori.
- Jika perlu, konfigurasikan izin untuk mengontrol akses ke topik dan langganan Anda.
Membuat topik Artifact Registry
Untuk membuat topik gcr dengan kunci enkripsi yang dimiliki dan dikelola Google :
Konsol
Buka halaman topik Pub/Sub di konsol Cloud de Confiance .
Klik Buat Topik.
Masukkan ID topik
gcr.Klik Buat Topik.
gcloud
Jalankan perintah berikut:
gcloud pubsub topics create gcr --project=PROJECT-ID
Ganti PROJECT-ID dengan project ID Cloud de Confiance by S3NS
Anda. Jika Anda menghapus flag --project, perintah akan menggunakan project saat ini.
Untuk mempelajari perintah gcloud pubsub topics lebih lanjut, lihat
dokumentasi topics.
Untuk membuat topik gcr dengan enkripsi CMEK, lihat petunjuk untuk mengenkripsi topik Pub/Sub.
Setelah membuat topik gcr atau memverifikasi bahwa topik tersebut ada, Anda dapat
membuat langganan ke topik tersebut.
Membuat langganan
Setelah membuat topik untuk perubahan repositori, Anda dapat mengonfigurasi langganan ke topik tersebut yang menggunakan pengiriman push atau pengiriman pull. Sebaiknya gunakan pengiriman pull karena sistem CI/CD dapat menghasilkan banyak perubahan pada artefak yang disimpan, dan pengiriman pull lebih efektif untuk pesan dalam jumlah besar.
Untuk membuat langganan dengan pengiriman pull:
Konsol
Buka halaman topik Pub/Sub di konsol Cloud de Confiance .
Klik topik project Anda.
Klik Create Subscription.
Masukkan nama langganan:
projects/PROJECT/subscriptions/[SUBSCRIPTION-NAME]Biarkan Delivery Type ditetapkan ke Pull.
Klik Create.
gcloud
Jalankan perintah berikut:
gcloud pubsub subscriptions create SUBSCRIPTION-NAME --topic=gcr
Ganti SUBSCRIPTION-NAME dengan nama untuk langganan
Untuk mempelajari perintah gcloud pubsub subscriptions lebih lanjut, lihat
dokumentasi subscriptions.
Sekarang Anda berlangganan ke topik gcr. Langkah berikutnya adalah
mengonfigurasi izin untuk identitas yang memicu perubahan
dalam repositori.
Mengonfigurasi aplikasi pelanggan Anda
Setelah membuat topik dan langganan ke topik tersebut, Anda dapat menyiapkan aplikasi pelanggan, yaitu aplikasi yang menerima pesan tentang perubahan pada repositori. Aplikasi pelanggan memenuhi tugas seperti notifikasi peristiwa, logging sistem, dan komunikasi antar-aplikasi.
Saat pengguna repositori mengirim atau menghapus image, langkah-langkah berikut akan terjadi:
Akun layanan Artifact Registry memublikasikan perubahan ke topik
gcrAnda. Akun layanan tersebut adalah service-PROJECT-NUMBER@gcp-sa-artifactregistry.s3ns-system.iam.gserviceaccount.com, dengan PROJECT-NUMBER adalah Cloud de Confiance nomor project Anda. Akun layanan Artifact Registry memiliki izinpubsub.topics.publishsecara default sehingga dapat memublikasikan perubahan ke topik Anda.Jika administrator telah mencabut izin
pubsub.topics.publishuntuk akun layanan Artifact Registry, Artifact Registry akan mencoba memublikasikan pesan sebagai pengguna repositori. Dalam situasi ini, akun pengguna repositori harus memiliki izinpubsub.topics.publishagar berhasil memublikasikan pesan.Pub/Sub meneruskan pesan dari topik ke langganan Anda.
Saat aplikasi pelanggan Anda membuat permintaan pesan, aplikasi tersebut akan mengambil pesan baru dari langganan.
Identitas yang mengambil pesan atas nama pelanggan harus memiliki izin untuk mengakses langganan. Anda dapat menggunakan peran Subscriber Pub/Sub untuk memberikan izin ini.
Untuk mempelajari cara menyiapkan pelanggan untuk menerima pesan dari langganan dengan pengiriman pull, lihat Menerima pesan menggunakan Pull.
Mengonfigurasi izin
Anda dapat menggunakan izin Pub/Sub untuk mengontrol akses ke topik dan langganan Anda.
Untuk mengetahui informasi selengkapnya tentang izin Pub/Sub dan memberikan akses ke topik dan langganan, lihat dokumentasi kontrol akses Pub/Sub.
Contoh notifikasi
Pub/Sub mengirimkan notifikasi sebagai string berformat JSON. Tinjau contoh berikut untuk mempelajari hal yang akan terjadi saat menerima notifikasi Artifact Registry dari Pub/Sub.
Saat image dikirim ke Artifact Registry, payload notifikasi mungkin terlihat seperti ini:
{
"action":"INSERT",
"digest":"u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/hello-world@sha256:6ec128e26cd5..."
}
Saat tag image baru dikirim ke Artifact Registry, payload notifikasi akan terlihat seperti ini:
{
"action":"INSERT",
"digest":"u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/hello-world@sha256:6ec128e26cd5...",
"tag":"u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/hello-world:1.1"
}
Pesan mengidentifikasi gambar yang relevan menggunakan kunci digest atau tag.
Saat tag image dihapus dari Artifact Registry, payload notifikasi mungkin terlihat seperti ini:
{
"action":"DELETE",
"tag":"u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/hello-world:1.1"
}
Pesan mungkin berisi DELETE atau INSERT sebagai nilai untuk kunci action.
Langkah berikutnya
- Baca dokumentasi Pub/Sub.
- Untuk penjelasan mendalam tentang Pub/Sub, lihat Apa itu Pub/Sub?
- Pelajari lebih lanjut peran kontrol akses Pub/Sub.