Puoi utilizzare Cloud Tasks per accodare in modo sicuro un'attività che verrà elaborata in modo asincrono da un servizio Cloud Run. I casi d'uso tipici includono:
- Conservazione delle richieste a causa di incidenti di produzione imprevisti
- Attenuare i picchi di traffico ritardando le operazioni non rivolte all'utente
- Accelerare i tempi di risposta degli utenti delegando operazioni in background lente da gestire da un altro servizio, ad esempio aggiornamenti del database o elaborazione batch
- Limitare la frequenza di chiamate a servizi di supporto come database e API di terze parti
Questa pagina mostra come accodare le attività di cui è stato eseguito il push in modo sicuro tramite il protocollo HTTPS a un servizio Cloud Run privato. Descrive il comportamento richiesto per il servizio Cloud Run privato, le autorizzazioni richieste dell'account di servizio, la creazione di coda di attività e di attività.
Prima di iniziare
Abilita l'API Cloud Tasks nel progetto in uso.
Deployment di un servizio Cloud Run per gestire le attività
Per eseguire il deployment di un servizio che accetta attività inviate alla coda di attività, esegui il deployment del servizio come qualsiasi altro servizio Cloud Run. Il servizio Cloud Run deve restituire un codice HTTP 200
per confermare l'esito positivo dell'elaborazione dell'attività.
Il push delle attività verrà eseguito a questo servizio Cloud Run come richieste HTTPS da Cloud Tasks.
La risposta a Cloud Tasks deve avvenire entro il relativo timeout configurato. Per carichi di lavoro che devono essere eseguiti più a lungo del timeout massimo di Cloud Tasks, valuta l'utilizzo dei job Cloud Run.
Esegui il deployment con Terraform
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
Per creare un servizio, aggiungi quanto segue al tuo file .tf
:
Creazione di una coda di attività
Riga di comando
Per creare una coda di attività, utilizza il comando
gcloud tasks queues create QUEUE-ID
sostituendo QUEUE-ID con il nome che vuoi assegnare alla coda di attività:
deve essere univoco nel tuo progetto. Se ti viene chiesto di creare un'app App Engine
nel tuo progetto, rispondi y
per crearla. Cloud Tasks utilizza
questo metodo per la coda: assicurati di scegliere la stessa località che utilizzi per
il servizio Cloud Run.
La configurazione predefinita della coda di attività dovrebbe funzionare nella maggior parte dei casi. Tuttavia, se vuoi, puoi impostare limiti di frequenza diversi e provare di nuovo i parametri.
Terraform
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
Per creare una coda di attività, aggiungi quanto segue al file .tf
:
Applica le modifiche inserendo terraform apply
.
Creazione di un account di servizio da associare alle attività
Devi creare un account di servizio che sarà associato alle attività in coda. Questo account di servizio deve avere il ruolo IAM Invoker di Cloud Run per consentire alla coda di attività di eseguire il push delle attività al servizio Cloud Run. .
Console
Nella console Google Cloud, vai alla pagina Account di servizio.
Seleziona un progetto.
Inserisci il nome di un account di servizio da visualizzare nella console Google Cloud.
La console Google Cloud genera un ID account di servizio in base a questo nome. Modifica l'ID, se necessario. Non potrai modificare l'ID in un secondo momento.
(Facoltativo) Inserisci una descrizione dell'account di servizio.
Fai clic su Crea e continua.
(Facoltativo) Fai clic sul campo Seleziona un ruolo.
Seleziona Cloud Run > Invoker di Cloud Run.
Fai clic su Fine.
Riga di comando
Crea l'account di servizio:
gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \ --display-name "DISPLAYED_SERVICE_ACCOUNT_NAME"
Sostituisci
- SERVICE_ACCOUNT_NAME con un nome minuscolo univoco all'interno del progetto Google Cloud, ad esempio
my-invoker-service-account-name
. - DISPLAYED_SERVICE_ACCOUNT_NAME con il nome che vuoi visualizzare per questo account di servizio, ad esempio nella console, ad esempio
My Invoker Service Account
.
- SERVICE_ACCOUNT_NAME con un nome minuscolo univoco all'interno del progetto Google Cloud, ad esempio
Per Cloud Run, concedi al tuo account di servizio l'autorizzazione a richiamare il tuo servizio:
gcloud run services add-iam-policy-binding SERVICE \ --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \ --role=roles/run.invoker
Sostituisci
- SERVICE con il nome del servizio che vuoi richiamare da Cloud Tasks.
- SERVICE_ACCOUNT_NAME con il nome dell'account di servizio.
- PROJECT_ID con il tuo ID progetto Google Cloud.
Concedi al tuo account di servizio l'accesso al progetto in modo che abbia l'autorizzazione per completare azioni specifiche sulle risorse del tuo progetto:
gcloud projects add-iam-policy-binding RESOURCE_ID \ --member=PRINCIPAL --role=roles/run.invoker
Sostituisci
RESOURCE_ID: l'ID del tuo progetto Google Cloud.
PRINCIPAL: un identificatore dell'entità o del membro, che in genere ha il seguente formato: PRINCIPAL_TYPE:ID. Ad esempio,
user:my-user@example.com
. Per un elenco completo dei valori che PRINCIPAL può avere, consulta il riferimento sull'associazione dei criteri.
Terraform
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
Aggiungi quanto segue al tuo file .tf
:
Crea l'account di servizio:
Per Cloud Run, concedi al tuo account di servizio l'autorizzazione per richiamare il servizio:
Applica le modifiche inserendo terraform apply
.
Creazione di attività HTTP con token di autenticazione
Quando crei un'attività da inviare alla coda di attività, specifichi il progetto, la posizione, il nome della coda, l'email dell'account di servizio creato in precedenza da associare alle attività, l'URL del servizio Cloud Run privato che eseguirà l'attività e tutti gli altri dati che devi inviare. Puoi scegliere di applicare come hardcoded questi valori, anche se valori come l'ID progetto, la località e l'email dell'account di servizio possono essere recuperati dinamicamente dal server di metadati Cloud Run.
Per maggiori dettagli sul corpo della richiesta dell'attività, consulta la documentazione dell'API Cloud Tasks.
Tieni presente che le richieste che contengono payload di dati devono utilizzare il metodo HTTP PUT
o POST
.
Il codice che accoda le attività deve disporre delle autorizzazioni IAM necessarie per farlo, ad esempio il ruolo di In coda in Cloud Tasks. Il codice avrà le autorizzazioni IAM necessarie se utilizzi l'account di servizio predefinito su Cloud Run.
Gli esempi seguenti creano richieste di attività che includono anche la creazione di un token di intestazione. Negli esempi vengono utilizzati i token OIDC. Per utilizzare un token OAuth, sostituisci il parametro OIDC con il parametro OAuth appropriato per la lingua nella creazione della richiesta.
Python
Prendi nota del file requirements.txt
:
Java
Prendi nota del file pom.xml
:
Go
Node.js
Prendi nota del file package.json
:
Passaggi successivi
- Logging e visualizzazione dei log
- Monitoraggio dell'integrità e delle prestazioni
- Attivazione da Pub/Sub
- Richiamare con HTTPS
- Esecuzione di servizi in base a una pianificazione