Pianificare l'avvio o l'arresto di una VM Compute Engine

Console

1. Vai alla pagina Istanze VM nella console Google Cloud.
   Vai alla pagina Istanze VM.
2. Fai clic su Crea istanza.
3. Imposta Nome su dev-instance.
4. In Etichette, fai clic su Aggiungi etichette.
5. Fai clic su Aggiungi etichetta.
6. Inserisci env per Chiave e dev per Valore.
7. In Regione, seleziona us-west1.
8. In Zona, seleziona us-west1-b.
9. Fai clic su Salva.
10. 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

Console

Crea la funzione di avvio.

1. Vai alla pagina Funzioni Cloud Run nella console Google Cloud.
   Vai alla pagina Funzioni Cloud Run.
2. Fai clic su Crea funzione.
3. Per Ambiente, seleziona 1ª generazione.
4. Imposta Nome funzione su startInstancePubSub.
5. Lascia invariato il valore predefinito per Regione.
6. Per Tipo di trigger, seleziona Cloud Pub/Sub.
7. In Seleziona un argomento Cloud Pub/Sub, fai clic su Crea un argomento.
8. Dovrebbe apparire una finestra di dialogo Crea argomento.
   1. In ID argomento, inserisci start-instance-event.
   2. Fai clic su Crea per chiudere la finestra di dialogo.
9. Fai clic su Salva nella parte inferiore della casella Attivazione.
10. Fai clic su Avanti nella parte inferiore della pagina.
11. Per Runtime, seleziona Node.js 16 o versioni successive.
12. In Punto di ingresso, inserisci startInstancePubSub.
13. Sul lato sinistro dell'editor di codice, seleziona index.js.

14. Sostituisci il codice di avvio con il seguente codice:

    const compute = require('@google-cloud/compute');
    const instancesClient = new compute.InstancesClient();
    const operationsClient = new compute.ZoneOperationsClient();
    
    async function waitForOperation(projectId, operation) {
      while (operation.status !== 'DONE') {
        [operation] = await operationsClient.wait({
          operation: operation.name,
          project: projectId,
          zone: operation.zone.split('/').pop(),
        });
      }
    }
    
    /**
     * Starts Compute Engine instances.
     *
     * Expects a PubSub message with JSON-formatted event data containing the
     * following attributes:
     *  zone - the GCP zone the instances are located in.
     *  label - the label of instances to start.
     *
     * @param {!object} event Cloud Function PubSub message event.
     * @param {!object} callback Cloud Function PubSub callback indicating
     *  completion.
     */
    exports.startInstancePubSub = async (event, context, callback) => {
      try {
        const project = await instancesClient.getProjectId();
        const payload = _validatePayload(event);
        const options = {
          filter: `labels.${payload.label}`,
          project,
          zone: payload.zone,
        };
    
        const [instances] = await instancesClient.list(options);
    
        await Promise.all(
          instances.map(async instance => {
            const [response] = await instancesClient.start({
              project,
              zone: payload.zone,
              instance: instance.name,
            });
    
            return waitForOperation(project, response.latestResponse);
          })
        );
    
        // Operation complete. Instance successfully started.
        const message = 'Successfully started instance(s)';
        console.log(message);
        callback(null, message);
      } catch (err) {
        console.log(err);
        callback(err);
      }
    };
    
    /**
     * Validates that a request payload contains the expected fields.
     *
     * @param {!object} payload the request payload to validate.
     * @return {!object} the payload object.
     */
    const _validatePayload = event => {
      let payload;
      try {
        payload = JSON.parse(Buffer.from(event.data, 'base64').toString());
      } catch (err) {
        throw new Error('Invalid Pub/Sub message: ' + err);
      }
      if (!payload.zone) {
        throw new Error("Attribute 'zone' missing from payload");
      } else if (!payload.label) {
        throw new Error("Attribute 'label' missing from payload");
      }
      return payload;
    };

15. Sul lato sinistro dell'editor di codice, seleziona package.json.

16. Sostituisci il codice di avvio con il seguente codice:

    {
      "name": "cloud-functions-schedule-instance",
      "version": "0.1.0",
      "private": true,
      "license": "Apache-2.0",
      "author": "Google Inc.",
      "repository": {
        "type": "git",
        "url": "https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git"
      },
      "engines": {
        "node": ">=16.0.0"
      },
      "scripts": {
        "test": "c8 mocha -p -j 2 test/*.test.js --timeout=20000"
      },
      "devDependencies": {
        "c8": "^10.0.0",
        "mocha": "^10.0.0",
        "proxyquire": "^2.0.0",
        "sinon": "^18.0.0"
      },
      "dependencies": {
        "@google-cloud/compute": "^4.0.0"
      }
    }
    

17. Fai clic su Esegui il deployment nella parte inferiore della pagina.

Crea la funzione di arresto.

1. Dovresti trovarti nella pagina Funzioni Cloud Run della console Google Cloud.
2. Fai clic su Crea funzione.
3. Per Ambiente, seleziona 1ª generazione.
4. Imposta Nome funzione su stopInstancePubSub.
5. Lascia invariato il valore predefinito per Regione.
6. Per Tipo di trigger, seleziona Cloud Pub/Sub.
7. In Seleziona un argomento Cloud Pub/Sub, fai clic su Crea un argomento.
8. Dovrebbe apparire una finestra di dialogo Crea argomento.
   1. In ID argomento, inserisci stop-instance-event.
   2. Fai clic su Crea per chiudere la finestra di dialogo.
9. Fai clic su Salva nella parte inferiore della casella Attivazione.
10. Fai clic su Avanti nella parte inferiore della pagina.
11. Per Runtime, seleziona Node.js 16 o versioni successive.
12. In Punto di ingresso, inserisci stopInstancePubSub.
13. Sul lato sinistro dell'editor di codice, seleziona index.js.

14. Sostituisci il codice di avvio con il seguente codice:

    const compute = require('@google-cloud/compute');
    const instancesClient = new compute.InstancesClient();
    const operationsClient = new compute.ZoneOperationsClient();
    
    async function waitForOperation(projectId, operation) {
      while (operation.status !== 'DONE') {
        [operation] = await operationsClient.wait({
          operation: operation.name,
          project: projectId,
          zone: operation.zone.split('/').pop(),
        });
      }
    }
    
    /**
     * Stops Compute Engine instances.
     *
     * Expects a PubSub message with JSON-formatted event data containing the
     * following attributes:
     *  zone - the GCP zone the instances are located in.
     *  label - the label of instances to stop.
     *
     * @param {!object} event Cloud Function PubSub message event.
     * @param {!object} callback Cloud Function PubSub callback indicating completion.
     */
    exports.stopInstancePubSub = async (event, context, callback) => {
      try {
        const project = await instancesClient.getProjectId();
        const payload = _validatePayload(event);
        const options = {
          filter: `labels.${payload.label}`,
          project,
          zone: payload.zone,
        };
    
        const [instances] = await instancesClient.list(options);
    
        await Promise.all(
          instances.map(async instance => {
            const [response] = await instancesClient.stop({
              project,
              zone: payload.zone,
              instance: instance.name,
            });
    
            return waitForOperation(project, response.latestResponse);
          })
        );
    
        // Operation complete. Instance successfully stopped.
        const message = 'Successfully stopped instance(s)';
        console.log(message);
        callback(null, message);
      } catch (err) {
        console.log(err);
        callback(err);
      }
    };
    
    /**
     * Validates that a request payload contains the expected fields.
     *
     * @param {!object} payload the request payload to validate.
     * @return {!object} the payload object.
     */
    const _validatePayload = event => {
      let payload;
      try {
        payload = JSON.parse(Buffer.from(event.data, 'base64').toString());
      } catch (err) {
        throw new Error('Invalid Pub/Sub message: ' + err);
      }
      if (!payload.zone) {
        throw new Error("Attribute 'zone' missing from payload");
      } else if (!payload.label) {
        throw new Error("Attribute 'label' missing from payload");
      }
      return payload;
    };

15. Sul lato sinistro dell'editor di codice, seleziona package.json.

16. Sostituisci il codice di avvio con il seguente codice:

    {
      "name": "cloud-functions-schedule-instance",
      "version": "0.1.0",
      "private": true,
      "license": "Apache-2.0",
      "author": "Google Inc.",
      "repository": {
        "type": "git",
        "url": "https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git"
      },
      "engines": {
        "node": ">=16.0.0"
      },
      "scripts": {
        "test": "c8 mocha -p -j 2 test/*.test.js --timeout=20000"
      },
      "devDependencies": {
        "c8": "^10.0.0",
        "mocha": "^10.0.0",
        "proxyquire": "^2.0.0",
        "sinon": "^18.0.0"
      },
      "dependencies": {
        "@google-cloud/compute": "^4.0.0"
      }
    }
    

17. 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

1. Scarica il codice.

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git

   In alternativa, puoi scaricare l'esempio come file ZIP ed estrarlo.

2. 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

Console

Arresta l'istanza

1. Vai alla pagina Funzioni Cloud Run nella console Google Cloud.
   Vai alla pagina Funzioni Cloud Run.
2. Fai clic sulla funzione denominata stopInstancePubSub.
3. Dovresti vedere una serie di schede: Generale, Attivatore, Origine, Autorizzazioni e Test. Fai clic sulla scheda Test.

4. 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.

5. Fai clic sul pulsante Testa la funzione.

6. 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.

7. Vai alla pagina Istanze VM nella console Google Cloud.
   Vai alla pagina Istanze VM.

8. 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

1. Vai alla pagina Funzioni Cloud Run nella console Google Cloud.
   Vai alla pagina Funzioni Cloud Run.
2. Fai clic sulla funzione denominata startInstancePubSub.
3. Dovresti vedere una serie di schede: Generale, Attivatore, Origine, Autorizzazioni e Test. Fai clic sulla scheda Test.

4. 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"}

5. Fai clic sul pulsante Testa la funzione.

6. Al termine dell'esecuzione, dovresti vedere Successfully started instance dev-instance stampato in Output.

7. Vai alla pagina Istanze VM nella console Google Cloud.
   Vai alla pagina Istanze VM.

8. 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

1. 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.

2. 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

1. 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
   

2. 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
   

Console

Crea il job di avvio.

1. Vai alla pagina Cloud Scheduler nella console Google Cloud.
   Vai alla pagina Cloud Scheduler.
2. Fai clic su Crea un job.
3. Lascia la regione predefinita.
4. Imposta Nome su startup-dev-instances.
5. In Frequenza, inserisci 0 9 * * 1-5.
   • Verrà eseguito alle 9:00 ogni giorno dal lunedì al venerdì.
6. In Fuso orario, seleziona il paese e il fuso orario che preferisci. In questo esempio verranno utilizzati United States e Los Angeles.
7. Fai clic su Continua.
8. In Tipo di target, seleziona Pub/Sub.
9. Seleziona start-instance-event dal menu a discesa degli argomenti.
10. In Messaggio, inserisci quanto segue:

    {"zone":"us-west1-b","label":"env=dev"}
    

11. Fai clic su Crea.

Crea il job di arresto.

1. Dovresti essere nella pagina Cloud Scheduler della console Google Cloud.
2. Fai clic su Crea job.
3. Lascia la regione predefinita e fai clic su Avanti in fondo alla pagina.
4. Imposta Nome su shutdown-dev-instances.
5. In Frequenza, inserisci 0 17 * * 1-5.
   • Verrà eseguito alle 17:00 ogni giorno dal lunedì al venerdì.
6. In Fuso orario, seleziona il paese e il fuso orario che ti interessano. In questo esempio verranno utilizzati United States e Los Angeles.
7. Fai clic su Continua.
8. In Tipo di target, seleziona Pub/Sub.
9. Seleziona stop-instance-event dal menu a discesa degli argomenti.
10. In Messaggio, inserisci quanto segue:

    {"zone":"us-west1-b","label":"env=dev"}
    

11. 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

Console

Arresta l'istanza

1. Vai alla pagina Cloud Scheduler nella console Google Cloud.
   Vai alla pagina Cloud Scheduler.
2. Per il job denominato shutdown-dev-instances, fai clic sul pulsante Esegui ora nella parte in alto a destra della pagina.
3. Vai alla pagina Istanze VM nella console Google Cloud.
   Vai alla pagina Istanze VM.
4. 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

1. Vai alla pagina Cloud Scheduler nella console Google Cloud.
   Vai alla pagina Cloud Scheduler.
2. Per il job denominato startup-dev-instances, fai clic sul pulsante Esegui ora nella parte in alto a destra della pagina.
3. Vai alla pagina Istanze VM nella console Google Cloud.
   Vai alla pagina Istanze VM.
4. 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

1. Esegui il job di pianificazione per arrestare l'istanza.

   gcloud beta scheduler jobs run shutdown-dev-instances
   

2. 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

1. Esegui il job di pianificazione per avviare l'istanza.

   gcloud beta scheduler jobs run startup-dev-instances
   

2. 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