Automation Pipelines kann in VMware Aria Automation Orchestrator (Orchestrator) integriert werden, um die zugehörigen Funktionen durch Ausführung von Orchestrator-Workflows zu erweitern. VMware Aria Automation Orchestrator enthält viele vordefinierte Workflows, die in Tools von Drittanbietern integriert werden können. Diese Workflows helfen dabei, Ihre DevOps-Prozesse zu automatisieren und zu verwalten, Massenvorgänge zu automatisieren und vieles mehr.

Sie können beispielsweise einen Workflow in einer Orchestrator-Aufgabe in Ihrer Pipeline verwenden, um einen Benutzer zu aktivieren, einen Benutzer zu entfernen, VMs zu verschieben, in Test-Frameworks zu integrieren, um den Code während der Ausführung der Pipeline zu testen und vieles mehr. Um Codebeispiele für VMware Aria Automation Orchestrator-Workflows zu durchsuchen, wechseln Sie zu https://developer.broadcom.com/ und klicken Sie auf Codebeispiel.

Mit einem VMware Aria Automation Orchestrator-Workflow kann Ihre Pipeline eine Aktion ausführen, während diese Ihre Anwendung erstellt, testet und bereitstellt. Sie können vordefinierte Workflows in Ihre Pipeline aufnehmen oder benutzerdefinierte Workflows erstellen und verwenden. Jeder Workflow enthält Eingaben, Aufgaben und Ausgaben.

Um einem Orchestrator-Workflow in Ihrer Pipeline auszuführen, muss der Workflow in der Liste der verfügbaren Workflows in der Orchestrator-Aufgabe angezeigt werden, die Sie in Ihre Pipeline aufnehmen.

Bevor der Workflow in der Orchestrator-Aufgabe in Ihrer Pipeline angezeigt werden kann, muss ein Administrator die folgenden Schritte in VMware Aria Automation Orchestrator durchführen:

  1. Wenden Sie das CODESTREAM-Tag auf den Orchestrator-Workflow an.
  2. Markieren Sie den Orchestrator-Workflow als „global“.

Voraussetzungen

  • Stellen Sie sicher, dass Sie als Administrator auf eine lokale Instanz von VMware Aria Automation Orchestrator zugreifen können. Weitere Informationen erhalten Sie von Ihrem Administrator und in der vRealize Orchestrator-Dokumentation.
  • Vergewissern Sie sich, dass Sie Mitglied eines Projekts in Automation Pipelines sind. Falls nicht, bitten Sie einen Automation Pipelines-Administrator, Sie als Mitglied eines Projekts hinzuzufügen. Weitere Informationen hierzu finden Sie unter Vorgehensweise zum Hinzufügen eines Projekts in Automation Pipelines.
  • Erstellen Sie in Automation Pipelines eine Pipeline und fügen Sie eine Phase hinzu.

Prozedur

  1. Bereiten Sie als Administrator einen VMware Aria Automation Orchestrator-Workflow für die Ausführung Ihrer Pipeline vor.
    1. In VMware Aria Automation Orchestrator finden Sie den Workflow, den Sie in Ihrer Pipeline verwenden müssen, wie z. B. einen Workflow zum Aktivieren eines Benutzers.
      Wenn Sie einen Workflow benötigen, der nicht vorhanden ist, können Sie ihn erstellen.
    2. Geben Sie Tag-Workflow in der Suchleiste ein, um nach dem Workflow mit der Bezeichnung Tag-Workflow zu suchen.
    3. Klicken Sie auf der Karte mit dem Namen Tag-Workflow auf Ausführen, wodurch der Konfigurationsbereich angezeigt wird.
    4. Geben Sie im Textbereich Markierter Workflow den Namen des in der Automation Pipelines-Pipeline zu verwendenden Workflows ein und wählen Sie ihn dann in der Liste aus.
    5. Geben Sie in den Bereichen Tag und Wert die Bezeichnung CODESTREAM in Großbuchstaben ein.
    6. Aktivieren Sie das Kontrollkästchen mit dem Namen Globales Tag.
    7. Klicken Sie auf Ausführen, wodurch das Tag mit dem Namen CODESTREAM an den Workflow angehängt wird, den Sie in Ihrer Automation Pipelines-Pipeline auswählen müssen.
    8. Klicken Sie im Navigationsbereich auf Workflows und bestätigen Sie, dass das Tag mit dem Namen CODESTREAM auf der Workflow-Karte angezeigt wird, die von Ihrer Pipeline ausgeführt werden soll.
      Nachdem Sie sich bei Automation Pipelines angemeldet und eine Orchestrator-Aufgabe zu Ihrer Pipeline hinzugefügt haben, wird der getaggte Workflow in der Workflow-Liste angezeigt.
  2. Erstellen Sie in Automation Pipelines einen Endpoint für Ihre VMware Aria Automation Orchestrator-Instanz.
    1. Klicken Sie auf Endpoints > Neuer Endpoint.
    2. Wählen Sie ein Projekt aus.
    3. Geben Sie einen relevanten Namen ein.
    4. Geben Sie die URL des VMware Aria Automation Orchestrator-Endpoints ein.
      Verwenden Sie folgendes Format: https://orchestrator-appliance.yourdomain.local:8281
      Folgendes Format sollte nicht verwendet werden: https://orchestrator-appliance.yourdomain.local:8281/vco/api
      Bei der URL für eine VMware Aria Automation Orchestrator-Instanz, die in die VMware Aria Automation-Appliance eingebettet ist, handelt es sich um den FQDN für die Appliance ohne Port. Beispiel: https://automation-appliance.yourdomain.local/vco
      Für externe VMware Aria Automation Orchestrator-Appliances ab VMware Aria Automation 8.x lautet der FQDN für die Appliance https://orchestrator-appliance.yourdomain.local.
      Für externe VMware Aria Automation Orchestrator-Appliances, die im Lieferumfang von VMware Aria Automation 7.x enthalten sind, lautet der FQDN für die Appliance https://orchestrator-appliance.yourdomain.local:8281/vco.
      Wenn beim Hinzufügen des Endpoints ein Problem auftritt, müssen Sie unter Umständen eine YAML-Konfiguration mit einem Fingerabdruck für das SHA-256-Zertifikat importieren und die Doppelpunkte entfernen. Beispiel: B0:01:A2:72... wird zu B001A272.... Der YAML-Beispielcode ähnelt Folgendem: 
      ```
---
project: Demo
kind: ENDPOINT
name: external-orchestrator
description: ''
type: orchestrator
properties:
  url: https://yourVROhost.yourdomain.local
  username: yourusername
  password: yourpassword
  fingerprint: <your_fingerprint>
```
    5. Klicken Sie auf Zertifikat akzeptieren, wenn die von Ihnen eingegebene URL ein Zertifikat benötigt.
    6. Wenn der VMware Aria Automation Orchestrator-Endpoint Version 8.0 bis 8.7 ist, können Sie Standardauthentifizierung oder Token als Authentifizierungstyp auswählen. Wenn der VMware Aria Automation Orchestrator-Endpoint Version 8.8 oder höher aufweist, müssen Sie Token als Authentifizierungstyp auswählen.
      Hinweis: Wenn der VMware Aria Automation Orchestrator-Endpoint Version 8.8 oder höher aufweist, wählen Sie Standardauthentifizierung nicht aus. Die Standardauthentifizierung wird nicht unterstützt, und die Endpoint-Erstellung schlägt fehl.
      • Wenn Sie Standardauthentifizierung auswählen, geben Sie den Benutzernamen und das Kennwort für den VMware Aria Automation Orchestrator-Server ein.

        Wenn Sie einen nicht lokalen Benutzer für die Authentifizierung verwenden, müssen Sie den Domänenteil des Benutzernamens weglassen. Beispiel: Zur Authentifizierung mit [email protected] müssen Sie svc_vro im Textbereich Benutzername eingeben.

      • Erzeugen Sie bei Auswahl von Token für den Authentifizierungstyp das private Token.
        Das VMware Cloud Services-API-Token authentifiziert Sie für externe API-Verbindungen mit Automation Pipelines. So rufen Sie das API-Token ab:
        1. Klicken Sie auf Token generieren.
        2. Geben Sie die E-Mail-Adresse ein, die mit Ihrem Benutzernamen und Kennwort verknüpft ist, und klicken Sie auf Generieren.
          Das von Ihnen generierte Token ist sechs Monate lang gültig. Es wird auch als Aktualisierungstoken bezeichnet.
          • Um das Token als Variable für die spätere Verwendung beizubehalten, klicken Sie auf Variable erstellen, geben Sie einen Namen für die Variable ein und klicken Sie auf Speichern.
          • Um das Token als Textwert für die spätere Verwendung beizubehalten, klicken Sie auf Kopieren und fügen Sie das Token in eine Textdatei ein, um es lokal zu speichern.
          Sie haben die Möglichkeit, eine Variable zu erstellen und das Token in einer Textdatei zur späteren Verwendung zu speichern.
        3. Klicken Sie auf Schließen.
  3. Bereiten Sie Ihre Pipeline für die Ausführung der Orchestrator-Aufgabe vor.
    1. Fügen Sie Ihrer Pipeline-Phase eine Orchestrator-Aufgabe hinzu.
    2. Geben Sie einen relevanten Namen ein.
    3. Wählen Sie im Bereich „Workflow-Eigenschaften“ den VMware Aria Automation Orchestrator-Endpoint aus.
    4. Wählen Sie den Workflow aus, den Sie als CODESTREAM in VMware Aria Automation Orchestrator markiert haben.
      Wenn Sie einen von Ihnen erstellten benutzerdefinierten Workflow auswählen, müssen Sie möglicherweise die Eingabeparameterwerte eingeben.
    5. Klicken Sie für Aufgabe ausführen auf Bei Bedingung.
      Wenn Sie Bedingungen für die VMware Aria Automation Orchestrator-Aufgabe anwenden müssen, geben Sie sie in den Bereich Bedingung ein.
    6. Geben Sie die Bedingungen ein, die beim Ausführen der Pipeline angewendet werden.
      Pipeline ausführen... Bedingungen auswählen...
      Bei Bedingung

      Führt die Pipeline-Aufgabe nur aus, wenn die Auswertung der definierten Bedingung „true“ ergibt. Wenn die Bedingung „false“ lautet, wird die Aufgabe übersprungen.

      Die Orchestrator-Aufgabe ermöglicht es Ihnen, einen booleschen Ausdruck einzuschließen, der die folgenden Operanden und Operatoren verwendet.

      • Pipeline-Variablen, wie beispielsweise ${pipeline.variableName}. Verwenden Sie bei der Eingabe von Variablen nur geschweifte Klammern.
      • Aufgabenausgabe-Variablen, wie beispielsweise ${Stage1.task1.machines[0].value.hostIp[0]}.
      • Standard-Pipeline-Bindungsvariablen, wie beispielsweise ${releasePipelineName}.
      • Boolesche Werte, die der Groß-/Kleinschreibung unterliegen, wie beispielsweise true, false, 'true', 'false'.
      • Ganzzahl- oder Dezimalwerte ohne Anführungszeichen.
      • Zeichenfolgenwerte, die mit einfachen oder doppelten Anführungszeichen wie "test" oder 'test' verwendet werden.
      • Werte vom Typ „Zeichenfolge“ und „Numerisch“, wie beispielsweise == Equals und != Not Equals.
      • Relationale Operatoren wie >, >=, < und <=.
      • Boolesche Logik wie && und ||.
      • Arithmetische Operatoren wie +, -, * und /.
      • Geschachtelte Ausdrücke mit runden Klammern.
      • Zeichenfolgen, die den Literalwert ABCD enthalten, werden als falsch ausgewertet und die Aufgabe wird übersprungen.
      • Unäre Operatoren werden nicht unterstützt.

      Eine mögliche Beispielbedingung ist ${Stage1.task1.output} == “Passed” || ${pipeline.variableName} == 39

      Immer Wenn Sie Immer auswählen, führt die Pipeline die Aufgabe ohne Bedingungen aus.
    7. Geben Sie eine Nachricht für die Begrüßung ein.
    8. Klicken Sie auf Aufgabe validieren und beheben Sie alle auftretenden Fehler.
  4. Speichern, aktivieren Sie Ihre Pipeline aus und führen sie sie aus.
  5. Überprüfen Sie nach der Ausführung der Pipeline die Ergebnisse.
    1. Klicken Sie auf Ausführungen.
    2. Klicken Sie auf die Pipeline.
    3. Klicken Sie auf die Aufgabe.
    4. Untersuchen Sie die Ergebnisse, den Eingabewert und die Eigenschaften.
      Sie können die Ausführungs-ID des Workflows, die Person, die auf die Aufgabe reagiert hat, den Zeitpunkt der Reaktion und alle darin enthaltenen Kommentare identifizieren.

Ergebnisse

Herzlichen Glückwunsch! Sie haben einen VMware Aria Automation Orchestrator-Workflow für die Verwendung in Automation Pipelines getaggt und eine Orchestrator-Aufgabe in Ihrer Automation Pipelines-Pipeline hinzugefügt, sodass ein Workflow ausgeführt wird, der eine Aktion in Ihrer DevOps-Umgebung automatisiert.

Beispiel: Ausgabeformat der Orchestrator-Aufgabe

Das Ausgabeformat für eine Orchestrator-Aufgabe ähnelt diesem Beispiel. 

[{
                "name": "result",
                "type": "STRING",
                "description": "Result of workflow run.",
                "value": ""
},
{
                "name": "message",
                "type": "STRING",
                "description": "Message",
                "value": ""
}]

Nächste Maßnahme

Nehmen Sie weiterhin Orchestrator-Workflow-Aufgaben in Ihre Pipelines auf, damit Sie Aufgaben in Ihrer Entwicklungs-, Test- und Produktionsumgebung automatisieren können.