Zusätzlich zu den Cloud Assembly-Cloud-Vorlagenressourcen, die Sie bei der Erstellung von Cloud-Vorlagen verwenden, können Sie auch Ihre eigenen benutzerdefinierten Ressourcen erstellen.

Bei benutzerdefinierten Ressourcen handelt es sich um vRealize Orchestrator- oder Erweiterbarkeitsaktionsobjekte, die über vRealize Automation mit den in der benutzerdefinierten Ressource definierten Lebenszyklusaktionen verwaltet werden können. Der Cloud-Vorlagendienst ruft automatisch die entsprechenden vRealize Orchestrator-Workflows oder Erweiterbarkeitsaktionen auf, wenn der mit einer bestimmten Lebenszyklusaktion verknüpfte Vorgang ausgelöst wird. Sie können die Funktionalität des Ressourcentyps erweitern, indem Sie auch vRealize Orchestrator-Workflows oder Erweiterbarkeitsaktionen auswählen, die als Tag-2-Vorgänge verwendet werden können.

In diesem Anwendungsbeispiel werden integrierte, in der vRealize Orchestrator-Bibliothek bereitgestellte Workflows verwendet. Es umfasst vorgegebene Werte oder Zeichenfolgen, um darzustellen, wie der Prozess ausgeführt werden kann. Sie können sie so anpassen, dass sie sich für Ihre Umgebung eignen.

Zu Referenzzwecken verwendet dieses Anwendungsbeispiel ein Projekt mit dem Namen DevOpsTesting. Sie können dieses Beispielprojekt durch ein beliebiges Projekt in Ihrer Umgebung ersetzen.

Voraussetzungen

  • Vergewissern Sie sich, dass Sie eine vRealize Orchestrator-Integration konfiguriert haben. Weitere Informationen hierzu finden Sie unter Konfigurieren einer vRealize Orchestrator-Integration in Cloud Assembly.
  • Stellen Sie sicher, dass die Workflows, die Sie für die Aktionen zum Erstellen, Aktualisieren und Löschen verwenden, und die Tag-2-Aktionen in vRealize Orchestrator vorhanden sind und erfolgreich von dort aus ausgeführt werden.
  • Suchen Sie in vRealize Orchestrator den Ressourcentyp, der von den Workflows verwendet wird. Die in dieser benutzerdefinierten Ressource enthaltenen Workflows müssen alle denselben Ressourcentyp verwenden. In diesem Anwendungsbeispiel lautet der Ressourcentyp AD:User. Weitere Informationen zur Validierung des Ressourcentyps finden Sie unter Benutzerdefinierte Ressourcentypen für Cloud Assembly-Cloud-Vorlagen.
  • Konfigurieren Sie mithilfe der integrierten Active Directory-Workflows in Ihrer vRealize Orchestrator-Integration einen Active Directory-Server.
  • Stellen Sie sicher, dass Sie das Verfahren zum Konfigurieren und Bereitstellen einer Cloud-Vorlage für Maschinen kennen.

Prozedur

  1. Erstellen Sie eine benutzerdefinierte Ressource für Active Directory, um einen Benutzer in einer Gruppe hinzuzufügen.
    In diesem Schritt wird die benutzerdefinierte Ressource als Ressourcentyp zur Design-Arbeitsfläche der Cloud-Vorlage hinzugefügt.
    1. Wählen Sie in Cloud Assembly die Option Design > Benutzerdefinierte Ressourcen und klicken Sie auf Neue benutzerdefinierte Ressource.
    2. Stellen Sie die folgenden Werte bereit.

      Beachten Sie, dass es sich mit Ausnahme der Workflow-Namen um Beispielwerte handelt.

      Einstellung Beispielwert
      Name AD-Benutzer

      Dies ist der Name, der in der Ressourcentyppalette der Cloud-Vorlage angezeigt wird.
      Ressourcentyp Custom.ADUser

      Der Ressourcentyp muss mit Custom. beginnen und jeder Ressourcentyp muss eindeutig sein.

      Obwohl die Aufnahme von Custom. im Textfeld nicht validiert ist, wird die Zeichenfolge automatisch hinzugefügt, wenn Sie sie entfernen.

      Dieser Ressourcentyp wird der Ressourcentyppalette hinzugefügt, damit Sie ihn in der Cloud-Vorlage verwenden können.

    3. Zum Aktivieren dieses Ressourcentyps in der Liste der Ressourcentypen für Cloud-Vorlagen stellen Sie sicher, dass die Option Aktivieren ausgewählt ist.
    4. Wählen Sie die Einstellung Geltungsbereich aus, die den Ressourcentyp für beliebige Projekte zur Verfügung stellt.
    5. Stellen Sie unter Basierend auf sicher, dass vRO-Bestandsliste als Anbieter der Lebenszyklusaktion ausgewählt wurde.
    6. Konfigurieren Sie die Workflows, die die Ressource und die Tag-2-Aktionen definieren.
      Hinweis: Die ausgewählten Tag-2-Workflows müssen über einen Eingabeparameter verfügen, der vom selben Typ wie der externe Typ ist. Die Eingabe des externen Typs wird nicht in dem vom Benutzer angeforderten benutzerdefinierten Formular für Tag 2 angezeigt, da sie automatisch an die benutzerdefinierte Ressource gebunden ist.
      Einstellung Beispielwert
      Lebenszyklusaktionen – Erstellen Wählen Sie den Workflow Benutzer mit Kennwort in einer Organisationseinheit erstellen aus.

      Wenn Sie über mehrere vRealize Orchestrator-Integrationen verfügen, wählen Sie den Workflow der Integrationsinstanz aus, die Sie zum Ausführen dieser benutzerdefinierten Ressourcen verwenden.

      Nach dem Auswählen des Workflows wird das Dropdown-Menü für den externen Typ verfügbar und automatisch auf AD:User festgelegt.

      Hinweis: Ein externer Quelltyp kann nur einmal bei gemeinsamer Nutzung und einmal pro Projekt verwendet werden. In diesem Anwendungsbeispiel stellen Sie dieselbe benutzerdefinierte Ressource für alle Projekte bereit. Dies bedeutet jedoch, dass Sie AD:User für keine anderen Ressourcentypen in allen Projekten verwenden können. Wenn Sie über andere Workflows verfügen, die den Typ AD:User benötigen, müssen Sie einzelne benutzerdefinierte Ressourcen für jedes Projekt erstellen.
      Lebenszyklusaktionen – Löschen Wählen Sie den Workflow Benutzer löschen aus.
      Zusätzliche Aktionen Wählen Sie den Workflow Benutzerkennwort löschen aus.

      Fügen Sie im Fenster Aktion hinzufügen einen Namen für die Aktion hinzu, wie z. B. password_change, und klicken Sie auf Hinzufügen.

      Um das Anforderungsformular für die Aktion zu ändern, auf das der Benutzer antwortet, wenn er diese Aktion anfordert, klicken Sie auf das Symbol in der Spalte Anforderungsparameter.
      Hinweis: Stellen Sie bei Workflows für zusätzliche Aktionen sicher, dass der Workflow über einen Eingabeparameter mit demselben Typ wie der externe Typ verfügt.

      In diesem Beispiel steht keine geeignete Anwendung eines Aktualisierungsworkflows zur Verfügung. Ein häufiges Beispiel für einen Aktualisierungsworkflow, bei dem Änderungen an der bereitgestellten benutzerdefinierten Ressource vorgenommen werden, ist die vertikale oder horizontale Skalierung einer Bereitstellung.

    7. Überprüfen Sie den Schemaschlüssel und geben Sie Werte auf der Registerkarte Eigenschaften ein, um die Workflow-Eingaben zu verstehen, die in der Cloud-Vorlage konfiguriert werden können.
      Das Schema listet die erforderlichen und optionalen Eingabewerte auf, die im Workflow definiert sind. Die erforderlichen Eingabewerte sind in der YAML der Cloud-Vorlage enthalten.

      Im Workflow „Benutzer erstellen“ stellen accountName, displayName und ouContainer erforderliche Eingabewerte dar. Die anderen Schemaeigenschaften sind nicht erforderlich. Sie können das Schema auch verwenden, um zu ermitteln, wo Bindungen mit anderen Feldwerten, Workflows oder Aktionen erstellt werden sollen. Bindungen sind in diesem Anwendungsfall nicht enthalten.

    8. Um die Erstellung Ihrer benutzerdefinierten Ressource abzuschließen, klicken Sie auf Erstellen.
  2. Erstellen Sie eine Cloud-Vorlage, die den Benutzer bei der Bereitstellung zu einer Maschine hinzufügt.
    1. Wählen Sie Design > Cloud-Vorlagen aus und klicken Sie auf Neu aus > Leere Arbeitsfläche.
    2. Geben Sie der Cloud-Vorlage den Namen Maschine mit AD-Benutzer .
    3. Wählen Sie das Projekt DevOpsTesting aus und klicken Sie auf Erstellen.
    4. Fügen Sie eine vSphere-Maschine hinzu und konfigurieren Sie sie.
    5. Ziehen Sie in der Liste mit den benutzerdefinierten Ressourcen links auf der Seite „Cloud-Vorlagendesign“ den Ressourcentyp AD-Benutzer auf die Arbeitsfläche.
      Hinweis: Sie können die benutzerdefinierte Ressource auswählen, indem Sie entweder im linken Fensterbereich nach unten scrollen und sie dann auswählen, oder indem Sie im Textfeld Ressourcentypen durchsuchen suchen. Falls die benutzerdefinierte Ressource nicht angezeigt wird, klicken Sie auf die Schaltfläche „Aktualisieren“ neben dem Textfeld Ressourcentypen durchsuchen.
    6. Bearbeiten Sie auf der rechten Seite den YAML-Code, um die obligatorischen Eingabewerte und das Kennwort hinzuzufügen.
      Fügen Sie einen inputs-Abschnitt im Code hinzu, damit Benutzer den Namen der Benutzer angeben können, die sie hinzufügen. Im folgenden Beispiel handelt es sich bei einigen dieser Werte um Beispieldaten. Ihre Werte können davon abweichen. 
      inputs:
  accountName:
    type: string
    title: Account name
    encrypted: true   
  displayName:
    type: string
    title: Display name   
  password:
    type: string
    title: Password
    encrypted: true 
  confirmPassword:
    type: string
    title: Password
    encrypted: true   
  ouContainer: 
    type: object
    title: AD OU container
    $data: 'vro/data/inventory/AD:OrganizationalUnit'
    properties:
        id:
            type: string
        type:
            type: string
    7. Fügen Sie im Abschnitt resources den Code ${input.input-name} hinzu, um die Benutzerauswahl zu bestätigen. 
      resources:
  Custom_ADUser_1:
    type: Custom.ADUser
    properties:
        accountName: '${input.accountName}'
        displayName: '${input.displayName}'
        ouContainer: '${input.ouContainer}'
        password: '${input.password}'
        confirmPassword: '${input.confirmPassword}'
  3. Stellen Sie die Cloud-Vorlage bereit.
    1. Klicken Sie auf der Seite des Cloud-Vorlagen-Designers auf Bereitstellen.
    2. Geben Sie als Name der Bereitstellung AD User Scott ein.
    3. Wählen Sie die Version der Cloud-Vorlage aus und klicken Sie auf Weiter.
    4. Vervollständigen Sie die Eingaben der Bereitstellung.
    5. Klicken Sie auf Bereitstellen.
  4. Überwachen Sie die Bereitstellungsanforderung auf der Seite Bereitstellungen, um sicherzustellen, dass der Benutzer zu Active Directory hinzugefügt wurde und die Bereitstellung erfolgreich ist.

Nächste Maßnahme

Wenn die getestete Cloud-Vorlage funktioniert, können Sie die benutzerdefinierte Ressource AD-Benutzer für andere Cloud-Vorlagen verwenden.