Workflow über Google Tabellen auslösen

Formular zum Anfordern von VM-Instanzen erstellen

Erstellen Sie ein Formular, mit dem Sie eine Anfrage zur Erstellung eines Compute Engine-VM-Instanz Wenn Sie ein Formular über Google Formulare erstellen, Google Drive

1. Rufen Sie forms.google.com auf.
2. Klicken Sie auf Leer.

   Ein neues Formular wird geöffnet.

3. Erstellen Sie ein Formular mit fünf Pflichtfeldern. Das Formular sollte ähnlich aussehen, in:

   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
   Laufwerksgröße (GB)	Kurzantworttext
   Betriebssystem	Drop-down-Menü: debian-10 Centos-Stream-9 COS-93-LTS COS-97-LTS

4. Aktivieren Sie die Erfassung von E-Mail-Adressen, um die E-Mail-Adressen der Personen zu erfassen, die das Formular ausfüllen. in Ihr Formular:
   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 Formular verknüpfen

Nachdem Sie ein Formular erstellt haben, können Sie eine Tabelle damit verknüpfen, in dieser Tabelle. Die Tabelle wird gespeichert in Google Drive

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 Neu erstellen Tabelle.

5. Klicken Sie auf Erstellen.

   Die verknüpfte Tabelle wird geöffnet.

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

7. Platzieren Sie den Cursor in der ersten Zeile von Spalte H und wählen Sie Einfügen > Kästchen.

   Die Tabelle sollte in etwa so aussehen:

   

   Jedes Mal, wenn das Tabellenblatt mit einer Antwort aktualisiert wird, wird das Kästchen ebenfalls angezeigt in die Zeile für diese Antwort ein.

Google Tabellen mit Apps Script erweitern

Mit Apps Script können Sie Inhalte programmatisch erstellen, lesen und bearbeiten Google Tabellen. Die meisten für Google Tabellen entwickelten Skripts Arrays, um mit den Zellen, Zeilen und Spalten in einer Tabellenkalkulation zu interagieren. Für eine eine Einführung in die Verwendung von Apps Script mit Google Tabellen, siehe Kurzanleitung zu benutzerdefinierten Funktionen

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

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

   Das Skript ist jetzt mit Ihrer Tabelle verbunden. mit der das Skript die Benutzeroberfläche oder wenn die Tabelle geöffnet wird.

   Ein Skriptprojekt repräsentiert eine Sammlung von Apps Script Dateien und Ressourcen. Codedateien in einem Skriptprojekt haben einen .gs .

2. Mit Apps Script können Sie benutzerdefinierte Funktionen schreiben, die in Google Tabellen genauso wie eine integrierte Funktion verwendet werden kann. Benutzerdefinierte Funktionen sind die mit Standard-JavaScript erstellt wurden. Erstellen Sie eine Funktion:

   1. Öffnen Sie Ihr Apps Script-Projekt.
   2. Klicken Sie auf Bearbeiter code.
   3. Eine Skriptdatei wird als Projektdatei mit dem Namen Code.gs angezeigt. So bearbeiten Sie die Datei: wählen Sie es aus.

   4. Ersetzen Sie jeden Code im Script-Editor durch den folgenden Code, der Folgendes liest: Daten in Ihrer Tabellenkalkulation und übergibt sie als Eingabe an einen Workflow Ausführung:

      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. Google Apps-Skript installierbare Trigger Ein Skriptprojekt soll eine bestimmte Funktion ausführen, wenn bestimmte Bedingungen erfüllt sind z. B. wenn eine Tabelle geöffnet oder bearbeitet wird. 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 YOUR_PROJECT_NAME den Trigger:
      1. Wählen Sie in der Liste Auswählen, welche Funktion ausgeführt werden soll die Option handleEdit aus.
      2. Wählen Sie in der Liste Auswählen, welche Bereitstellung ausgeführt werden soll 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 Benachrichtigungseinstellungen bei Fehlern 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 und klicken Sie dann auf Zulassen.

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

4. Eine Manifestdatei eines Apps Script-Projekts ist eine JSON-Datei mit grundlegenden Projektinformationen, Apps Script muss ein Script erfolgreich ausführen. Das Feld Im Apps Script-Editor werden Manifestdateien standardmäßig ausgeblendet, um Apps Script zu schützen Projekteinstellungen. Bearbeiten Sie die Manifestdatei:

   1. Öffnen Sie Ihr Apps Script-Projekt.
   2. Klicken Sie auf Projekteinstellungen settings.
   3. Aktivieren Sie das Kontrollkästchen "appsscript.json" anzeigen Manifestdatei im Editor an.
   4. Klicken Sie auf Bearbeiter code.
   5. Die Manifestdatei wird als Projektdatei mit dem Namen appsscript.json angezeigt. Bis die Datei bearbeiten, wählen Sie sie aus.

   6. Das Feld oauthScopes gibt ein Array von Strings an. So legen Sie den Autorisierungsbereiche Ihrem Projekt verwenden, 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 explizite Bereiche festgelegt auf:

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

   7. Klicken Sie auf „Speichern“ save.

Workflow zum Erstellen einer VM-Instanz bereitstellen

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

End-to-End-Ablauf testen

Prüfen Sie, ob alles wie erwartet funktioniert, indem Sie den gesamten .

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

   Prüfen Sie, ob die Spezifikationen, die Sie zum Erstellen einer VM-Instanz verwenden, gültig sind. Andernfalls schlägt die Workflowausführung fehl. Weitere Informationen finden Sie unter Compute Engine-Maschinen 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 und mit dem Status Completed aufgeführt werden.

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 das create-vm-from-form, um die zugehörige Detailseite aufzurufen.

   3. So rufen Sie auf der Seite Workflowdetails die Details für eine klicken Sie auf die entsprechende Ausführungs-ID.

      Der Ausführungsstatus sollte Erfolgreich lauten. sollten Sie die angeforderten VM-Spezifikationen sehen.

   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 wie erwartet eine neue VM erstellt wurde:

    Console

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

    Zu Seite „VM-Instanzen“

    Ihre VM-Instanz sollte mit einem Status aufgeführt sein, der angibt, dass sie ausgeführt wird.

    gcloud

    Rufen Sie eine zusammengefasste Liste aller VMs in allen Zonen für ein Projekt ab:

    gcloud compute instances list

    Ihre VM-Instanz sollte mit einem Status aufgeführt sein, der angibt, dass sie ausgeführt wird.

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