Remote-Git-Repository im Control Room konfigurieren

Konfigurieren Sie ein Remote-Git-Repository im Control Room, damit Sie alle Bots und deren Abhängigkeiten versionieren und im Git-Repository speichern können. Zusätzlich zum lokalen Automation 360-Repository im Control Room bietet das Remote-Git ein Backup für die Bots und deren Abhängigkeiten.

Vorbereitungen

  • Vergewissern Sie sich vor der Konfiguration eines Remote-Git-Repositorys im Control Room, dass Sie über die Rolle AAE_Admin verfügen.
  • Konfigurieren Sie Ihre Netzwerk-Firewall je nach Region so, dass die IP-Adressen ausgehender NAT-Gateways in die Liste der zulässigen Adressen aufgenommen werden.

    Control Room IP-Adressen für externe Integrationen

Wenn Sie ein Remote-Git-Repository konfigurieren, sollten Sie die folgenden Punkte beachten:
  • Das Git-Repository muss so konfiguriert sein, dass es nur Schreibzugriff auf den Control Room und nicht auf einen anderen Git-Client hat.
  • Sie können keine Dateien mit mehr als 100 MB in das Git-Repository hochladen.
  • Stellen Sie sicher, dass Sie mit einem leeren Git-Repository integrieren.
  • Sie sollten keine Dateien von anderen Nutzern, Produkten oder Anwendungen manuell in das Git-Repository einchecken.
  • Wenn Sie mit Git integrieren, sollte das Repository nicht die Datei ReadMe.md enthalten.
  • Vergewissern Sie sich, dass Ihr Git-Repository privat (intern) ist. Aus Sicherheitsgründen kann Automation 360 keine Verbindung zu einem öffentlichen Git-Repository herstellen, da alle Bots und Dateien in einem öffentlichen Git-Repository allgemein zugänglich sind.

Prozedur

  1. Navigieren Sie im Control Room zu Administration > Einstellungen > Integration eines Remote-Git-Repositorys.
  2. Klicken Sie auf Bearbeiten.
  3. Wählen Sie eine der folgenden Authentifizierungsmethoden und führen Sie die entsprechenden Schritte aus, um Ihre Git-Konfiguration einzurichten:
    AuthentifizierungsmethodeSchritte
    HTTPS-Authentifizierung
    1. Geben Sie den HTTPS-Repository-Pfad einschließlich des Nutzernamens in folgendem Format ein:

      https://<username>@bitbucket.org/companyname/product.git

      Anmerkung: Verwenden Sie den Git-Host, von dem Sie die Adresse des Git-Repositorys erhalten möchten.
    2. Geben Sie den Zweignamen ein.

      Die Änderungen werden auf den ausgewählten Zweig übertragen. Standardmäßig ist der Master-Zweig ausgewählt.

      Die Zweignamen können in Kleinbuchstaben geschrieben werden, dürfen aber höchstens 250 Zeichen umfassen. Fügen Sie keine ASCII-Steuerzeichen wie Leerzeichen, Tilden oder Doppelpunkte in Zweignamen ein. Sie können Wörter mit Bindestrichen trennen. Weitere Informationen zum Benennen von Zweigen finden Sie unter Create a new Git branch.

    3. Geben Sie Ihr Passwort für das Git-Repository oder ein generiertes Git-Token ein.
      Anmerkung:
      • Die Länge des Tokens muss auf 75 Zeichen begrenzt sein.
      • Sie müssen das für Ihre Repository-Verbindung generierte Passwort eingeben. Es wird empfohlen, Token zu verwenden, da sie sicherer sind als Passwörter.
      • Für GitHub müssen Sie nur die Personal Access Tokens (Classic) verwenden. Die Personal Access Tokens (fein abgestuft) funktionieren nicht in GitHub.
      • Für BitButcket dürfen Sie nur die Passwörter der App verwenden.
    4. Geben Sie das Kennwort oder das Git-Token zur Bestätigung erneut ein.
    SSH-Authentifizierung
    1. Geben Sie den SSH-Repository-Pfad in folgendem Format ein:

      https://git@bitbucket.org:companyname/product.git

      Anmerkung: Verwenden Sie den Git-Host, von dem Sie die Adresse des Git-Repositorys erhalten möchten.
    2. Geben Sie den Zweignamen ein.

      Die Änderungen werden auf den ausgewählten Zweig übertragen. Standardmäßig ist der Master-Zweig ausgewählt.

      Die Zweignamen können in Kleinbuchstaben geschrieben werden, dürfen aber höchstens 250 Zeichen umfassen. Fügen Sie keine ASCII-Steuerzeichen wie Leerzeichen, Tilden oder Doppelpunkte in Zweignamen ein. Sie können Wörter mit Bindestrichen trennen. Weitere Informationen zum Benennen von Zweigen finden Sie unter Create a new Git branch.

    3. Geben Sie Ihren privaten Schlüssel für die SSH-Authentifizierung ein.

      Sie müssen das private und öffentliche Schlüsselpaar mit Hilfe des RSA-Algorithmus erstellen.

      Anmerkung: Der im Control Room eingegebene private Schlüssel muss folgende Zeichenfolge enthalten: -----BEGIN RSA PRIVATE KEY----- AND -----END RSA PRIVATE KEY-----

      Sie müssen den öffentlichen Schlüssel generieren und ihn in Ihren Git-Server eingeben.

      In den folgenden Themen erfahren Sie, wie Sie je nach Server den öffentlichen Schlüssel generieren können:
    4. Optional: Geben Sie die Passphrase ein.
  4. Optional: Aktivieren Sie das Kontrollkästchen Verbindung zu Git über Proxy herstellen.
    1. Geben Sie den Hostnamen oder die IP-Adresse des Proxy ein.
    2. Geben Sie die Portnummer ein.
    3. Optional: Aktivieren Sie das Kontrollkästchen „Authentifizierung“ und geben Sie den Nutzernamen und das Passwort ein.
  5. Klicken Sie auf Verbinden und Speichern.
    Mit dem Control Room wird eine Verbindung zum entfernten Git-Repository hergestellt, und die folgende Meldung wird angezeigt: Git-Integrationseinstellungen erfolgreich gespeichert. Sie können auch das Audit-Protokoll überprüfen, in dem der Status für Git-Einstellungen einrichten als erfolgreich angezeigt wird.
Anmerkung:
  • Der Check-in-Vorgang kann länger dauern, wenn Sie viele Bot-Dateien in Ihrem Git-Ordner im öffentlichen Arbeitsbereich haben. Dies liegt daran, dass eine Vergrößerung des Repositorys zu einer Verlangsamung der Git-Commits führt. Wir empfehlen Ihnen, die nicht verwendeten Bot-Dateien aus Ihrem öffentlichen Arbeitsbereich zu löschen.
  • Wenn das Git-Repository Sperrdateien wie index.lock oder master.lock enthält, löschen Sie diese Sperrdateien, da sie das Ein- und Auschecken behindern könnten.

Sie können sich mit einem anderen Nutzernamen im Control Room bei demselben Git-Repository anmelden. Weitere Informationen finden Sie unter How to change the remote Git repository username in the control room (A-People login required).

Das folgende Video bietet einen Überblick über Git: