Attivare un flusso di lavoro da Fogli Google

Fogli Google è una soluzione per fogli di lavoro basata su cloud che supporta la collaborazione in tempo reale e fornisce strumenti per visualizzare, elaborare e comunicare i dati.

Questo tutorial mostra come attivare Workflows da Fogli.

Obiettivi

In questo tutorial, imparerai a:

  1. Utilizza Moduli Google, una soluzione per questionari e sondaggi basati su cloud, per creare un modulo che possa inviare richieste di creazione di istanze di macchine virtuali (VM).
  2. Collega un foglio di lavoro di Fogli Google al modulo per raccogliere e salvare le risposte.
  3. Utilizza Google Apps Script, una piattaforma JavaScript basata su cloud che ti consente di creare, leggere e modificare i prodotti Google Workspace a livello di programmazione, per attivare un flusso di lavoro ogni volta che una richiesta viene approvata tramite un aggiornamento del foglio di lavoro.
  4. Esegui il deployment di un flusso di lavoro che chiama il connettore API Compute Engine e crea un'istanza VM di Compute Engine in base alle specifiche raccolte tramite il modulo. I connettori semplificano la chiamata di altre API Google Cloud. Scopri di più sui connettori Workflows.
  5. Testa l'intero processo e conferma che un'istanza VM sia creata come previsto.

Costi

In questo documento, utilizzi i seguenti componenti fatturabili di Google Cloud:

Per generare una stima dei costi in base all'utilizzo previsto, utilizza il Calcolatore prezzi. I nuovi utenti di Google Cloud potrebbero essere idonei per una prova gratuita.

Il tutorial utilizza anche Google Workspace. I servizi di livello aziendale non inclusi nelle app consumer gratuite di Google sono fatturabili.

Prima di iniziare

Puoi eseguire alcuni dei seguenti comandi nella console Google Cloud oppure utilizzando Google Cloud CLI nel terminale o in Cloud Shell.

I vincoli di sicurezza definiti dalla tua organizzazione potrebbero impedirti di completare i passaggi seguenti. Per informazioni sulla risoluzione dei problemi, vedi Sviluppare applicazioni in un ambiente Google Cloud vincolato.

Console

  1. Nella pagina del selettore dei progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  2. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud. Scopri come controllare se la fatturazione è abilitata su un progetto.

  3. Abilita le API Compute Engine e Workflows.

    Abilita le API

  4. Prendi nota dell'account di servizio predefinito di Compute Engine, che lo assocerai al flusso di lavoro in questo tutorial a scopo di test. Per i nuovi progetti in cui è stata abilitata l'API Compute Engine, questo account di servizio viene creato con il ruolo IAM Editor di base e con il seguente formato email:

    PROJECT_NUMBER-compute@developer.gserviceaccount.com

    Puoi trovare il numero del progetto nella pagina Ti diamo il benvenuto della console Google Cloud.

    Per gli ambienti di produzione, consigliamo vivamente di creare un nuovo account di servizio e assegnargli uno o più ruoli IAM contenenti le autorizzazioni minime richieste e seguire il principio del privilegio minimo.

gcloud

  1. Nella console Google Cloud, attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.

  2. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud. Scopri come controllare se la fatturazione è abilitata su un progetto.

  3. Abilita le API Compute Engine e Workflows.

    gcloud services enable \
    compute.googleapis.com \
    workflows.googleapis.com

  4. Prendi nota dell'account di servizio predefinito di Compute Engine, che lo assocerai al flusso di lavoro in questo tutorial a scopo di test. Per i nuovi progetti in cui è stata abilitata l'API Compute Engine, questo account di servizio viene creato con il ruolo IAM Editor di base e con il seguente formato email:

    PROJECT_NUMBER-compute@developer.gserviceaccount.com

    Puoi recuperare il numero del tuo progetto:

    gcloud projects describe PROJECT_ID

    Per gli ambienti di produzione, consigliamo vivamente di creare un nuovo account di servizio e assegnargli uno o più ruoli IAM contenenti le autorizzazioni minime richieste e seguire il principio del privilegio minimo.

Crea un modulo per richiedere le istanze VM

Crea un modulo che può essere utilizzato per inviare una richiesta di creazione di un'istanza di macchina virtuale (VM) Compute Engine. Per impostazione predefinita, quando crei un modulo mediante Moduli Google, questo viene salvato su Google Drive.

  1. Vai a forms.google.com.
  2. Fai clic su Vuoto Plus.

    Si apre un nuovo modulo.

  3. Crea un modulo con cinque sezioni obbligatorie. Il modulo dovrebbe essere simile al seguente:

    Visualizza modulo di esempio

    Esempio di modulo per richiedere la creazione di una macchina virtuale Google Cloud
    Nome macchina

    Testo risposta breve
    Zona

    Menu a discesa:

    1. us-central1-a
    2. us-central1-b
    3. us-central1-c
    4. us-central1-f
    Tipo

    Menu a discesa:

    1. e2-micro
    2. e2-small
    3. e2-medium
    4. e2-standard-2
    5. e2-standard-4
    Dimensione disco (GB)

    Testo risposta breve
    Sistema operativo

    Menu a discesa:

    1. debian-10
    2. Centos-stream-9
    3. cos-93-lt
    4. cos-97-lts
  4. Abilita la raccolta degli indirizzi email per registrare gli indirizzi email degli utenti che compilano il modulo:
    1. Fai clic su Settings (Impostazioni).
    2. Espandi la sezione Risposte.
    3. Fai clic sul pulsante di attivazione/disattivazione Raccogli indirizzi email.

Dopo aver creato un modulo, collegalo a un foglio di lavoro in modo da poter salvare le risposte al modulo al suo interno. Il foglio di lavoro viene salvato su Drive.

  1. Apri il modulo in Moduli.
  2. Fai clic su Risposte.
  3. Fai clic su Collega a Fogli.
  4. Nella finestra di dialogo Seleziona la destinazione per le risposte, seleziona Crea un nuovo foglio di lavoro.

  5. Fai clic su Crea.

    Si apre il foglio di lavoro collegato.

  6. Nella colonna H, aggiungi un'intestazione Approvato?.

  7. Posiziona il cursore sulla prima riga della colonna H e seleziona Inserisci > Casella di controllo.

    Il foglio di lavoro dovrebbe essere simile al seguente:

    Esempio di foglio di lavoro collegato per raccogliere le richieste

    Ogni volta che il foglio viene aggiornato con una risposta, la casella di controllo verrà visualizzata anche nella riga della risposta in questione.

Estendi Fogli Google con Apps Script

Apps Script ti consente di creare, leggere e modificare Fogli in modo programmatico. La maggior parte degli script progettati per Fogli manipola gli array in modo che interagiscano con celle, righe e colonne di un foglio di lavoro. Per un'introduzione all'utilizzo di Apps Script con Fogli, consulta la guida rapida alle funzioni personalizzate.

  1. Creare un progetto Apps Script da Fogli:

    1. Apri il foglio di lavoro di Fogli.
    2. Seleziona Estensioni > Apps Script.
    3. Nell'editor di script, fai clic su Progetto senza titolo.
    4. Assegna un nome al progetto e fai clic su Rinomina.

    Lo script è ora associato al foglio di lavoro, il che consente allo script di modificare l'interfaccia utente o di rispondere quando il foglio di lavoro viene aperto.

    Un progetto di script rappresenta una raccolta di file e risorse di Apps Script. I file di codice in un progetto di script hanno un'estensione .gs.

  2. Puoi usare Apps Script per scrivere funzioni personalizzate da usare in Fogli, proprio come una funzione integrata. Le funzioni personalizzate vengono create utilizzando JavaScript standard. Crea una funzione:

    1. Apri il progetto Apps Script.
    2. Fai clic su Editor .
    3. Un file di script viene visualizzato come file di progetto denominato Code.gs. Per modificare il file, selezionalo.

    4. Sostituisci qualsiasi codice nell'editor di script con il seguente codice che legge i dati nel foglio di lavoro e li trasmette come input a un'esecuzione del flusso di lavoro:

      const PROJECT_ID = "your-project-id";
const REGION = "us-central1";
const WORKFLOW = "create-vm-from-form";

function handleEdit(e) {
  var range = e.range.getA1Notation();
  var sheet = e.source;

  if (range.length > 1 && range[0] === 'H') {
    if (e.value == "TRUE") {
      Logger.log("Approved checkbox: true");

      var row = range.slice(1)
      var email = sheet.getRange('B' + row).getCell(1, 1).getValue()
      var vmName = sheet.getRange('c' + row).getCell(1, 1).getValue()
      var zone = sheet.getRange('D' + row).getCell(1, 1).getValue()
      var machineType = sheet.getRange('E' + row).getCell(1, 1).getValue()
      var diskSize = sheet.getRange('F' + row).getCell(1, 1).getValue()
      var imageFamily = sheet.getRange('G' + row).getCell(1, 1).getValue()
      var imageProject = imageFamily.substring(0, imageFamily.indexOf('-')) + "-cloud"

      const executionPayload = {
        "argument": "{\"diskSize\": \"" + diskSize + "\", \"email\": \"" + email + "\", \"imageFamily\": \"" + imageFamily + "\", \"imageProject\": \"" + imageProject + "\", \"machineType\": \"" + machineType + "\", \"vmName\": \"" + vmName + "\", \"zone\": \"" + zone +  "\"}"
      };

      approve(executionPayload);
    }
    else {
      Logger.log("Approved checkbox: false");
    }
  }
}

function approve(executionPayload) {
  const headers = {
    "Authorization": "Bearer " + ScriptApp.getOAuthToken()
  };

  const params = {
    "method": 'post',
    "contentType": 'application/json',
    "headers": headers,
    "payload": JSON.stringify(executionPayload)
  };

  const url = "https://workflowexecutions.googleapis.com/v1/projects/" + PROJECT_ID + "/locations/" + REGION + "/workflows/" + WORKFLOW + "/executions";

  Logger.log("Workflow execution request to " + url);
  var response = UrlFetchApp.fetch(url, params);
  Logger.log(response);
}

    5. Sostituisci your-project-id con l'ID del tuo progetto Google Cloud.

      Puoi trovare il tuo ID progetto nella pagina Ti diamo il benvenuto della console Google Cloud.

    6. Fai clic su Salva .

  3. I trigger installabili di Apps Script consentono a un progetto di script di eseguire una funzione specificata quando vengono soddisfatte determinate condizioni, ad esempio quando un foglio di lavoro viene aperto o modificato. Crea un attivatore:

    1. Apri il progetto Apps Script.
    2. Fai clic su Attivatori .
    3. Fai clic su Aggiungi trigger.
    4. Nella finestra di dialogo Aggiungi trigger per YOUR_PROJECT_NAME, configura l'attivatore:
      1. Nell'elenco Scegli quale funzione eseguire, seleziona handleEdit.
      2. Nell'elenco Scegli quale deployment eseguire, seleziona Head.
      3. Nell'elenco Seleziona origine evento, scegli Da foglio di lavoro.
      4. Nell'elenco Seleziona il tipo di evento, scegli Alla modifica.
      5. Nell'elenco Impostazioni di notifica di errore, seleziona Avvisami ogni giorno.
    5. Fai clic su Salva.

    6. Se ti viene chiesto di scegliere un Account Google, seleziona l'account appropriato, quindi fai clic su Consenti.

      In questo modo il tuo progetto Apps Script può visualizzare, modificare, creare ed eliminare i fogli di lavoro di Fogli e connettersi a un servizio esterno.

  4. Un file manifest del progetto Apps Script è un file JSON che specifica le informazioni di base del progetto necessarie a Apps Script per eseguire correttamente uno script. Tieni presente che l'editor di Apps Script nasconde i file manifest per impostazione predefinita per proteggere le impostazioni del progetto Apps Script. Modifica il file manifest:

    1. Apri il progetto Apps Script.
    2. Fai clic su Impostazioni progetto .
    3. Seleziona la casella di controllo Mostra il file manifest "appsscript.json" nell'editor.
    4. Fai clic su Editor .
    5. Il file manifest viene visualizzato come un file di progetto denominato appsscript.json. Per modificare il file, selezionalo.

    6. Il campo oauthScopes specifica un array di stringhe. Per impostare gli ambiti di autorizzazione utilizzati dal progetto, aggiungi un array con gli ambiti che vuoi siano supportati. Ad esempio:

      {
  "timeZone": "America/Toronto",
  "dependencies": {
  },
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/script.external_request",
    "https://www.googleapis.com/auth/cloud-platform",
    "https://www.googleapis.com/auth/spreadsheets"
  ]
}
      .

      In questo modo gli ambiti espliciti vengono impostati su:

      • Connettersi a un servizio esterno
      • Visualizzare, modificare, configurare ed eliminare i dati di Google Cloud e visualizzare l'indirizzo email dell'Account Google
      • Visualizzare, modificare, creare ed eliminare tutti i tuoi fogli di lavoro di Fogli

    7. Fai clic su Salva .

Esegui il deployment di un flusso di lavoro che crea un'istanza VM

Eseguire il deployment di un flusso di lavoro che viene attivato quando viene approvata una richiesta per creare un'istanza VM. Il flusso di lavoro chiama il connettore API Compute Engine per creare un'istanza VM di Compute Engine in base alle specifiche raccolte tramite il modulo.

Console

  1. Nella console Google Cloud, vai alla pagina Flussi di lavoro:

    Vai a Flussi di lavoro

  2. Fai clic su Crea.

  3. Inserisci un nome per il nuovo flusso di lavoro: create-vm-from-form.

  4. Nell'elenco Regione, seleziona us-central1 (Iowa).

  5. In Account di servizio, seleziona l'account di servizio predefinito di Compute Engine (PROJECT_NUMBER-compute@developer.gserviceaccount.com).

  6. Fai clic su Avanti.

  7. Nell'editor del flusso di lavoro, inserisci la seguente definizione per il tuo flusso di lavoro:

    main:
   params: [input]
   steps:
   - init:
       assign:
            - projectId: ${sys.get_env("GOOGLE_CLOUD_PROJECT_ID")}
            - zone: ${input.zone}
            - machineType: ${input.machineType}
            - diskSize: ${input.diskSize}
            - imageProject: ${input.imageProject}
            - imageFamily: ${input.imageFamily}
            - vmName: ${input.vmName}
            - email: ${input.email}
   - createResource:
       call: googleapis.compute.v1.instances.insert
       args:
           project: ${projectId}
           zone: ${zone}
           body:
               name: ${vmName}
               machineType: ${"projects/" + projectId + "/zones/" + zone + "/machineTypes/" + machineType}
               disks:
                - initializeParams:
                    diskSizeGb: ${diskSize}
                    sourceImage: ${"projects/" + imageProject + "/global/images/family/" + imageFamily}
                  type: PERSISTENT
                  boot: true
                  autoDelete: true
               networkInterfaces:
                - network: "global/networks/default"
       result: insertResult
   - retStep:
       return: ${insertResult}

  8. Fai clic su Esegui il deployment.

gcloud

  1. Crea un file di codice sorgente per il tuo flusso di lavoro:

    touch create-vm-from-form.yaml

  2. In un editor di testo, copia il seguente flusso di lavoro nel file del codice sorgente:

    main:
   params: [input]
   steps:
   - init:
       assign:
            - projectId: ${sys.get_env("GOOGLE_CLOUD_PROJECT_ID")}
            - zone: ${input.zone}
            - machineType: ${input.machineType}
            - diskSize: ${input.diskSize}
            - imageProject: ${input.imageProject}
            - imageFamily: ${input.imageFamily}
            - vmName: ${input.vmName}
            - email: ${input.email}
   - createResource:
       call: googleapis.compute.v1.instances.insert
       args:
           project: ${projectId}
           zone: ${zone}
           body:
               name: ${vmName}
               machineType: ${"projects/" + projectId + "/zones/" + zone + "/machineTypes/" + machineType}
               disks:
                - initializeParams:
                    diskSizeGb: ${diskSize}
                    sourceImage: ${"projects/" + imageProject + "/global/images/family/" + imageFamily}
                  type: PERSISTENT
                  boot: true
                  autoDelete: true
               networkInterfaces:
                - network: "global/networks/default"
       result: insertResult
   - retStep:
       return: ${insertResult}

  3. Esegui il deployment del flusso di lavoro inserendo il comando seguente:

    gcloud workflows deploy create-vm-from-form \
    --source=create-vm-from-form.yaml \
    --location=us-central1 \
    --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com

    Sostituisci PROJECT_NUMBER con il numero del tuo progetto Google Cloud. Puoi recuperare il numero del tuo progetto:

    gcloud projects describe PROJECT_ID

Testa il flusso end-to-end

Per verificare che tutto funzioni come previsto, prova a eseguire l'intero processo.

  1. Invia il modulo a te stesso e rispondi alle domande in modo appropriato.

    Assicurati che le specifiche utilizzate per creare un'istanza VM siano valide; in caso contrario, l'esecuzione del flusso di lavoro non riuscirà. Per ulteriori informazioni, consulta Famiglia di macchine per uso generico di Compute Engine.

  2. Per inviare la risposta, fai clic su Invia.

  3. Apri il modulo in Moduli.

  4. Fai clic su Risposte.

  5. Fai clic su Visualizza in Fogli.

    Si apre il foglio di lavoro collegato.

  6. Nella riga della risposta, seleziona la casella di controllo Approvato?.

  7. Apri il progetto Apps Script.

  8. Fai clic su Esecuzioni .

    L'attivatore deve essere eseguito ed elencato con lo stato Completed.

  9. Verifica che il flusso di lavoro create-vm-from-form sia stato completato correttamente:

    Console

    1. Nella console Google Cloud, vai alla pagina Flussi di lavoro.

      Vai a Flussi di lavoro

    2. Nella pagina Flussi di lavoro, fai clic sul flusso di lavoro create-vm-from-form per passare alla pagina dei dettagli.

    3. Nella pagina Dettagli flusso di lavoro, per recuperare i dettagli di una determinata esecuzione, fai clic sull'ID esecuzione appropriato.

      Lo stato di esecuzione dovrebbe essere Riuscito e, nel riquadro di input, dovresti vedere le specifiche della VM che hai richiesto.

    gcloud

    Recupera un elenco dei tentativi di esecuzione del tuo flusso di lavoro:

    gcloud workflows executions list create-vm-from-form

    Il risultato dovrebbe essere simile al seguente:

    NAME: projects/918619793306/locations/us-central1/workflows/create-vm-from-form/executions/d8947ecb-9ccb-4ea1-ba10-e5c10414e3be
STATE: SUCCEEDED
START_TIME: 2023-01-24T15:07:40.404741791Z
END_TIME: 2023-01-24T15:07:55.649373625Z

  10. Verifica che sia stata creata una nuova VM come previsto:

    Console

    Nella console Google Cloud, vai alla pagina Istanze VM.

    Vai a Istanze VM

    L'istanza VM dovrebbe essere elencata con uno stato che indica che è in esecuzione.

    gcloud

    Recupera un elenco aggregato di tutte le VM in tutte le zone per un progetto:

    gcloud compute instances list

    L'istanza VM dovrebbe essere elencata con uno stato che indica che è in esecuzione.

    Per ulteriori informazioni sul comando gcloud compute instances list, consulta la relativa pagina di riferimento.

Esegui la pulizia

Se hai creato un nuovo progetto per questo tutorial, elimina il progetto. Se hai utilizzato un progetto esistente e vuoi conservarlo senza le modifiche aggiunte in questo tutorial, elimina le risorse create per il tutorial.

Elimina il progetto

Il modo più semplice per eliminare la fatturazione è quello di eliminare il progetto che hai creato per il tutorial.

Per eliminare il progetto:

  1. Nella console Google Cloud, vai alla pagina Gestisci risorse.

    Vai a Gestisci risorse

  2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
  3. Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.

Elimina le risorse create in questo tutorial

  1. Eliminare file su Drive.
  2. Elimina un'istanza VM di Compute Engine.
  3. Elimina un flusso di lavoro.

Passaggi successivi