Le notifiche Pub/Sub ti consentono di monitorare le modifiche ai tuoi repository Docker di Artifact Registry, inclusi i grafici Helm 3 pacchettizzati in formato OCI. Puoi sottoscrivere le applicazioni a queste notifiche per attivare eventi automatici, registrare l'attività del repository o comunicare tra i servizi quando le immagini vengono caricate, taggate o eliminate.
Panoramica
Pub/Sub pubblica messaggi sui tuoi repository in risorse denominate chiamate argomenti. Le applicazioni che si iscrivono agli argomenti Pub/Sub ricevono questi messaggi e notifiche quando lo stato di un repository cambia.
Artifact Registry pubblica messaggi in un argomento denominato gcr per le seguenti modifiche:
- Caricamento di immagini
- Nuovi tag aggiunti alle immagini
- Eliminazione di immagini
Inoltre, puoi configurare ruoli e autorizzazioni per la pubblicazione o la sottoscrizione alle notifiche.
Per ricevere le notifiche, devi:
- Crea un argomento denominato
gcrnel progetto con Artifact Registry. - Crea una sottoscrizione all'argomento.
- Configura la tua applicazione sottoscrittore per ricevere messaggi sulle modifiche al repository.
- Se opportuno, configura le autorizzazioni per controllare l'accesso all'argomento e alla sottoscrizione.
Creazione dell'argomento Artifact Registry
Per creare l'argomento gcr con chiavi di crittografia basate su Google Cloud :
Console
Vai alla pagina degli argomenti Pub/Sub nella console Cloud de Confiance .
Fai clic su Crea argomento.
Inserisci l'ID argomento
gcr.Fai clic su Crea argomento.
gcloud
Esegui questo comando:
gcloud pubsub topics create gcr --project=PROJECT-ID
Sostituisci PROJECT-ID con il tuo ID progetto Cloud de Confiance by S3NS. Se ometti il flag --project, il comando utilizza il progetto corrente.
Per saperne di più sul comando gcloud pubsub topics, consulta la
documentazione di topics.
Per creare l'argomento gcr con crittografia CMEK, consulta le istruzioni di Pub/Sub per la crittografia degli argomenti.
Dopo aver creato l'argomento gcr o aver verificato che esiste, puoi creare una sottoscrizione all'argomento.
Creazione di una sottoscrizione
Dopo aver creato un argomento per le modifiche al repository, puoi configurare una sottoscrizione che utilizzi la consegna push o la consegna pull. Ti consigliamo di utilizzare la distribuzione pull, poiché i sistemi CI/CD possono generare numerose modifiche agli artefatti archiviati e la distribuzione pull è più efficace per un volume elevato di messaggi.
Per creare una sottoscrizione con consegna pull:
Console
Vai alla pagina degli argomenti Pub/Sub nella console Cloud de Confiance .
Fai clic su un argomento del progetto.
Fai clic su Crea sottoscrizione.
Inserisci un nome per la sottoscrizione:
projects/PROJECT/subscriptions/[SUBSCRIPTION-NAME]Lascia Tipo di consegna impostato su Pull.
Fai clic su Crea.
gcloud
Esegui questo comando:
gcloud pubsub subscriptions create SUBSCRIPTION-NAME --topic=gcr
Sostituisci SUBSCRIPTION-NAME con un nome per la sottoscrizione.
Per saperne di più sul comando gcloud pubsub subscriptions, consulta la
documentazione di subscriptions.
Ora hai una sottoscrizione all'argomento gcr. Il passaggio successivo consiste nel configurare le autorizzazioni per le identità che attivano le modifiche nei repository.
Configurazione dell'applicazione sottoscrittore
Dopo aver creato un argomento e una sottoscrizione all'argomento, puoi configurare l'applicazione sottoscrittore, ovvero l'applicazione che riceve i messaggi sulle modifiche ai repository. Le applicazioni dei sottoscrittori eseguono attività come notifiche di un evento, log di sistema e comunicazione tra applicazioni.
Quando un utente del repository esegue il push o l'eliminazione di un'immagine, si verificano i seguenti passaggi:
Il account di servizio Artifact Registry pubblica la modifica nell'argomento
gcr. Il account di servizio è service-PROJECT-NUMBER@gcp-sa-artifactregistry.s3ns-system.iam.gserviceaccount.com, dove PROJECT-NUMBER è il tuo Cloud de Confiance numero di progetto. Il account di servizio Artifact Registry dispone dell'autorizzazionepubsub.topics.publishper impostazione predefinita, in modo da poter pubblicare le modifiche nell'argomento.Se un amministratore ha revocato le autorizzazioni
pubsub.topics.publishper il account di servizio Artifact Registry, Artifact Registry tenta di pubblicare il messaggio come utente del repository. In questo caso, l'account dell'utente del repository deve disporre dell'autorizzazionepubsub.topics.publishper pubblicare correttamente il messaggio.Pub/Sub inoltra il messaggio dall'argomento alla tua sottoscrizione.
Quando l'applicazione sottoscrittore invia una richiesta di messaggi, estrae il nuovo messaggio dalla sottoscrizione.
L'identità che esegue il pull dei messaggi per conto del sottoscrittore deve disporre delle autorizzazioni per accedere alla sottoscrizione. Puoi utilizzare il ruolo Sottoscrittore Pub/Sub per concedere questa autorizzazione.
Per scoprire come configurare un sottoscrittore per ricevere messaggi da una sottoscrizione con distribuzione pull, consulta Ricezione di messaggi tramite pull.
Configurazione delle autorizzazioni
Puoi utilizzare le autorizzazioni Pub/Sub per controllare l'accesso ai tuoi argomenti e alle tue sottoscrizioni.
Per saperne di più sulle autorizzazioni Pub/Sub e sulla concessione dell'accesso ad argomenti e sottoscrizioni, consulta la documentazione sul controllo degli accessi di Pub/Sub.
Esempi di notifiche
Pub/Sub invia notifiche sotto forma di stringhe formattate in JSON. Esamina i seguenti esempi per scoprire cosa aspettarti quando ricevi notifiche di Artifact Registry da Pub/Sub.
Quando viene eseguito il push di un'immagine in Artifact Registry, il payload della notifica potrebbe avere il seguente aspetto:
{
"action":"INSERT",
"digest":"u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/hello-world@sha256:6ec128e26cd5..."
}
Quando viene eseguito il push di un nuovo tag immagine in Artifact Registry, il payload della notifica è simile al seguente:
{
"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"
}
Il messaggio identifica l'immagine pertinente utilizzando una chiave digest o tag.
Quando un tag immagine viene eliminato da Artifact Registry, il payload della notifica potrebbe avere il seguente aspetto:
{
"action":"DELETE",
"tag":"u-france-east1-docker.s3nsregistry.fr/my-project/my-repo/hello-world:1.1"
}
Il messaggio potrebbe contenere DELETE o INSERT come valori per la chiave action.
Passaggi successivi
- Leggi la documentazione di Pub/Sub.
- Per una spiegazione approfondita di Pub/Sub, consulta Che cos'è Pub/Sub?
- Scopri di più sui ruoli di controllo dell'accesso di Pub/Sub.