Workflow erstellen und aktualisieren

Auf dieser Seite wird beschrieben, wie Sie einen Workflow erstellen und einen vorhandenen Workflow in der Google Cloud Console oder mit der Befehlszeile von Google Cloud aktualisieren.

Hinweis

Einige der Schritte in diesem Dokument funktionieren möglicherweise nicht richtig, wenn Ihre Organisation Einschränkungen auf Ihre Google Cloud-Umgebung anwendet. In diesem Fall können Sie möglicherweise keine Aufgaben wie das Erstellen öffentlicher IP-Adressen oder Dienstkontoschlüssel ausführen. Wenn Sie eine Anfrage stellen, die einen Fehler zu Einschränkungen zurückgibt, lesen Sie, wie Anwendungen in einer eingeschränkten Google Cloud-Umgebung entwickeln werden.

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
  2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

  4. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  5. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.

  6. Workflows API aktivieren

    Workflows API aktivieren

Dienstkonto erstellen

Erstellen Sie ein Dienstkonto, falls Sie noch keines haben. Anschließend weisen Sie ihm die Rollen zu, die zum Verwalten von Workflows und zum Erstellen von Logs erforderlich sind.

Console

  1. Rufen Sie in der Cloud Console die Seite Dienstkonten auf.

    Zur Seite „Dienstkonten“

  2. Wählen Sie ein Projekt aus und klicken Sie auf Dienstkonto erstellen.

  3. Geben Sie im Feld Dienstkontoname einen Namen ein.

    Der Name muss zwischen 6 und 30 Zeichen lang sein und alphanumerische Zeichen in Kleinschreibung sowie Bindestriche enthalten. Nachdem Sie ein Dienstkonto erstellt haben, können Sie den Namen nicht mehr ändern.

  4. Klicken Sie auf Erstellen und fortfahren.

  5. Klicken Sie auf Rolle auswählen und wählen Sie eine der folgenden Rollen aus:

    Wenn Sie eine Produktionsanwendung entwickeln, gewähren Sie immer die geringstmöglichen Rollen. Weitere Informationen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten. Eine Liste der Workflow-Rollen finden Sie in der Referenz zur Zugriffssteuerung.

  6. Klicken Sie auf Fertig, um das Erstellen des Dienstkontos abzuschließen.

gcloud

  1. Erstellen Sie das Dienstkonto.

    gcloud iam service-accounts create NAME
  2. Gewähren Sie dem Dienstkonto Berechtigungen, indem Sie eine Rolle zuweisen.

    gcloud projects add-iam-policy-binding PROJECT_ID \
       --member "serviceAccount:NAME@PROJECT_ID.iam.gserviceaccount.com" \
       --role "roles/logging.logWriter"
    

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die Projekt-ID
    • NAME: der Name des Dienstkontos Der Name des Dienstkontos muss zwischen 6 und 30 Zeichen lang sein und darf alphanumerische Zeichen in Kleinschreibung sowie Bindestriche enthalten. Nachdem Sie ein Dienstkonto erstellt haben, können Sie den Namen nicht mehr ändern.

    Mit dem Flag --role wird Ihr Dienstkonto für den Zugriff auf Ressourcen autorisiert.

    Wenn Sie eine Produktionsanwendung entwickeln, gewähren Sie immer die geringstmöglichen Rollen. Weitere Informationen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten. Eine Liste der Workflow-Rollen finden Sie in der Referenz zur Zugriffssteuerung.

Workflow erstellen

Ein Workflow besteht aus einer Reihe von Schritten, die mit der Workflows-Syntax beschrieben werden. Diese kann entweder im YAML- oder JSON-Format geschrieben werden. Nachdem Sie einen Workflow erstellt haben, stellen Sie ihn bereit, um ihn für die Ausführung verfügbar zu machen. Der Bereitstellungsschritt überprüft auch, ob die Quelldatei ausgeführt werden kann. Es schlägt fehl, wenn die Quelldatei keine gültige Workflowdefinition enthält.

Console

  1. Rufen Sie in der Cloud Console die Seite Workflows auf:

    Zur Seite "Workflows"

  2. Wählen Sie Erstellen.

  3. Geben Sie einen Namen für den neuen Workflow ein, z. B. myFirstWorkflow. Der Name kann Buchstaben, Zahlen, Unterstriche und Bindestriche enthalten. Muss mit einem Buchstaben beginnen und mit einer Zahl oder einem Buchstaben enden.

  4. Wählen Sie eine geeignete Region aus, z. B. us-central1.

  5. Wählen Sie das Dienstkonto aus, das Ihr Workflow für die Authentifizierung mit anderen Google Cloud-Diensten verwenden soll. Es wird dringend empfohlen, ein Dienstkonto mit den geringsten Berechtigungen zu verwenden, die für den Zugriff auf die erforderlichen Ressourcen erforderlich sind. Weitere Informationen zu Dienstkonten finden Sie unter Dienstkonten erstellen und verwalten.

  6. Wählen Sie Weiter.

  7. Geben Sie im Workflow-Editor die Definition für Ihren Workflow ein. Auf der Seite Kurzanleitung: Workflow in der Cloud Console erstellen finden Sie einen Beispielworkflow.

  8. Wählen Sie Bereitstellen.

gcloud

  1. Achten Sie darauf, dass der Quellcode Ihres Workflows in einer YAML- oder JSON-Datei gespeichert ist, z. B. MY_WORKFLOW.YAML oder MY_WORKFLOW.JSON. Einen Beispielworkflow finden Sie in der Seite Kurzanleitung: Workflow mit der gcloud CLI erstellen.

  2. Öffnen Sie ein Terminalfenster.

  3. Stellen Sie den Workflow bereit. Geben Sie hierzu den folgenden Befehl ein:

    gcloud workflows deploy MY_WORKFLOW \
       --source=MY_WORKFLOW.YAML \
       --service-account=MY_SERVICE_ACCOUNT@MY_PROJECT.IAM.GSERVICEACCOUNT.COM
    

    Ersetzen Sie Folgendes:

    • MY_WORKFLOW: Der Name Ihres Workflows.

    • MY_WORKFLOW.YAML: Die Quelldatei, die für den Workflow verwendet werden soll.

    • MY_SERVICE_ACCOUNT@MY_PROJECT.IAM.GSERVICEACCOUNT.COM: Optional. Das Dienstkonto, mit dem Ihr Workflow auf andere Google Cloud-Dienste zugreift. Es wird dringend empfohlen, ein Dienstkonto mit den geringsten Berechtigungen zu verwenden, die für den Zugriff auf die erforderlichen Ressourcen erforderlich sind. Wenn Sie dieses Feld leer lassen, wird das Standarddienstkonto verwendet. Weitere Informationen zu Dienstkonten finden Sie unter Dienstkonten erstellen und verwalten.

Workflow aktualisieren

Sie können einen vorhandenen Workflow aktualisieren, um die Quelle, die Beschreibung, die Labels oder das zugehörige Dienstkonto zu ändern. Das Aktualisieren eines Workflows wirkt sich nicht auf laufende Ausführungen aus. Nur die zukünftigen Ausführungen des Workflows verwenden die aktualisierten Konfigurationen.

Console

  1. Rufen Sie in der Cloud Console die Seite Workflows auf:

    Zur Seite "Workflows"

  2. Wählen Sie den Namen des Workflows aus, den Sie aktualisieren möchten.

  3. Auf der Seite Workflow bearbeiten können Sie die Beschreibung bearbeiten, das Dienstkonto aktualisieren, das der Workflow zur Authentifizierung verwendet, oder ein Label hinzufügen oder aktualisieren. Sie können den Namen des Workflows nicht bearbeiten.

    Labels sind Schlüssel/Wert-Paare, mit denen Sie Ihre Google Cloud-Instanzen organisieren können. Weitere Informationen finden Sie unter Labels erstellen und verwalten.

  4. Wählen Sie Weiter aus, wenn Sie die ersten Updates ausgeführt haben.

  5. Um die Quelle des Workflows zu bearbeiten, aktualisieren Sie den Quellcode im Workflow-Editor.

  6. Wählen Sie Bereitstellen.

gcloud

  1. Suchen Sie die YAML- oder JSON-Datei, in der die aktualisierte Workflowquelle gespeichert ist, z. B. WORKFLOW_FILE.YAML oder WORKFLOW_FILE.JSON.

  2. Öffnen Sie ein Terminalfenster.

  3. Suchen Sie den Namen des Workflows, den Sie aktualisieren möchten. Wenn Sie den Namen des Workflows nicht kennen, können Sie den folgenden Befehl eingeben, um alle Workflows aufzulisten:

    gcloud workflows list
    
  4. Sie können die Quelle, das zugehörige Dienstkonto, die Beschreibung oder die Labels eines Workflows aktualisieren:

    gcloud workflows deploy WORKFLOW_NAME \
       --source=WORKFLOW_FILE.YAML \
       --service-account=MY_SERVICE_ACCOUNT@MY_PROJECT.IAM.GSERVICEACCOUNT.COM \
       --labels=KEY=VALUE... \
       --description='WORKFLOW_DESCRIPTION'
    

    Ersetzen Sie Folgendes:

    • WORKFLOW_NAME: erforderlich. Der Name Ihres Workflows.

    • WORKFLOW_FILE.YAML: erforderlich. Die Quelldatei für den Workflow.

    • MY_SERVICE_ACCOUNT@MY_PROJECT.IAM.GSERVICEACCOUNT.COM: Optional. Das Dienstkonto, mit dem Ihr Workflow auf andere Google Cloud-Dienste zugreift. Weitere Informationen zu Dienstkonten finden Sie unter Dienstkonten erstellen und verwalten.

    • KEY=VALUE: optional. KEY=VALUE Labels in einer durch Kommas getrennten Liste, wenn Sie mehrere hinzufügen. Mithilfe von Labels können Sie Ihre Google Cloud-Instanzen organisieren. Weitere Informationen finden Sie unter Labels erstellen und verwalten.

    • WORKFLOW_DESCRIPTION: optional. Die Beschreibung, die Sie Ihrem Workflow geben möchten.

    Sie müssen den Namen des zu aktualisierenden Workflows und seine Quelle angeben. Die restlichen Flags sind jedoch optional.

Jedes Mal, wenn Sie einen Workflow aktualisieren, wird dessen versionID aktualisiert. Der versionID besteht aus zwei Teilen, die durch einen Bindestrich getrennt sind:

  • Eine Zahl, beginnend bei 1, die jedes Mal erhöht wird, wenn Sie einen Workflow aktualisieren.

  • Ein zufälliger, dreistelliger alphanumerischer String.

Beispiel: 000002-d52 gibt einen Workflow an, der einmal aktualisiert wurde. 000001-27f gibt einen Workflow in der ursprünglichen Version an.

Weitere Informationen