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 di Cloud Run che avviano e e arrestare 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 basata sull'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 di Google Cloud:
- Istanza Compute Engine 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 fine.
- 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.
- Funzioni Cloud Run: supportate nelle regioni elencate in Località.
- Messaggi Pub/Sub: supportati a livello globale come Pub/Sub è un servizio globale.
- Job Cloud Scheduler con destinazioni Pub/Sub: Supportata in qualsiasi località di 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 funzioni di Cloud Run perché in precedenza questo metodo era più sicuro rispetto all'utilizzo di HTTP. Tuttavia, anche HTTP è una scelta valida e ora può essere reso sicuro richiedendo l'autenticazione.
Per scoprire di più sulla protezione delle funzioni Cloud Run, consulta la panoramica della sicurezza delle funzioni Cloud Run. Per un confronto tra trigger HTTP e Pub/Sub, Trigger delle funzioni di Cloud Run documentazione.
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 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 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 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 terminare 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 interruzione.
- Dovresti trovarti nella pagina Funzioni di Cloud Run nella console Google Cloud.
- Fai clic su Crea funzione.
- Per Ambiente, seleziona 1ª generazione.
- Imposta Nome funzione su
stopInstancePubSub
. - Lascia 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 terminare 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 delle funzioni di 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, non esitare a utilizzare qualsiasi strumento di codifica Base64.
Fai clic sul pulsante Testa la funzione.
Al termine dell'esecuzione, dovresti vedere
Successfully stopped instance dev-instance
stampata sotto Output: Il completamento dell'esecuzione potrebbe richiedere fino a 60 secondi.Se invece vedi
error: 'Error: function failed to load.'
, attendere circa 10 secondi per il completamento del deployment della funzione e provare di nuovo.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, ad indicare che l'operazione si è interrotta. L'operazione potrebbe richiedere fino a 30 secondi per completare l'arresto.- Se l'operazione non è completa, prova a fare clic su Aggiorna nella parte superiore della pagina.
Avvia l'istanza
- Vai alla pagina Funzioni di Cloud Run nella console Google Cloud.
Vai alla pagina delle funzioni di 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 trigger, 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 l'istanza denominata
dev-instance
abbia un segno di spunta verde accanto al nome, per indicare 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. Di seguito è riportato 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 viene visualizzato l'errore:
error: 'Error: function failed to load.`
Basta attendere circa 10 secondi per il completamento del deployment della funzione e riprovare.
Se invece viene visualizzato l'errore:
error: `Error: function execution attempt timed out.`
Vai al passaggio successivo per vedere se l'istanza sta semplicemente eseguendo una molto tempo all'arresto.
Se invece non ottieni alcun risultato, è probabile che la funzione sia appena scaduta. Vai al passaggio successivo per verificare se l'arresto dell'istanza sta semplicemente richiedendo molto tempo.
Verifica che lo stato dell'istanza sia
TERMINATED
. L'operazione potrebbe richiedere 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
Richiama 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 il 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 trovarti 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 il Nome su
shutdown-dev-instances
. - In Frequenza, inserisci
0 17 * * 1-5
.- Questa operazione verrà eseguita alle 17:00 tutti i giorni 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
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 interruzione.
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 all'estrema 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. L'operazione potrebbe richiedere 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 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
dev-instance
sia presente un segno di spunta verde, che indica che è in esecuzione. L'operazione potrebbe richiedere fino a 30 secondi per completare l'avvio.
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
. L'operazione potrebbe richiedere 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 dello scheduler 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 per completare l'avvio.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 seguenti sezioni 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 le funzioni di Cloud Run
Vai alla pagina Funzioni di 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 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.