Questo tutorial mostra come scrivere, eseguire il deployment e chiamare un servizio Cloud Run da una sottoscrizione push Pub/Sub.
Obiettivi
- Scrivi, crea ed esegui il deployment di un servizio in Cloud Run
- Chiama il servizio pubblicando un messaggio in un argomento Pub/Sub.
Costi
In questo documento vengono utilizzati i seguenti componenti fatturabili di Google Cloud:
Per generare una stima dei costi in base all'utilizzo previsto,
utilizza il Calcolatore prezzi.
Prima di iniziare
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Abilita le API Artifact Registry, Cloud Build, Pub/Sub and Cloud Run.
- Installa e inizializza gcloud CLI.
- Aggiorna componenti:
gcloud components update
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per completare il tutorial, chiedi all'amministratore di concederti i seguenti ruoli IAM sul tuo progetto:
-
Editor Cloud Build (
roles/cloudbuild.builds.editor
) -
Amministratore Cloud Run (
roles/run.admin
) -
Crea account di servizio (
roles/iam.serviceAccountCreator
) -
Amministratore IAM progetto (
roles/resourcemanager.projectIamAdmin
) -
Editor Pub/Sub (
roles/pubsub.editor
) -
Utente account di servizio (
roles/iam.serviceAccountUser
) -
Service Usage Consumer (
roles/serviceusage.serviceUsageConsumer
) -
Amministratore Storage (
roles/storage.admin
)
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Configura le impostazioni predefinite di gcloud
Per configurare gcloud con i valori predefiniti per il tuo servizio Cloud Run:
Imposta il progetto predefinito:
gcloud config set project PROJECT_ID
Sostituisci PROJECT_ID con il nome del progetto che hai creato per questo tutorial.
Configura gcloud per la regione scelta:
gcloud config set run/region REGION
Sostituisci REGION con un'area geografica Cloud Run supportata a tua scelta.
Località di Cloud Run
Cloud Run è regionale, il che significa che l'infrastruttura che esegue i tuoi servizi Cloud Run si trova in una regione specifica ed è gestita da Google per essere disponibile in modo ridondante in tutte le zone all'interno di quella regione.
Soddisfare i requisiti di latenza, disponibilità o durabilità sono fattori principali per selezionare la regione in cui vengono eseguiti i servizi Cloud Run.
In genere, puoi selezionare la regione più vicina ai tuoi utenti, ma ti consigliamo di considerare la località degli altri prodotti Google Cloud utilizzati dal tuo servizio Cloud Run.
L'utilizzo combinato di prodotti Google Cloud in più località può influire
sulla latenza e sui costi del tuo servizio.
Cloud Run è disponibile nelle seguenti regioni:
Soggetto ai prezzi di Livello 1
asia-east1
(Taiwan)asia-northeast1
(Tokyo)asia-northeast2
(Osaka)europe-north1
(Finlandia) A basse emissioni di CO2europe-southwest1
(Madrid)europe-west1
(Belgio) A basse emissioni di CO2europe-west4
(Paesi Bassi)europe-west8
(Milano)europe-west9
(Parigi) A basse emissioni di CO2me-west1
(Tel Aviv)us-central1
(Iowa) A basse emissioni di CO2us-east1
(Carolina del Sud)us-east4
(Virginia del Nord)us-east5
(Colombo)us-south1
(Dallas)us-west1
(Oregon) A basse emissioni di CO2
Soggetto ai prezzi di Livello 2
africa-south1
(Johannesburg)asia-east2
(Hong Kong)asia-northeast3
(Seul, Corea del Sud)asia-southeast1
(Singapore)asia-southeast2
(Giacarta)asia-south1
(Mumbai, India)asia-south2
(Delhi, India)australia-southeast1
(Sydney)australia-southeast2
(Melbourne)europe-central2
(Varsavia, Polonia)europe-west10
(Berlino)europe-west12
(Torino)europe-west2
(Londra, Regno Unito) A basse emissioni di CO2europe-west3
(Francoforte, Germania) A basse emissioni di CO2europe-west6
(Zurigo, Svizzera) A basse emissioni di CO2me-central1
(Doha)me-central2
(Dammam)northamerica-northeast1
(Montreal) A basse emissioni di CO2northamerica-northeast2
(Toronto) A basse emissioni di CO2southamerica-east1
(San Paolo, Brasile) A basse emissioni di CO2southamerica-west1
(Santiago, Cile) A basse emissioni di CO2us-west2
(Los Angeles)us-west3
(Salt Lake City)us-west4
(Las Vegas)
Se hai già creato un servizio Cloud Run, puoi visualizzare la regione nella dashboard di Cloud Run nella console Google Cloud.
Crea un repository standard Artifact Registry
Crea un repository standard Artifact Registry per archiviare l'immagine container:
gcloud artifacts repositories create REPOSITORY \ --repository-format=docker \ --location=REGION
Sostituisci:
- REPOSITORY con un nome univoco per il repository.
- REGION con la regione Google Cloud da utilizzare per il repository Artifact Registry.
crea un argomento Pub/Sub
Il servizio di esempio viene attivato dai messaggi pubblicati in un argomento Pub/Sub, quindi dovrai creare un argomento in Pub/Sub.
Riga di comando
Per creare un nuovo argomento Pub/Sub, utilizza il comando:
gcloud pubsub topics create myRunTopic
Puoi utilizzare myRunTopic o sostituirlo con un nome dell'argomento univoco all'interno del tuo progetto Google Cloud.
Terraform
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
Per creare un argomento Pub/Sub, aggiungi quanto segue al file main.tf
esistente:
Puoi utilizzare un nome dell'argomento univoco all'interno del tuo progetto Cloud.
Recupera l'esempio di codice
Per recuperare l'esempio di codice da utilizzare:
Clona il repository dell'app di esempio sulla tua macchina locale:
Node.js
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.
Python
git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.
Go
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.
Java
git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.
C#
git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples.git
In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.
Passa alla directory che contiene il codice di esempio di Cloud Run:
Node.js
cd nodejs-docs-samples/run/pubsub/
Python
cd python-docs-samples/run/pubsub/
Go
cd golang-samples/run/pubsub/
Java
cd java-docs-samples/run/pubsub/
C#
cd dotnet-docs-samples/run/pubsub/
Rivedi il codice
Il codice di questo tutorial è costituito dai seguenti elementi:
Un server che gestisce le richieste in entrata.
Node.js
Per semplificare i test del servizio Node.js, la configurazione del server è separata da quella dell'avvio del server.
Il server web Node.js è configurato in
app.js
.Il server web è avviato in
index.js
:Python
Go
Java
C#
Gestore che elabora il messaggio Pub/Sub e registra un saluto.
Node.js
Python
Go
Java
C#
Devi programmare il servizio in modo che restituisca un codice di risposta HTTP accurato. I codici riusciti, come HTTP
200
o204
, confermano l'elaborazione completa del messaggio Pub/Sub. I codici di errore, come HTTP400
o500
, indicano che sarà possibile riprovare a visualizzare il messaggio, come descritto nella sezione Ricezione di messaggi con la guida per le notifiche push.Un
Dockerfile
che definisce l'ambiente operativo per il servizio. I contenuti delDockerfile
variano in base alla lingua.Node.js
Python
Go
Java
Questo esempio utilizza Jib per creare immagini Docker con gli strumenti Java comuni. Jib ottimizza le build di container senza bisogno di un Dockerfile o di dover installare Docker. Scopri di più sulla creazione di container Java con Jib.
C#
Per maggiori dettagli su come autenticare l'origine delle richieste Pub/Sub, consulta Integrare con Pub/Sub.
Spedisci il codice
Il codice di spedizione prevede tre passaggi: creazione di un'immagine container con Cloud Build, caricamento dell'immagine del container su Artifact Registry e deployment dell'immagine del container in Cloud Run.
Per spedire il tuo codice:
-
Crea il tuo container e pubblicalo su Artifact Registry:
Node.js
gcloud builds submit --tag REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/pubsub
Sostituisci:- PROJECT_ID con il tuo ID progetto Google Cloud.
- REPOSITORY con il nome del repository Artifact Registry.
- REGION con la regione Google Cloud da utilizzare per il repository Artifact Registry.
pubsub
è il nome dell'immagine.Se l'operazione va a buon fine, dovresti visualizzare un messaggio di operazione riuscita contenente l'ID, l'ora di creazione e il nome dell'immagine. L'immagine è archiviata in Artifact Registry e può essere riutilizzata, se necessario.
Python
gcloud builds submit --tag REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/pubsub
Sostituisci:- PROJECT_ID con il tuo ID progetto Google Cloud.
- REPOSITORY con il nome del repository Artifact Registry.
- REGION con la regione Google Cloud da utilizzare per il repository Artifact Registry.
pubsub
è il nome dell'immagine.Se l'operazione va a buon fine, dovresti visualizzare un messaggio di operazione riuscita contenente l'ID, l'ora di creazione e il nome dell'immagine. L'immagine è archiviata in Artifact Registry e può essere riutilizzata, se necessario.
Go
gcloud builds submit --tag REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/pubsub
Sostituisci:- PROJECT_ID con il tuo ID progetto Google Cloud.
- REPOSITORY con il nome del repository Artifact Registry.
- REGION con la regione Google Cloud da utilizzare per il repository Artifact Registry.
pubsub
è il nome dell'immagine.Se l'operazione va a buon fine, dovresti visualizzare un messaggio SUCCESSIVO contenente l'ID, l'ora di creazione e il nome dell'immagine. L'immagine è archiviata in Artifact Registry e può essere riutilizzata, se necessario.
Java
-
Utilizza l'helper per le credenziali dell'interfaccia a riga di comando gcloud per autorizzare Docker a eseguire il push al tuo Artifact Registry.
gcloud auth configure-docker
-
Utilizza il plug-in Maven per Jib per creare il container ed eseguirne il push in Artifact Registry.
mvn compile jib:build -D image=REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/pubsub
Sostituisci:- PROJECT_ID con il tuo ID progetto Google Cloud.
- REPOSITORY con il nome del repository Artifact Registry.
- REGION con la regione Google Cloud da utilizzare per il repository Artifact Registry.
pubsub
è il nome dell'immagine.Se l'operazione ha esito positivo, dovresti visualizzare il messaggio COSTRUIRE RIUSCITA. L'immagine è archiviata in Artifact Registry e, se necessario, può essere riutilizzata.
C#
gcloud builds submit --tag REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/pubsub
Sostituisci:- PROJECT_ID con il tuo ID progetto Google Cloud.
- REPOSITORY con il nome del repository Artifact Registry.
- REGION con la regione Google Cloud da utilizzare per il repository Artifact Registry.
pubsub
è il nome dell'immagine.Se l'operazione va a buon fine, dovresti visualizzare un messaggio di operazione riuscita contenente l'ID, l'ora di creazione e il nome dell'immagine. L'immagine è archiviata in Artifact Registry e può essere riutilizzata, se necessario.
-
Esegui il deployment dell'applicazione:
Riga di comando
-
Esegui questo comando per eseguire il deployment della tua app:
gcloud run deploy pubsub-tutorial --image REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/pubsub --no-allow-unauthenticated
Sostituisci:- PROJECT_ID con il tuo ID progetto Google Cloud.
- REPOSITORY con il nome del repository Artifact Registry.
- REGION con la regione Google Cloud da utilizzare per il repository Artifact Registry.
pubsub
è il nome dell'immagine epubsub-tutorial
è il nome del servizio. Tieni presente che il deployment dell'immagine container viene eseguito nel servizio e nella regione che hai configurato in precedenza in Configurazione di gcloudIl flag
--no-allow-unauthenticated
limita l'accesso non autenticato al servizio. Mantenendo privato il servizio puoi fare affidamento sull'integrazione automatica di Pub/Sub di Cloud Run per autenticare le richieste. Consulta Eseguire l'integrazione con Pub/Sub per maggiori dettagli sulla configurazione. Per maggiori dettagli sull'autenticazione basata su Identity and Access Management (IAM), consulta Gestire l'accesso utilizzando IAM.Attendi il completamento del deployment: questa operazione può richiedere circa mezzo minuto. Se l'operazione riesce, la riga di comando visualizza l'URL del servizio. Questo URL viene utilizzato per configurare una sottoscrizione Pub/Sub.
-
Se vuoi eseguire il deployment di un aggiornamento del codice nel servizio, ripeti i passaggi precedenti. Ogni deployment in un servizio crea una nuova revisione e inizia automaticamente a gestire il traffico quando è pronto.
Terraform
Per creare un servizio Cloud Run, aggiungi quanto segue al file
.tf
esistente.Sostituisci il valore di
image
con l'URL dell'immagine:REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/pubsub
. -
Integrazione con Pub/Sub
Per integrare il servizio con Pub/Sub:
Riga di comando
Crea o seleziona un account di servizio per rappresentare l'identità della sottoscrizione Pub/Sub.
gcloud iam service-accounts create cloud-run-pubsub-invoker \ --display-name "Cloud Run Pub/Sub Invoker"
Puoi utilizzare
cloud-run-pubsub-invoker
o sostituirlo con un nome univoco all'interno del tuo progetto Google Cloud.Crea una sottoscrizione Pub/Sub con l'account di servizio:
Concedi all'account di servizio del richiamo l'autorizzazione per richiamare il tuo servizio
pubsub-tutorial
:gcloud run services add-iam-policy-binding pubsub-tutorial \ --member=serviceAccount:cloud-run-pubsub-invoker@PROJECT_ID.iam.gserviceaccount.com \ --role=roles/run.invoker
La propagazione delle modifiche IAM può richiedere diversi minuti. Nel frattempo, potresti vedere errori
HTTP 403
nei log di servizio.Consenti a Pub/Sub di creare token di autenticazione nel tuo progetto:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-pubsub.iam.gserviceaccount.com \ --role=roles/iam.serviceAccountTokenCreator
Sostituisci:
- PROJECT_ID con il tuo ID progetto Google Cloud.
- PROJECT_NUMBER con il numero di progetto Google Cloud.
L'ID e il numero del progetto sono elencati nel riquadro Informazioni sul progetto della console Google Cloud per il tuo progetto.
Crea una sottoscrizione Pub/Sub con l'account di servizio:
gcloud pubsub subscriptions create myRunSubscription --topic myRunTopic \ --ack-deadline=600 \ --push-endpoint=SERVICE-URL/ \ --push-auth-service-account=cloud-run-pubsub-invoker@PROJECT_ID.iam.gserviceaccount.com
Sostituisci:
- myRunTopic con l'argomento creato in precedenza.
- SERVICE-URL con l'URL HTTPS fornito al momento del deployment del servizio. Questo URL funziona anche se hai aggiunto un mapping di dominio.
- PROJECT_ID con il tuo ID progetto Google Cloud.
Il flag
--push-auth-service-account
attiva la funzionalità push di Pub/Sub per Autenticazione e autorizzazione.Il tuo dominio di servizio Cloud Run viene registrato automaticamente per essere utilizzato con gli abbonamenti Pub/Sub.
Solo per Cloud Run, è presente un controllo di autenticazione integrato che il token sia valido e un controllo dell'autorizzazione per verificare che l'account di servizio disponga dell'autorizzazione per richiamare il servizio Cloud Run.
Il servizio è ora completamente integrato con Pub/Sub.
Terraform
Crea o seleziona un account di servizio per rappresentare l'identità della sottoscrizione Pub/Sub.
Crea una sottoscrizione Pub/Sub con l'account di servizio:
Concedi all'account di servizio del richiamo l'autorizzazione per richiamare il tuo servizio
pubsub-tutorial
:Consenti a Pub/Sub di creare token di autenticazione nel tuo progetto:
Crea una sottoscrizione Pub/Sub con l'account di servizio:
Il servizio è ora completamente integrato con Pub/Sub.
Fai una prova
Per testare la soluzione end-to-end:
Invia un messaggio Pub/Sub all'argomento:
gcloud pubsub topics publish myRunTopic --message "Runner"
Puoi anche pubblicare i messaggi in modo programmatico invece di utilizzare la riga di comando, come mostrato in questo tutorial. Per maggiori informazioni, consulta la sezione Pubblicazione di messaggi.
Passa ai log del servizio:
- Vai alla console Google Cloud.
- Fai clic sul servizio
pubsub-tutorial
. Seleziona la scheda Log.
La visualizzazione dei log potrebbe richiedere qualche istante. Se non li vedi immediatamente, ricontrolla dopo qualche istante.
Cerca il messaggio "Hello Runner!".
Esegui la pulizia
Per informazioni più dettagliate sull'utilizzo di Cloud Run con Pub/Sub, salta la pulizia per il momento e continua con il tutorial sull'elaborazione delle immagini con Cloud Run.
Se hai creato un nuovo progetto per questo tutorial, elimina il progetto. Se hai utilizzato un progetto esistente e vuoi conservarlo senza le modifiche aggiunte in questo tutorial, elimina le risorse create per il tutorial.
Elimina il progetto
Il modo più semplice per eliminare la fatturazione è eliminare il progetto che hai creato per il tutorial.
Per eliminare il progetto:
- Nella console Google Cloud, vai alla pagina Gestisci risorse.
- Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
- Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.
Eliminazione delle risorse del tutorial
Elimina il servizio Cloud Run di cui hai eseguito il deployment in questo tutorial:
gcloud run services delete SERVICE-NAME
Dove SERVICE-NAME è il nome del servizio che hai scelto.
Puoi anche eliminare i servizi Cloud Run dalla console Google Cloud.
Rimuovi la configurazione della regione predefinita di gcloud aggiunta durante la configurazione del tutorial:
gcloud config unset run/region
Rimuovi la configurazione del progetto:
gcloud config unset project
Elimina le altre risorse Google Cloud create in questo tutorial:
- Elimina l'argomento Pub/Sub
myRunTopic
- Elimina la sottoscrizione Pub/Sub
myRunSubscription
- Elimina l'immagine container denominata
REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/pubsub
da Artifact Registry. - Elimina l'account di servizio callback
cloud-run-pubsub-invoker@PROJECT_ID.iam.gserviceaccount.com
- Elimina l'argomento Pub/Sub
Passaggi successivi
- Consulta Limitazione del traffico in entrata per informazioni su come aumentare la sicurezza in produzione utilizzando i controlli interni in entrata per limitare il traffico in entrata.
- Espandi il servizio di esempio di cui è stato eseguito il deployment in questo tutorial per aggiungere funzionalità di elaborazione delle immagini che modifica le immagini caricate in Cloud Storage.
- Scopri di più su come gli argomenti si inseriscono nell'architettura Pub/Sub e su come gestire gli argomenti
- Scopri di più sulle sottoscrizioni Pub/Sub nella pagina relativa alla gestione degli abbonamenti.
- Esplora le architetture di riferimento, i diagrammi e le best practice su Google Cloud. Visita il nostro Cloud Architecture Center.