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. Sie können Codebeispiele für VMware Aria Automation Orchestrator-Workflows in code.vmware.com durchsuchen.

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 PIPELINES-Tag auf den Orchestrator-Workflow an.
  2. Markieren Sie den Orchestrator-Workflow als „global“.

Als lokaler Endpoint muss VMware Aria Automation Orchestrator mit Automation Pipelines über einen Cloud-Proxy kommunizieren.

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 VMware Aria Automation Assembler einen Cloud-Proxy, der die Kommunikation zwischen Automation Pipelines und der lokalen Instanz von VMware Aria Automation Orchestrator ermöglicht. Ein Beispiel dafür, wie ein Cloud-Proxy erstellt wird, finden Sie unter Einrichten von Automation Pipelines zum Modellieren des Freigabeprozesses.
  • Verstehen Sie, wie wichtig die Verwendung eines Cloud-Proxys für einen lokalen Endpoint ist. Weitere Informationen hierzu finden Sie unter Definition von Endpoints 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 Textbereichen Tag und Wert das Wort PIPELINES 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 PIPELINES 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 PIPELINES 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. Wählen Sie einen Cloud-Proxy aus.
    6. Klicken Sie auf Zertifikat akzeptieren, wenn die von Ihnen eingegebene URL ein Zertifikat benötigt.
    7. 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 und fügen Sie es sein.
        Das VMware Cloud Services-API-Token authentifiziert Sie für externe API-Verbindungen mit Automation Pipelines. So rufen Sie das API-Token ab:
        1. Melden Sie sich bei VMware Aria Automation an.
        2. Anmelden bei
        3. Klicken Sie auf den Dropdown-Pfeil neben Ihrem Namen.
        4. Klicken Sie auf Mein Konto.
        5. Klicken Sie auf API-Token.
        6. Klicken Sie auf Neues API-Token generieren.
          1. Geben Sie einen Namen für das Token ein.
          2. Klicken Sie unter „Organisationsrollen“ auf den Menüpunkt Alle Organisationsrollen, um ihn zu erweitern, und wählen Sie Organisationsbesitzer aus.
          3. Klicken Sie unter „Dienstrollen“ auf den Menüpunkt VMware Aria Automation > Pipelines, um ihn zu erweitern, und wählen Sie Pipelines-Administrator aus.
          4. Klicken Sie auf Generieren.

            Im Fenster Generiertes Token wird ein Token mit dem von Ihnen angegebenen Namen und dem Namen Ihrer Organisation angezeigt.

        7. Klicken Sie auf das Symbol KOPIEREN.

          Durch Klicken auf KOPIEREN wird sichergestellt, dass die exakte Zeichenfolge erfasst wird. Dies ist zuverlässiger als die Verwendung des Mauszeigers zum Kopieren der Zeichenfolge.

  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 in VMware Aria Automation Orchestratorals PIPELINES 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.