Workflows über Google Tabellen auslösen

Formular zum Anfordern von VM-Instanzen erstellen

Erstellen Sie ein Formular, mit dem eine Anfrage zum Erstellen einer Compute Engine-VM-Instanz gesendet werden kann. Wenn Sie ein Formular über Google Formulare erstellen, wird es standardmäßig in Google Drive gespeichert.

1. Rufen Sie forms.google.com auf.
2. Klicken Sie auf Leere Vorlage .

   Ein neues Formular wird geöffnet.

3. Erstellen Sie ein Formular mit fünf Pflichtfeldern. Das Formular sollte in etwa so aussehen:

   Beispielformular ansehen

   

   Computername	Kurzantworttext
   Zone	Drop-down-Menü: us-central1-a us-central1-b us-central1-c us-central1-f
   Typ	Drop-down-Menü: e2-micro e2-small e2-medium e2-standard-2 e2-standard-4
   Laufwerkgröße (GB)	Kurzantworttext
   Betriebssystem	Drop-down-Menü: debian-10 centos-stream-9 cos-93-lts cos-97-lts

4. Aktivieren Sie die E-Mail-Erfassung, um die E-Mail-Adressen der Personen zu erfassen, die Ihr Formular ausfüllen:
   1. Klicken Sie auf Einstellungen.
   2. Maximieren Sie den Bereich Antworten.
   3. Klicken Sie auf die Ein/Aus-Schaltfläche E-Mail-Adressen erfassen.

Tabelle mit dem Formular verknüpfen

Nachdem Sie ein Formular erstellt haben, verknüpfen Sie es mit einer Tabelle, damit Sie die Formularantworten in dieser Tabelle speichern können. Die Tabelle wird in Google Drive gespeichert.

1. Öffnen Sie Ihr Formular in Google Formulare.
2. Klicken Sie auf Antworten.
3. Klicken Sie auf Mit Google Tabellen verknüpfen.
4. Wählen Sie im Dialogfeld Ziel für Antworten auswählen die Option Neue Tabelle erstellen aus.

5. Klicken Sie auf Erstellen.

   Die verknüpfte Tabelle wird geöffnet.

6. Fügen Sie in Spalte H die Überschrift Genehmigt? hinzu.

7. Setzen Sie den Cursor in die erste Zeile der Spalte H und wählen Sie Einfügen > Kästchen aus.

   Die Tabelle sollte in etwa so aussehen:

   

   Jedes Mal, wenn die Tabelle mit einer Antwort aktualisiert wird, wird das Kästchen auch in der Zeile für diese Antwort angezeigt.

Google Tabellen mit Apps Script erweitern

Mit Apps Script können Sie Tabellen programmatisch erstellen, lesen und bearbeiten. Die meisten Scripts für Google Tabellen bearbeiten Arrays, um mit den Zellen, Zeilen und Spalten in einer Tabelle zu interagieren. Eine Einführung in die Verwendung von Apps Script in Google Tabellen finden Sie in der Kurzanleitung für benutzerdefinierte Funktionen.

1. So erstellen Sie ein Apps Script-Projekt in Google Tabellen:

   1. Öffnen Sie die Google Tabellen-Tabelle.
   2. Wählen Sie Erweiterungen > Apps Script aus.
   3. Klicken Sie im Script-Editor auf Unbenanntes Projekt.
   4. Geben Sie Ihrem Projekt einen Namen und klicken Sie auf Umbenennen.

   Ihr Script ist jetzt an die Tabelle gebunden. Dadurch kann das Script die Benutzeroberfläche ändern oder reagieren, wenn die Tabelle geöffnet wird.

   Ein Script-Projekt stellt eine Sammlung von Apps Script-Dateien und ‑Ressourcen dar. Codedateien in einem Scriptprojekt haben die Erweiterung .gs.

2. Mit Apps Script können Sie benutzerdefinierte Funktionen schreiben, die Sie in Google Tabellen wie eine integrierte Funktion verwenden können. Benutzerdefinierte Funktionen werden mit Standard-JavaScript erstellt. So erstellen Sie eine Funktion:

   1. Öffnen Sie Ihr Apps Script-Projekt.
   2. Klicken Sie auf Editor code.
   3. Eine Scriptdatei wird als Projektdatei mit dem Namen Code.gs angezeigt. Wählen Sie die Datei aus, um sie zu bearbeiten.

   4. Ersetzen Sie den gesamten Code im Script-Editor durch den folgenden Code, der die Daten in Ihrer Tabelle liest und als Eingabe an die Workflowausführung weitergibt:

      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. Ersetzen Sie your-project-id durch Ihre Google Cloud-Projekt-ID.

      Sie finden Ihre Projekt-ID auf der Willkommensseite der Google Cloud Console.

   6. Klicken Sie auf „Speichern“ save.

3. Mit installierbaren Triggern in Apps Script kann ein Scriptprojekt eine bestimmte Funktion ausführen, wenn bestimmte Bedingungen erfüllt sind, z. B. wenn eine Tabelle geöffnet oder bearbeitet wird. So erstellen Sie einen Trigger:

   1. Öffnen Sie Ihr Apps Script-Projekt.
   2. Klicken Sie auf Trigger alarm.
   3. Klicken Sie auf Trigger hinzufügen.
   4. Konfigurieren Sie im Dialogfeld Trigger für DEIN_PROJEKTNAMEN hinzufügen den Trigger:
      1. Wählen Sie in der Liste Auszuführende Funktion auswählen die Option handleEdit aus.
      2. Wählen Sie in der Liste Auszuführende Bereitstellung auswählen die Option Head aus.
      3. Wählen Sie in der Liste Ereignisquelle auswählen die Option Aus Tabelle aus.
      4. Wählen Sie in der Liste Ereignistyp auswählen die Option Beim Bearbeiten aus.
      5. Wählen Sie in der Liste Einstellungen für Fehlerbenachrichtigungen die Option Täglich benachrichtigen aus.
   5. Klicken Sie auf Speichern.

   6. Wenn Sie aufgefordert werden, ein Google-Konto auszuwählen, wählen Sie das entsprechende Konto aus und klicken Sie dann auf Zulassen.

      So kann Ihr Apps Script-Projekt Ihre Tabellen in Google Tabellen aufrufen, bearbeiten, erstellen und löschen sowie eine Verbindung zu einem externen Dienst herstellen.

4. Die Manifestdatei eines Apps Script-Projekts ist eine JSON-Datei, die grundlegende Projektinformationen enthält, die Apps Script zum Ausführen eines Scripts benötigt. Im Apps Script-Editor werden Manifestdateien standardmäßig ausgeblendet, um die Einstellungen Ihres Apps Script-Projekts zu schützen. Bearbeiten Sie die Manifestdatei:

   1. Öffnen Sie Ihr Apps Script-Projekt.
   2. Klicken Sie auf Projekteinstellungen settings.
   3. Klicken Sie das Kästchen Manifestdatei „appsscript.json“ im Editor anzeigen an.
   4. Klicken Sie auf Editor code.
   5. Die Manifestdatei wird als Projektdatei mit dem Namen appsscript.json angezeigt. Wählen Sie die Datei aus, um sie zu bearbeiten.

   6. Im Feld oauthScopes wird ein Array von Strings angegeben. Wenn Sie die Autorisierungsbereiche festlegen möchten, die in Ihrem Projekt verwendet werden, fügen Sie ein Array mit den Bereichen hinzu, die unterstützt werden sollen. Beispiel:

      {
        "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"
        ]
      }

      Dadurch werden die expliziten Bereiche auf Folgendes festgelegt:

      • Verbindung mit externem Dienst herstellen
      • Google Cloud-Daten abrufen, bearbeiten, konfigurieren und löschen sowie die E-Mail-Adresse Ihres Google-Kontos sehen
      • Alle Ihre Google Tabellen-Tabellen aufrufen, bearbeiten, erstellen oder löschen

   7. Klicken Sie auf „Speichern“ save.

Workflow bereitstellen, der eine VM-Instanz erstellt

Einen Workflow bereitstellen, der ausgelöst wird, wenn eine Anfrage zum Erstellen einer VM-Instanz genehmigt wird. Der Workflow ruft den Compute Engine API-Connector auf, um eine Compute Engine-VM-Instanz basierend auf den über das Formular erfassten Spezifikationen zu erstellen.

End-to-End-Vorgang testen

Führen Sie den gesamten Vorgang durch, um zu prüfen, ob alles wie erwartet funktioniert.

1. Senden Sie das Formular an sich selbst und beantworten Sie die Fragen entsprechend.

   Die Spezifikationen, die Sie zum Erstellen einer VM-Instanz verwenden, müssen gültig sein. Andernfalls schlägt die Workflowausführung fehl. Weitere Informationen finden Sie unter Compute Engine-Maschinenfamilie für allgemeine Zwecke.

2. Klicken Sie auf Senden, um Ihre Antwort zu senden.

3. Öffnen Sie Ihr Formular in Google Formulare.

4. Klicken Sie auf Antworten.

5. Klicken Sie auf In Google Tabellen ansehen.

   Die verknüpfte Tabelle wird geöffnet.

6. Klicken Sie in der Zeile für Ihre Antwort das Kästchen Genehmigt? an.

7. Öffnen Sie Ihr Apps Script-Projekt.

8. Klicken Sie auf Ausführungen playlist_play.

   Der Trigger sollte ausgeführt werden und den Status Completed haben.

9. Prüfen Sie, ob der create-vm-from-form-Workflow erfolgreich abgeschlossen wurde:

   Console

   1. Öffnen Sie in der Google Cloud Console die Seite Workflows.

      Zur Seite "Workflows"

   2. Klicken Sie auf der Seite Workflows auf den Workflow create-vm-from-form, um die Seite mit den Details aufzurufen.

   3. Klicken Sie auf der Seite Workflow-Details auf die entsprechende Ausführungs-ID, um die Details für eine bestimmte Ausführung abzurufen.

      Der Ausführungsstatus sollte Erfolgreich lauten. Im Eingabebereich sollten die von Ihnen angeforderten VM-Spezifikationen angezeigt werden.

   gcloud

   Rufen Sie eine Liste der Ausführungsversuche Ihres Workflows ab:

   gcloud workflows executions list create-vm-from-form

   Das Ergebnis sollte in etwa so aussehen:

   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. Prüfen Sie, ob eine neue VM wie erwartet erstellt wurde:

    Console

    Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

    Zu Seite „VM-Instanzen“

    Ihre VM-Instanz sollte mit dem Status „In Betrieb“ aufgeführt sein.

    gcloud

    So rufen Sie eine aggregierte Liste aller VMs in allen Zonen für ein Projekt ab:

    gcloud compute instances list

    Ihre VM-Instanz sollte mit dem Status „In Betrieb“ aufgeführt sein.

    Weitere Informationen zum Befehl gcloud compute instances list finden Sie auf der Referenzseite.