Questo tutorial mostra come utilizzare Cloud Scheduler e Cloud Functions per avviare e arrestare automaticamente le istanze di Compute Engine in base a una pianificazione regolare utilizzando le etichette delle risorse.
Obiettivi
- Scrivi ed esegui il deployment di un insieme di funzioni con Cloud Functions che avviano e interrompono le istanze di Compute Engine.
- Crea un insieme di job con Cloud Scheduler che pianificano le istanze con etichetta di risorsa
dev
in modo che vengano eseguite dalle 09:00 alle 17:00, dal lunedì al venerdì, in base al tipico orario di lavoro.
Costi
In questo documento, utilizzi i seguenti componenti fatturabili di Google Cloud:
- Cloud Scheduler
- Cloud Functions
- Pub/Sub
- Compute Engine
Per generare una stima dei costi in base all'utilizzo previsto, utilizza il Calcolatore prezzi.
Prima di iniziare
- Configura il tuo ambiente per Cloud Scheduler.
-
Abilita le API Cloud Functions, Pub/Sub, and Compute Engine.
Architettura dell'applicazione
Questa soluzione include i seguenti componenti di Google Cloud:
- Istanza Compute Engine da eseguire in base a una pianificazione.
- Cloud Functions per avviare e arrestare l'istanza che vogliamo pianificare.
- Messaggi Pub/Sub inviati e ricevuti per ogni evento di avvio e arresto.
- Job Cloud Scheduler per effettuare chiamate in base a una pianificazione prestabilita per avviare e arrestare l'istanza.
Requisiti per le località
Alcuni componenti sono supportati solo in determinate regioni:
- Istanza Compute Engine: supportata in qualsiasi regione elencata in Regioni e zone.
- Cloud Functions: supportato nelle regioni elencate in Località.
- Messaggi Pub/Sub: supportati a livello globale poiché Pub/Sub è un servizio globale.
- Job Cloud Scheduler con destinazioni Pub/Sub: supportati in qualsiasi località Google Cloud.
Perché non HTTP anziché Pub/Sub?
Potresti voler semplificare questa architettura utilizzando i trigger HTTP di Cloud Functions anziché i trigger di Pub/Sub.
Questo tutorial utilizza Pub/Sub come trigger di Cloud Functions perché in precedenza questo metodo era più sicuro dell'utilizzo di HTTP. Tuttavia, anche HTTP è una scelta valida e ora può essere protetto richiedendo l'autenticazione.
Per informazioni sulla protezione di Cloud Functions, consulta la panoramica sulla sicurezza di Cloud Functions. Per un confronto tra i trigger HTTP e Pub/Sub, consulta la documentazione sui trigger di Cloud Functions.
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 il campo 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 delle funzioni attivate da Pub/Sub tramite Cloud Functions
Crea ed esegui il deployment delle funzioni
Console
Crea la funzione iniziale.
- Vai alla pagina Cloud Functions nella console Google Cloud.
Vai alla pagina Cloud Functions. - Fai clic su Crea funzione.
- Per Ambiente, seleziona 1ª generazione.
- Imposta Nome funzione su
startInstancePubSub
. - Lascia invariato il valore predefinito per Regione.
- In Tipo di trigger, seleziona Cloud Pub/Sub.
- In Seleziona un argomento Cloud Pub/Sub, fai clic su Crea un argomento.
- Dovrebbe essere visualizzata una finestra di dialogo Crea argomento.
- In ID argomento, inserisci
start-instance-event
. - Fai clic su Crea per terminare la finestra di dialogo.
- In ID argomento, inserisci
- Fai clic su Salva nella parte inferiore della casella Attivatore.
- 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 interruzione.
- Dovresti essere nella pagina Cloud Functions 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.
- In Tipo di trigger, seleziona Cloud Pub/Sub.
- In Seleziona un argomento Cloud Pub/Sub, fai clic su Crea un argomento.
- Dovrebbe essere visualizzata una finestra di dialogo Crea argomento.
- In ID argomento, inserisci
stop-instance-event
. - Fai clic su Crea per terminare la finestra di dialogo.
- In ID argomento, inserisci
- Fai clic su Salva nella parte inferiore della casella Attivatore.
- 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
Creare 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) Verificare il funzionamento delle funzioni
Console
Arresta l'istanza
- Vai alla pagina Cloud Functions nella console Google Cloud.
Vai alla pagina Cloud Functions. - Fai clic sulla funzione denominata
stopInstancePubSub
. - Dovresti vedere una serie di schede: Generale, Trigger, Origine, Autorizzazioni e Test. Fai clic sulla scheda Test.
In Evento di trigger, inserisci quanto segue:
{"data":"eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo="}
Questa è semplicemente la stringa con codifica Base64 per
{"zone":"us-west1-b", "label":"env=dev"}
Se vuoi codificare una stringa personalizzata, 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. Potrebbero essere necessari fino a 60 secondi per terminare l'esecuzione.Se invece vedi
error: 'Error: function failed to load.'
, attendi circa 10 secondi affinché la funzione termini il deployment 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 si sia semplicemente verificato il timeout. Vai al passaggio successivo per vedere se l'arresto dell'istanza sta richiedendo molto tempo.
Vai alla pagina Istanze VM nella console Google Cloud.
Vai alla pagina Istanze VM.Verifica che accanto al nome dell'istanza denominata
dev-instance
sia presente un quadrato grigio, che ne indica l'interruzione. Potrebbero essere necessari fino a 30 secondi per completare l'arresto.- Se la pagina non termina correttamente, prova a fare clic su Aggiorna nella parte superiore della pagina.
Avvia l'istanza
- Vai alla pagina Cloud Functions nella console Google Cloud.
Vai alla pagina Cloud Functions. - Fai clic sulla funzione denominata
startInstancePubSub
. - Dovresti vedere una serie di schede: Generale, Trigger, Origine, Autorizzazioni e Test. Fai clic sulla scheda Test.
In Evento di trigger, inserisci quanto segue:
{"data":"eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo="}
- Anche in questo caso, questa è semplicemente la stringa con codifica Base64 per
{"zone":"us-west1-b", "label":"env=dev"}
- Anche in questo caso, questa è semplicemente la 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 denominata
dev-instance
sia presente un segno di spunta verde che ne indica che è in esecuzione. L'avvio potrebbe richiedere fino a 30 secondi.
gcloud
Arresta l'istanza
Richiama la funzione per arrestare l'istanza.
gcloud functions call stopInstancePubSub \ --data '{"data":"eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo="}'
Questa è semplicemente la stringa con codifica Base64 per
{"zone":"us-west1-b", "label":"env=dev"}
Se vuoi codificare la tua stringa, puoi usare 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
Potrebbero essere necessari fino a 60 secondi per terminare l'esecuzione.
Se invece viene visualizzato l'errore:
error: 'Error: function failed to load.`
Attendi circa 10 secondi per il completamento del deployment della funzione e riprova.
Se invece viene visualizzato l'errore:
error: `Error: function execution attempt timed out.`
Vai al passaggio successivo per verificare se l'arresto dell'istanza sta richiedendo molto tempo.
Se invece non ottieni alcun risultato, è probabile che la funzione sia scaduta. Vai al passaggio successivo per verificare se l'arresto dell'istanza sta richiedendo molto tempo.
Verifica che lo stato dell'istanza sia
TERMINATED
. Il completamento dell'arresto potrebbe richiedere fino a 30 secondi.gcloud compute instances describe dev-instance \ --zone us-west1-b \ | grep status
status: TERMINATED
Avvia l'istanza
Richiama la funzione per avviare l'istanza.
gcloud functions call startInstancePubSub \ --data '{"data":"eyJ6b25lIjoidXMtd2VzdDEtYiIsICJsYWJlbCI6ImVudj1kZXYifQo="}'
- Anche in questo caso, questa è semplicemente la 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
- Anche in questo caso, questa è semplicemente la stringa con codifica Base64 per
Verifica che lo stato dell'istanza sia
RUNNING
. L'avvio 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 di Cloud Scheduler. - Fai clic su Crea un job.
- Lascia la regione predefinita.
- Imposta il campo Nome su
startup-dev-instances
. - In Frequenza, inserisci
0 9 * * 1-5
.- L'operazione verrà eseguita ogni giorno alle 09:00, dal lunedì al venerdì.
- Per Fuso orario, seleziona il paese e il fuso orario che preferisci. Questo
esempio utilizzerà
United States
eLos Angeles
. - Fai clic su Continua.
- In Tipo di target, seleziona
Pub/Sub
. - Seleziona
start-instance-event
dal menu a discesa dell'argomento. - In Messaggio, inserisci quanto segue:
{"zone":"us-west1-b","label":"env=dev"}
- Fai clic su Crea.
Crea l'interruzione del job.
- Dovresti essere nella pagina Cloud Scheduler della console Google Cloud.
- Fai clic su Crea job.
- Lascia l'area predefinita e fai clic su Avanti in fondo alla pagina.
- Imposta il campo Nome su
shutdown-dev-instances
. - In Frequenza, inserisci
0 17 * * 1-5
.- L'operazione verrà eseguita ogni giorno alle ore 17:00 dal lunedì al venerdì.
- Per Fuso orario, seleziona il paese e il fuso orario che preferisci. Questo
esempio utilizzerà
United States
eLos Angeles
. - Fai clic su Continua.
- In Tipo di target, seleziona
Pub/Sub
. - Seleziona
stop-instance-event
dal menu a discesa dell'argomento. - 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 l'interruzione del job.
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) Verificare il funzionamento dei job
Console
Arresta l'istanza
- Vai alla pagina Cloud Scheduler nella console Google Cloud.
Vai alla pagina di Cloud Scheduler. - Per il job denominato
shutdown-dev-instances
, fai clic sul pulsante Esegui ora all'estrema destra della pagina. - Vai alla pagina Istanze VM nella console Google Cloud.
Vai alla pagina Istanze VM. - Verifica che accanto al nome dell'istanza denominata
dev-instance
sia presente un quadrato grigio, che ne indica l'interruzione. Potrebbero essere necessari fino a 30 secondi per il completamento dell'arresto.
Avvia l'istanza
- Vai alla pagina Cloud Scheduler nella console Google Cloud.
Vai alla pagina di Cloud Scheduler. - Per il job denominato
startup-dev-instances
, fai clic sul pulsante Esegui ora all'estrema destra della pagina. - Vai alla pagina Istanze VM nella console Google Cloud.
Vai alla pagina Istanze VM. - Verifica che accanto al nome dell'istanza denominata
dev-instance
sia presente un segno di spunta verde che ne indica che è in esecuzione. L'avvio potrebbe richiedere fino a 30 secondi.
gcloud
Arresta l'istanza
Esegui il job dello scheduler per arrestare l'istanza.
gcloud beta scheduler jobs run shutdown-dev-instances
Verifica che lo stato dell'istanza sia
TERMINATED
. Il completamento dell'arresto potrebbe richiedere fino a 30 secondi.gcloud compute instances describe dev-instance \ --zone us-west1-b \ | grep status
status: TERMINATED
Avvia l'istanza
Esegui il job dello scheduler per avviare l'istanza.
gcloud beta scheduler jobs run startup-dev-instances
Verifica che lo stato dell'istanza sia
RUNNING
. L'avvio 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 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.
Elimina i job Cloud Scheduler
Vai alla pagina Cloud Scheduler nella console Google Cloud.
Fai clic sulle caselle di controllo accanto ai 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 Functions
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 l'istanza Compute Engine
Per eliminare un'istanza di Compute Engine:
- Nella console Google Cloud, vai alla pagina Istanze VM.
- Seleziona la casella di controllo per l'istanza che vuoi eliminare.
- Per eliminare l'istanza, fai clic su Altre azioni, quindi su Elimina e segui le istruzioni.
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
- Esplora le architetture di riferimento, i diagrammi e le best practice su Google Cloud. Visita il nostro Cloud Architecture Center.