Questo tutorial mostra come utilizzare Cloud Tasks all'interno di un'applicazione App Engine per attivare una Cloud Function e inviare un'email programmata.
Obiettivi
- Comprendi il codice di ciascuno dei componenti.
- Creare un account SendGrid.
- Scaricare il codice sorgente.
- Esegui il deployment di una Cloud Function per ricevere richieste Cloud Tasks e inviare un'email tramite l'API SendGrid.
- Creare una coda di Cloud Tasks.
- Crea un account di servizio per autenticare le richieste Cloud Tasks.
- Esegui il deployment del codice client che consente a un utente di inviare email.
Costi
Cloud Tasks, Cloud Functions e App Engine hanno un livello gratuito, quindi, finché il tutorial viene eseguito nel livello gratuito dei prodotti in questione, non dovrebbe comportare costi aggiuntivi. Per ulteriori informazioni, vedi Prezzi.
Prima di iniziare
Seleziona o crea un progetto Google Cloud.
Inizializza un'applicazione App Engine nel tuo progetto:
Nella pagina Welcome to App Engine, fai clic su Create Application (Crea applicazione).
Seleziona una regione per la tua applicazione. Questa località fungerà da parametro
LOCATION_ID
per le richieste Cloud Tasks, quindi prendine nota. Tieni presente che due località, denominate europe-west e us-central nei comandi App Engine, sono chiamate, rispettivamente, europe-west1 e us-central1 nei comandi Cloud Tasks.Seleziona Node.js per la lingua e Standard per l'ambiente.
Se viene visualizzato il popup Abilita fatturazione, seleziona il tuo account di fatturazione. Se al momento non hai un account di fatturazione, fai clic su Crea account di fatturazione e segui la procedura guidata.
Nella pagina Inizia, fai clic su Avanti. Ce ne occuperai in seguito.
Abilitare le API Cloud Functions e Cloud Tasks.
Installa e inizializza gcloud CLI.
Nozioni di base sul codice
Questa sezione illustra il codice dell'app e il suo funzionamento.
Creazione dell'attività
La pagina dell'indice viene pubblicata utilizzando gestori in app.yaml
. Le variabili necessarie per la creazione dell'attività vengono passate come variabili di ambiente.
Questo codice crea l'endpoint /send-email
. Questo endpoint gestisce gli invii dei moduli dalla pagina dell'indice e li passa al codice per la creazione dell'attività.
Questo codice crea effettivamente l'attività e la invia alla coda di Cloud Tasks. Il codice crea l'attività in base a:
Specificando il tipo di target su
HTTP Request
.Specificare il valore
HTTP method
da utilizzare e il valoreURL
del target.Impostare l'intestazione
Content-Type
suapplication/json
in modo che le applicazioni downstream possano analizzare il payload strutturato.Aggiunta di un indirizzo email dell'account di servizio in modo che Cloud Tasks possa fornire le credenziali alla destinazione della richiesta, che richiede l'autenticazione. L'account di servizio viene creato separatamente.
Verifica che l'input utente per la data non superi i 30 giorni massimi e aggiungi il valore alla richiesta come campo
scheduleTime
.
Creazione dell'email
Questo codice crea la Cloud Function che è la destinazione della richiesta Cloud Tasks. Utilizza il corpo della richiesta per creare un'email e inviarla tramite l'API SendGrid.
Preparazione dell'applicazione
Configurazione di SendGrid
Creare un account SendGrid.
- Puoi farlo manualmente tramite il sito web di SendGrid
- In alternativa, puoi utilizzare Google Cloud Launcher, che creerà un account per te e integrerà la fatturazione. Vedi Creazione di un account SendGrid utilizzando Cloud Launcher.
Crea una chiave API SendGrid:
Accedi al tuo account SendGrid.
Nel menu di navigazione a sinistra, apri Settings (Impostazioni) e fai clic su API Keys (Chiavi API).
Fai clic su Crea chiave API e seleziona l'accesso limitato. Sotto l'intestazione Mail Send, seleziona Accesso completo.
Copia la chiave API quando viene visualizzata (la vedrai solo una volta, assicurati di incollarla dove vuoi per poterla usare in seguito).
Download del codice sorgente
Clona il repository dell'app di esempio sulla tua macchina locale:
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
Passa alla directory che contiene il codice di esempio:
cd cloud-tasks/
Deployment della Cloud Function
Vai alla directory
function/
:cd function/
Esegui il deployment della funzione:
gcloud functions deploy sendEmail --runtime nodejs14 --trigger-http \ --no-allow-unauthenticated \ --set-env-vars SENDGRID_API_KEY=SENDGRID_API_KEY \
Sostituisci
SENDGRID_API_KEY
con la tua chiave API.Questo comando utilizza i flag:
--trigger-http
per specificare il tipo di trigger di Cloud Functions.--no-allow-unauthenticated
per specificare la chiamata della funzione richiede l'autenticazione.--set-env-var
per impostare le credenziali SendGrid
Imposta controllo dell'accesso per la funzione in modo da consentire solo gli utenti autenticati.
Seleziona la funzione
sendEmail
nell'interfaccia utente di Cloud Functions.Se non vedi le informazioni sulle autorizzazioni per
sendEmail
, fai clic su MOSTRA RIQUADRO INFORMAZIONI nell'angolo in alto a destra.Fai clic sul pulsante Aggiungi entità in alto.
Imposta Nuove entità su
allAuthenticatedUsers
.Imposta il Ruolo.
- Funzioni di prima generazione (1ª generazione): imposta il ruolo su
Cloud Function Invoker
- Funzioni di seconda generazione (2ª generazione): imposta il ruolo su
Cloud Run Invoker
- Funzioni di prima generazione (1ª generazione): imposta il ruolo su
Fai clic su SALVA.
Creazione di una coda di Cloud Tasks
Crea una coda utilizzando il seguente comando
gcloud
:gcloud tasks queues create my-queue --location=LOCATION
Sostituisci
LOCATION
con la località preferita per la coda, ad esempious-west2
. Se non specifichi la località, gcloud CLI sceglie il valore predefinito.Verifica che la creazione sia andata a buon fine:
gcloud tasks queues describe my-queue --location=LOCATION
Sostituisci
LOCATION
con la posizione della coda.
Creazione di un account di servizio
La richiesta Cloud Tasks deve fornire le credenziali nell'intestazione Authorization
affinché la Cloud Function possa autenticare la richiesta. Questo account di servizio consente a Cloud Tasks di creare e aggiungere un token OIDC a questo scopo.
Nell'interfaccia utente degli account di servizio, fai clic su +CREA ACCOUNT DI SERVIZIO.
Aggiungi un nome dell'account di servizio(nome descrittivo) e seleziona Crea.
Imposta il Ruolo e fai clic su Continua.
- Funzioni di prima generazione (1ª generazione): imposta il ruolo su
Cloud Function Invoker
- Funzioni di seconda generazione (2ª generazione): imposta il ruolo su
Cloud Run Invoker
- Funzioni di prima generazione (1ª generazione): imposta il ruolo su
Seleziona Fine.
Deployment dell'endpoint e del creatore dell'attività in App Engine
Vai alla directory
app/
:cd ../app/
Aggiorna le variabili in
app.yaml
con i tuoi valori:Per trovare la posizione della coda, utilizza il seguente comando:
gcloud tasks queues describe my-queue --location=LOCATION
Sostituisci
LOCATION
con la posizione della coda.Per trovare l'URL della funzione, utilizza il seguente comando:
gcloud functions describe sendEmail
Esegui il deployment dell'applicazione nell'ambiente standard di App Engine utilizzando questo comando:
gcloud app deploy
Apri l'applicazione per inviare una cartolina come email:
gcloud app browse
Esegui la pulizia
Al termine del tutorial, puoi eseguire la pulizia delle risorse che hai creato in modo che smettano di utilizzare la quota e smettano di essere addebitati. Le sezioni seguenti descrivono come eliminare o disattivare queste risorse.
Eliminazione delle risorse
Puoi eseguire la pulizia delle risorse che hai creato su Google Cloud in modo che non occupino quota e non ti vengano addebitati costi in futuro. Le sezioni seguenti descrivono come eliminare o disattivare queste risorse.
Elimina la Cloud Function
Vai alla pagina Cloud Functions nella console Google Cloud.
Fai clic sulle caselle di controllo accanto alle funzioni.
Fai clic sul pulsante Elimina nella parte superiore della pagina e conferma l'eliminazione.
Elimina la coda di Cloud Tasks
Apri la pagina delle code di Cloud Tasks nella console.
Seleziona il nome della coda da eliminare e fai clic su Elimina coda.
Conferma l'azione.
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.
Passaggi successivi
- Scopri di più sulla creazione di attività di destinazione HTTP.
- Scopri di più sulla configurazione della coda di Cloud Tasks.