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 illustra come attivare Workflows da Fogli.

Obiettivi

In questo tutorial, imparerai a:

  1. Utilizza Moduli Google, una soluzione di 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 Fogli Google al modulo per raccogliere e salvare le risposte.
  3. Utilizza Google Apps Script, una piattaforma JavaScript basata su cloud che consente di creare, leggere e modificare in modo programmatico i prodotti Google Workspace 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 dell'API Compute Engine e crea un'istanza VM di Compute Engine in base alle specifiche raccolte tramite il modulo. I connettori semplificano le chiamate alle altre API Google Cloud. Scopri di più sui connettori Workflows.
  5. Testa l'intero processo e conferma che un'istanza VM sia stata creata come previsto.

Costi

In questo documento vengono utilizzati 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 possono essere idonei a una prova senza costi aggiuntivi.

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 comandi seguenti nella console Google Cloud o utilizzando Google Cloud CLI nel tuo 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 di 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 verificare se la fatturazione è abilitata in un progetto.

  3. Abilitare le API Compute Engine e Workflows.

    Abilita le API

  4. I nuovi progetti che hanno abilitato l'API Compute Engine dispongono di un account di servizio predefinito di Compute Engine creato con il ruolo Editor di base di Identity and Access Management (IAM) 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.

    Prendi nota di questo account di servizio perché lo assocerai al flusso di lavoro in questo tutorial a scopo di test.

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 verificare se la fatturazione è abilitata in un progetto.

  3. Abilitare le API Compute Engine e Workflows.

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

  4. I nuovi progetti che hanno abilitato l'API Compute Engine hanno un account di servizio predefinito di Compute Engine creato con il ruolo Editor di base IAM e con il seguente formato email:

    PROJECT_NUMBER-compute@developer.gserviceaccount.com

    Puoi recuperare il numero del progetto:

    gcloud projects describe PROJECT_ID

    Prendi nota di questo account di servizio perché lo assocerai al flusso di lavoro in questo tutorial a scopo di test.

Crea un modulo per richiedere istanze VM

Crea un modulo da utilizzare per inviare una richiesta di creazione di un'istanza di macchina virtuale (VM) Compute Engine. Per impostazione predefinita, i moduli che crei tramite Moduli Google vengono salvati 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
    Dimensioni disco (GB)

    Testo risposta breve
    Sistema operativo

    Menu a discesa:

    1. debian-10
    2. centos-stream-9
    3. cos-93-lts
    4. cos-97-lts
  4. Attiva la raccolta email per registrare gli indirizzi email delle persone 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 del 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 l'intestazione Approvata?.

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

    Il foglio di lavoro dovrebbe avere un aspetto 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 viene visualizzata anche nella riga relativa alla risposta.

Estendi Fogli Google utilizzando Apps Script

Con Apps Script puoi creare, leggere e modificare Fogli a livello di programmazione. La maggior parte degli script progettati per Fogli manipola gli array in modo da interagire con celle, righe e colonne di un foglio di lavoro. Per un'introduzione all'utilizzo di Apps Script con Fogli, consulta la guida rapida delle 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.

    Ora lo script è associato al foglio di lavoro, in modo che possa modificare l'interfaccia utente o rispondere all'apertura.

    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 che puoi 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 passa 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 l'ID progetto nella pagina Ti diamo il benvenuto della console Google Cloud.

    6. Fai clic su Salva .

  3. Gli attivatori 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 attivatore.
    4. Nella finestra di dialogo Aggiungi trigger per YOUR_PROJECT_NAME, configura l'attivatore:
      1. Nell'elenco Scegli la funzione da 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 potrà visualizzare, modificare, creare ed eliminare i tuoi fogli di lavoro Fogli e connettersi a un servizio esterno.

  4. Un file manifest di progetto Apps Script è un file JSON che specifica le informazioni di base del progetto necessarie ad 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 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 tuo progetto, aggiungi un array con gli ambiti che vuoi che 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"
  ]
}

      Gli ambiti espliciti vengono impostati su:

      • Connettersi a un servizio esterno
      • Visualizzare, modificare, configurare ed eliminare i tuoi dati Google Cloud e visualizzare l'indirizzo email del tuo 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

Esegui il deployment di un flusso di lavoro che viene attivato quando viene approvata una richiesta di creazione di un'istanza VM. Il flusso di lavoro chiama il connettore dell'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 Workflows

  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. Per Account di servizio, seleziona l'account di servizio predefinito di Compute Engine (PROJECT_NUMBER-compute@developer.gserviceaccount.com).

  6. Tocca Avanti.

  7. Nell'editor del flusso di lavoro, inserisci la definizione seguente per il 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 di 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 seguente comando:

    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 progetto:

    gcloud projects describe PROJECT_ID

Testare 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 andrà a buon fine. 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 Approvata?.

  7. Apri il progetto Apps Script.

  8. Fai clic su Esecuzioni .

    Il trigger dovrebbe essere eseguito ed elencato con lo stato Completed.

  9. Conferma 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 Workflows

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

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

      Lo Stato di esecuzione deve 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 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. Conferma che una nuova VM sia stata creata 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 è 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 i file su Drive.
  2. Elimina un'istanza VM di Compute Engine.
  3. Eliminare un flusso di lavoro.

Passaggi successivi