In diesem Verfahren wird dargestellt, wie Sie eine GitLab-Integration in Automation Assembler so konfigurieren, dass Sie im Repository mit Cloud-Vorlagen arbeiten und gespeicherte Vorlagen automatisch herunterladen können, die zugewiesenen Projekten zugeordnet sind. Zur Verwendung von Cloud-Vorlagen mit GitLab müssen Sie eine Verbindung zu einer geeigneten GitLab-Instanz herstellen und die gewünschten Vorlagen dann in dieser Instanz speichern.

Wenn die GitLab-Integration mit einem vorhandenen Repository konfiguriert ist, werden alle Cloud-Vorlagen, die mit den ausgewählten Projekten verknüpft sind, qualifizierten Benutzern zur Verfügung gestellt. Sie können diese Vorlagen mit einer vorhandenen Bereitstellung oder als Grundlage einer neuen Bereitstellung verwenden. Wenn Sie ein Projekt hinzufügen, müssen Sie einige Eigenschaften für den Speicherort und die Art der Speicherung in GitLab auswählen.

Hinweis: Sie können keine neuen oder aktualisierten Cloud-Vorlagen aus Automation Assembler in das Git-Repository übertragen. Sie können auch keine neuen Vorlagen aus Automation Assembler in das Repository übertragen. Um Cloud-Vorlagen zu einem Repository hinzuzufügen, müssen Entwickler die Git-Schnittstelle verwenden.

Wenn Sie einen von Git importierten Entwurf einer Cloud-Vorlage aktualisieren und deren Inhalt sich von dem in der höchsten Version unterscheidet, wird der Entwurf bei nachfolgenden Synchronisierungen nicht aktualisiert und es wird eine neue Version erstellt. Wenn Sie eine Cloud-Vorlage aktualisieren und auch weitere Synchronisierungen von Git zulassen möchten, müssen Sie nach den abschließenden Änderungen eine neue Version erstellen.

Nachdem Sie Ihre Cloud-Vorlagen für die Verwendung mit GitLab eingerichtet und die erforderlichen Informationen erfasst haben, müssen Sie die GitLab-Instanz integrieren. Anschließend können Sie die vorgesehenen Cloud-Vorlagen in GitLab importieren.

Voraussetzungen

  • Extrahieren Sie einen API-Schlüssel für das entsprechende Repository. Wählen Sie in Ihrem GitLab-Konto oben rechts Ihre Anmeldung aus und navigieren Sie zum Menü „Einstellungen“. Wählen Sie „Zugriffstoken“ aus, benennen Sie Ihr Token und legen Sie ein Ablaufdatum fest. Wählen Sie dann API aus und erstellen Sie das Token. Kopieren Sie den Ergebniswert und speichern Sie ihn.
Die Konfiguration eines geeigneten lokalen Git-Repositorys mit Zugriff für alle benannten Benutzer ist Voraussetzung für die Einrichtung der Git-Integration mit Automation Assembler. Außerdem müssen Sie Cloud-Vorlagen in einer bestimmten Struktur erstellen und speichern, damit sie von GitLab erkannt werden.

Prozedur

  1. Richten Sie die Integration mit Ihrer GitLab-Umgebung in Automation Assembler ein.
    1. Wählen Sie Infrastruktur > Integrationen > Neue hinzufügen und dann „GitLab“ aus.
    2. Geben Sie die URL für Ihre GitLab-Instanz ein. Für eine GitLab-SaaS-Instanz (Software as a Service) lautet diese in den meisten Fällen „gitlab.com“.
    3. Geben Sie das Token, das auch als API-Schlüssel bezeichnet wird, für die angegebene GitLab-Instanz ein. Informationen zum Extrahieren des Tokens aus Ihrer GitLab-Instanz finden Sie in den obigen Voraussetzungen.
    4. Fügen Sie einen geeigneten Namen und eine geeignete Beschreibung hinzu.
    5. Klicken Sie auf Überprüfen, um die Verbindung zu überprüfen.
    6. Fügen Sie bei Bedarf Funktions-Tags hinzu. Weitere Informationen hierzu finden Sie unter Verwenden von Funktions-Tags in Automation Assembler.
    7. Klicken Sie auf Hinzufügen.
  2. Konfigurieren Sie die GitLab-Verbindung so, dass Cloud-Vorlagen in einem geeigneten Repository akzeptiert werden.
    1. Wählen Sie Infrastruktur > Integrationen und dann die entsprechende GitLab-Integration aus.
    2. Wählen Sie Projekte aus.
    3. Wählen Sie Neues Projekt aus und erstellen Sie einen Namen für das Projekt.
    4. Geben Sie den Pfad des Repositorys innerhalb von GitLab ein. In der Regel ist dies der Benutzername des Hauptkontos, der an den Namen des Repositorys angehängt wird.
    5. Geben Sie die entsprechende GitLab-Verzweigung ein, die verwendet werden soll.
    6. Geben Sie gegebenenfalls unter Ordner einen Namen ein. Wenn Sie dieses Feld leer lassen, stehen alle Ordner zur Verfügung.
    7. Geben Sie einen geeigneten Typ ein. Geben Sie gegebenenfalls einen Ordnernamen ein. Wenn Sie dieses Feld leer lassen, stehen alle Ordner zur Verfügung.
    8. Klicken Sie auf Weiter, um das Hinzufügen des Repositorys abzuschließen.
      Wenn Sie auf Weiter klicken, wird eine automatisierte Synchronisierungsaufgabe initiiert, die Cloud-Vorlagen in die Plattform importiert.
      Nach Abschluss der Synchronisierungsaufgaben wird eine Meldung mit dem Hinweis angezeigt, dass die Cloud-Vorlagen importiert wurden.

Ergebnisse

Sie können jetzt Cloud-Vorlagen aus GitLab abrufen.