Questo tutorial mostra come utilizzare le funzioni Cloud Scheduler e Cloud Run per avviare e arrestare automaticamente le istanze Compute Engine secondo una pianificazione regolare utilizzando le etichette delle risorse.
Obiettivi
- Scrivi ed esegui il deployment di un insieme di funzioni con le funzioni Cloud Run che avviano e fermano le istanze Compute Engine.
- Crea un insieme di job con Cloud Scheduler che pianificano istanze con un'etichetta della risorsa
dev
per l'esecuzione dalle 09:00 alle 17:00, dal lunedì al venerdì, in modo da corrispondere all'orario di apertura tipico.
Costi
In questo documento utilizzi i seguenti componenti fatturabili di Google Cloud:
- Cloud Scheduler
- Cloud Run functions
- Pub/Sub
- Compute Engine
Per generare una stima dei costi in base all'utilizzo previsto,
utilizza il Calcolatore prezzi.
Prima di iniziare
- Configura l'ambiente per Cloud Scheduler.
-
Enable the Cloud Run functions, Pub/Sub, and Compute Engine APIs.
Architettura dell'applicazione
Questa soluzione include i seguenti componenti Google Cloud:
- Istanze Compute Engine che vogliamo eseguire in base a una pianificazione.
- Funzioni Cloud Run per avviare e arrestare l'istanza che vogliamo pianificare.
- Messaggi Pub/Sub inviati e ricevuti per ogni evento di inizio e arresto.
- Job Cloud Scheduler per effettuare chiamate in base a una pianificazione impostata per avviare e arrestare l'istanza.
Requisiti per le località
Alcuni componenti sono supportati solo in determinate regioni:
- Istanze Compute Engine: supportate in qualsiasi regione elencata in Regioni e zone.
- Funzioni Cloud Run: supportate nelle regioni elencate in Località.
- Messaggi Pub/Sub: supportati a livello globale poiché Pub/Sub è un servizio globale.
- Job Cloud Scheduler con target Pub/Sub: supportati in qualsiasi posizione Google Cloud.
Perché non HTTP anziché Pub/Sub?
Ti consigliamo di semplificare questa architettura utilizzando i trigger HTTP delle funzioni Cloud Run anziché i trigger Pub/Sub.
Questo tutorial utilizza Pub/Sub come attivatore delle funzioni Cloud Run perché in precedenza questo metodo era più sicuro dell'utilizzo di HTTP. Tuttavia, anche HTTP è una scelta valida e ora può essere reso sicuro richiedendo l'autenticazione.
Per informazioni sulla protezione delle funzioni Cloud Run, consulta la panoramica della sicurezza di Cloud Run Functions. Per un confronto tra gli trigger HTTP e Pub/Sub, consulta la documentazione relativa agli trigger delle funzioni Cloud Run.
Configura l'istanza Compute Engine
Console
- Vai alla pagina Istanze VM nella console Google Cloud.
Vai alla pagina Istanze VM. - Fai clic su Crea istanza.
- Imposta Nome su
dev-instance
. - In Etichette, fai clic su Aggiungi etichette.
- Fai clic su Aggiungi etichetta.
- Inserisci
env
per Chiave edev
per Valore. - In Regione, seleziona us-west1.
- In Zona, seleziona us-west1-b.
- Fai clic su Salva.
- Fai clic su Crea nella parte inferiore della pagina.
gcloud
gcloud compute instances create dev-instance \ --network default \ --zone us-west1-b \ --labels=env=dev
Esegui il deployment di funzioni attivate da Pub/Sub tramite le funzioni Cloud Run
Crea ed esegui il deployment delle funzioni
Console
Crea la funzione di avvio.
- Vai alla pagina Funzioni Cloud Run nella console Google Cloud.
Vai alla pagina Funzioni Cloud Run. - Fai clic su Crea funzione.
- Per Ambiente, seleziona 1ª generazione.
- Imposta Nome funzione su
startInstancePubSub
. - Lascia invariato il valore predefinito per Regione.
- Per Tipo di trigger, seleziona Cloud Pub/Sub.
- In Seleziona un argomento Cloud Pub/Sub, fai clic su Crea un argomento.
- Dovrebbe apparire una finestra di dialogo Crea argomento.
- In ID argomento, inserisci
start-instance-event
. - Fai clic su Crea per chiudere la finestra di dialogo.
- In ID argomento, inserisci
- Fai clic su Salva nella parte inferiore della casella Attivazione.
- Fai clic su Avanti nella parte inferiore della pagina.
- Per Runtime, seleziona Node.js 16 o versioni successive.
- In Punto di ingresso, inserisci
startInstancePubSub
. - Sul lato sinistro dell'editor di codice, seleziona index.js.
Sostituisci il codice di avvio con il seguente codice:
Sul lato sinistro dell'editor di codice, seleziona package.json.
Sostituisci il codice di avvio con il seguente codice:
Fai clic su Esegui il deployment nella parte inferiore della pagina.
Crea la funzione di arresto.
- Dovresti trovarti nella pagina Funzioni Cloud Run della console Google Cloud.
- Fai clic su Crea funzione.
- Per Ambiente, seleziona 1ª generazione.
- Imposta Nome funzione su
stopInstancePubSub
. - Lascia invariato il valore predefinito per Regione.
- Per Tipo di trigger, seleziona Cloud Pub/Sub.
- In Seleziona un argomento Cloud Pub/Sub, fai clic su Crea un argomento.
- Dovrebbe apparire una finestra di dialogo Crea argomento.
- In ID argomento, inserisci
stop-instance-event
. - Fai clic su Crea per chiudere la finestra di dialogo.
- In ID argomento, inserisci
- Fai clic su Salva nella parte inferiore della casella Attivazione.
- Fai clic su Avanti nella parte inferiore della pagina.
- Per Runtime, seleziona Node.js 16 o versioni successive.
- In Punto di ingresso, inserisci
stopInstancePubSub
. - Sul lato sinistro dell'editor di codice, seleziona index.js.
Sostituisci il codice di avvio con il seguente codice:
Sul lato sinistro dell'editor di codice, seleziona package.json.
Sostituisci il codice di avvio con il seguente codice:
Fai clic su Esegui il deployment nella parte inferiore della pagina.
gcloud
Crea gli argomenti Pub/Sub.
gcloud pubsub topics create start-instance-event
gcloud pubsub topics create stop-instance-event
Ottieni il codice
Scarica il codice.
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.
Vai alla directory corretta.
cd nodejs-docs-samples/functions/scheduleinstance/
Crea le funzioni di avvio e arresto.
Dovresti trovarti nella directory nodejs-docs-samples/functions/scheduleinstance/
.
gcloud functions deploy startInstancePubSub \ --trigger-topic start-instance-event \ --runtime nodejs18 \ --allow-unauthenticated
gcloud functions deploy stopInstancePubSub \ --trigger-topic stop-instance-event \ --runtime nodejs18 \ --allow-unauthenticated
(Facoltativo) Verifica il funzionamento delle funzioni
Console
Arresta l'istanza
- Vai alla pagina Funzioni Cloud Run nella console Google Cloud.
Vai alla pagina Funzioni Cloud Run. - Fai clic sulla funzione denominata
stopInstancePubSub
. - Dovresti vedere una serie di schede: Generale, Attivatore, Origine, Autorizzazioni e Test. Fai clic sulla scheda Test.
In Evento di attivazione, inserisci quanto segue:
{"data":"eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo="}
Si tratta semplicemente della stringa con codifica base64 per
{"zone":"us-west1-b", "label":"env=dev"}
Se vuoi codificare la tua stringa, puoi utilizzare qualsiasi strumento di codifica base64 online.
Fai clic sul pulsante Testa la funzione.
Al termine dell'esecuzione, dovresti vedere
Successfully stopped instance dev-instance
stampato in Output. Il completamento dell'esecuzione potrebbe richiedere fino a 60 secondi.Se invece vedi
error: 'Error: function failed to load.'
, aspetta circa 10 secondi per il completamento del deployment della funzione e riprova.Se invece vedi
error: 'Error: function execution attempt timed out.'
, vai al passaggio successivo per verificare se l'arresto dell'istanza sta richiedendo molto tempo.Se invece termina l'esecuzione, ma non mostra nulla, è probabile che anche il timeout sia terminato. Vai al passaggio successivo per verificare se l'arresto dell'istanza richiede molto tempo.
Vai alla pagina Istanze VM nella console Google Cloud.
Vai alla pagina Istanze VM.Verifica che l'istanza denominata
dev-instance
abbia un quadrato grigio accanto al nome, a indicare che è stata interrotta. Potrebbero essere necessari fino a 30 secondi per completare l'arresto.- Se non sembra terminare, prova a fare clic su Aggiorna nella parte superiore della pagina.
Avvia l'istanza
- Vai alla pagina Funzioni Cloud Run nella console Google Cloud.
Vai alla pagina Funzioni Cloud Run. - Fai clic sulla funzione denominata
startInstancePubSub
. - Dovresti vedere una serie di schede: Generale, Attivatore, Origine, Autorizzazioni e Test. Fai clic sulla scheda Test.
In Evento di attivazione, inserisci quanto segue:
{"data":"eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo="}
- Ancora una volta, si tratta semplicemente della stringa con codifica base64 per
{"zone":"us-west1-b", "label":"env=dev"}
- Ancora una volta, si tratta semplicemente della stringa con codifica base64 per
Fai clic sul pulsante Testa la funzione.
Al termine dell'esecuzione, dovresti vedere
Successfully started instance dev-instance
stampato in Output.Vai alla pagina Istanze VM nella console Google Cloud.
Vai alla pagina Istanze VM.Verifica che accanto al nome dell'istanza
dev-instance
sia presente un segno di spunta verde, che indica che è in esecuzione. L'operazione potrebbe richiedere fino a 30 secondi.
gcloud
Arresta l'istanza
Chiama la funzione per arrestare l'istanza.
gcloud functions call stopInstancePubSub \ --data '{"data":"eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo="}'
Si tratta semplicemente della stringa con codifica base64 per
{"zone":"us-west1-b", "label":"env=dev"}
Se vuoi codificare la tua stringa, puoi utilizzare qualsiasi strumento. Ecco un esempio di utilizzo dello strumento a riga di comando
base64
:echo '{"zone":"us-west1-b", "label":"env=dev"}' | base64
eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo=
Al termine della funzione, dovresti vedere quanto segue:
result: Successfully stopped instance dev-instance
Il completamento dell'esecuzione potrebbe richiedere fino a 60 secondi.
Se invece ricevi l'errore:
error: 'Error: function failed to load.`
Basta attendere circa 10 secondi per il completamento del deployment della funzione e riprovare.
Se invece ricevi l'errore:
error: `Error: function execution attempt timed out.`
Vai al passaggio successivo per verificare se l'arresto dell'istanza sta semplicemente richiedendo molto tempo.
Se invece non ottieni alcun risultato, è probabile che la funzione abbia superato il tempo di attesa. Vai al passaggio successivo per verificare se l'arresto dell'istanza sta semplicemente richiedendo molto tempo.
Verifica che lo stato dell'istanza sia
TERMINATED
. Potrebbero essere necessari fino a 30 secondi per completare l'arresto.gcloud compute instances describe dev-instance \ --zone us-west1-b \ | grep status
status: TERMINATED
Avvia l'istanza
Chiama la funzione per avviare l'istanza.
gcloud functions call startInstancePubSub \ --data '{"data":"eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo="}'
- Ancora una volta, si tratta semplicemente della stringa con codifica base64 per
{"zone":"us-west1-b", "label":"env=dev"}
Al termine della funzione, dovresti vedere quanto segue:
result: Successfully started instance dev-instance
- Ancora una volta, si tratta semplicemente della stringa con codifica base64 per
Verifica che lo stato dell'istanza sia
RUNNING
. L'operazione potrebbe richiedere fino a 30 secondi.gcloud compute instances describe dev-instance \ --zone us-west1-b \ | grep status
status: RUNNING
Configura i job Cloud Scheduler per chiamare Pub/Sub
Crea i job
Console
Crea il job di avvio.
- Vai alla pagina Cloud Scheduler nella console Google Cloud.
Vai alla pagina Cloud Scheduler. - Fai clic su Crea un job.
- Lascia la regione predefinita.
- Imposta Nome su
startup-dev-instances
. - In Frequenza, inserisci
0 9 * * 1-5
.- Verrà eseguito alle 9:00 ogni giorno dal lunedì al venerdì.
- In Fuso orario, seleziona il paese e il fuso orario che preferisci. In questo
esempio verranno utilizzati
United States
eLos Angeles
. - Fai clic su Continua.
- In Tipo di target, seleziona
Pub/Sub
. - Seleziona
start-instance-event
dal menu a discesa degli argomenti. - In Messaggio, inserisci quanto segue:
{"zone":"us-west1-b","label":"env=dev"}
- Fai clic su Crea.
Crea il job di arresto.
- Dovresti essere nella pagina Cloud Scheduler della console Google Cloud.
- Fai clic su Crea job.
- Lascia la regione predefinita e fai clic su Avanti in fondo alla pagina.
- Imposta Nome su
shutdown-dev-instances
. - In Frequenza, inserisci
0 17 * * 1-5
.- Verrà eseguito alle 17:00 ogni giorno dal lunedì al venerdì.
- In Fuso orario, seleziona il paese e il fuso orario che ti interessano. In questo
esempio verranno utilizzati
United States
eLos Angeles
. - Fai clic su Continua.
- In Tipo di target, seleziona
Pub/Sub
. - Seleziona
stop-instance-event
dal menu a discesa degli argomenti. - In Messaggio, inserisci quanto segue:
{"zone":"us-west1-b","label":"env=dev"}
- Fai clic su Crea.
gcloud
Crea il job di avvio.
gcloud scheduler jobs create pubsub startup-dev-instances \ --schedule '0 9 * * 1-5' \ --topic start-instance-event \ --message-body '{"zone":"us-west1-b", "label":"env=dev"}' \ --time-zone 'America/Los_Angeles' \ --location us-central1
Crea il job di arresto.
gcloud scheduler jobs create pubsub shutdown-dev-instances \ --schedule '0 17 * * 1-5' \ --topic stop-instance-event \ --message-body '{"zone":"us-west1-b", "label":"env=dev"}' \ --time-zone 'America/Los_Angeles' \ --location us-central1
(Facoltativo) Verifica il funzionamento dei job
Console
Arresta l'istanza
- Vai alla pagina Cloud Scheduler nella console Google Cloud.
Vai alla pagina Cloud Scheduler. - Per il job denominato
shutdown-dev-instances
, fai clic sul pulsante Esegui ora nella parte in alto a destra della pagina. - Vai alla pagina Istanze VM nella console Google Cloud.
Vai alla pagina Istanze VM. - Verifica che l'istanza denominata
dev-instance
abbia un quadrato grigio accanto al nome, a indicare che è stata interrotta. Potrebbero essere necessari fino a 30 secondi per completare l'arresto.
Avvia l'istanza
- Vai alla pagina Cloud Scheduler nella console Google Cloud.
Vai alla pagina Cloud Scheduler. - Per il job denominato
startup-dev-instances
, fai clic sul pulsante Esegui ora nella parte in alto a destra della pagina. - Vai alla pagina Istanze VM nella console Google Cloud.
Vai alla pagina Istanze VM. - Verifica che accanto al nome dell'istanza
dev-instance
sia presente un segno di spunta verde, che indica che è in esecuzione. Potrebbero essere necessari fino a 30 secondi per completare l'avvio.
gcloud
Arresta l'istanza
Esegui il job di pianificazione per arrestare l'istanza.
gcloud beta scheduler jobs run shutdown-dev-instances
Verifica che lo stato dell'istanza sia
TERMINATED
. Potrebbero essere necessari fino a 30 secondi per completare l'arresto.gcloud compute instances describe dev-instance \ --zone us-west1-b \ | grep status
status: TERMINATED
Avvia l'istanza
Esegui il job di pianificazione per avviare l'istanza.
gcloud beta scheduler jobs run startup-dev-instances
Verifica che lo stato dell'istanza sia
RUNNING
. L'operazione potrebbe richiedere fino a 30 secondi.gcloud compute instances describe dev-instance \ --zone us-west1-b \ | grep status
status: RUNNING
Esegui la pulizia
Al termine del tutorial, puoi eliminare le risorse che hai creato in modo che smettano di utilizzare la quota e di generare addebiti. Le sezioni seguenti descrivono come eliminare o disattivare queste risorse.
Elimina i job Cloud Scheduler
Vai alla pagina Cloud Scheduler nella console Google Cloud.
Fai clic sulle caselle di controllo accanto ai tuoi job.
Fai clic sul pulsante Elimina nella parte superiore della pagina e conferma l'eliminazione.
Elimina gli argomenti Pub/Sub
Vai alla pagina Pub/Sub nella console Google Cloud.
Fai clic sulle caselle di controllo accanto agli argomenti.
Fai clic su Elimina nella parte superiore della pagina e conferma l'eliminazione.
Elimina le funzioni di cui è stato eseguito il deployment tramite Cloud Run Functions
Vai alla pagina Funzioni Cloud Run 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 l'istanza Compute Engine
Per eliminare un'istanza di Compute Engine:
- In the Google Cloud console, go to the VM instances page.
- Select the checkbox for the instance that you want to delete.
- To delete the instance, click More actions, click Delete, and then follow the instructions.
Elimina il progetto
Il modo più semplice per eliminare la fatturazione è eliminare il progetto che hai creato per il tutorial.
Per eliminare il progetto:
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
Passaggi successivi
- Esplora architetture di riferimento, diagrammi e best practice su Google Cloud. Consulta il nostro Cloud Architecture Center.