Privates GitHub-Repository in Cloud Manager hinzufügen private-repositories
Durch die Einrichtung von Cloud Manager zur Integration in Ihre privaten GitHub-Repositorys können Sie mithilfe von Cloud Manager Ihren Code direkt in GitHub validieren. Durch diese Konfiguration wird die Anforderung entfernt, Ihren Code regelmäßig mit dem Adobe-Repository zu synchronisieren.
Konfiguration configuration
Die Konfiguration eines privaten GitHub-Repositorys in Cloud Manager erfolgt in zwei Schritten:
- Fügen Sie einem ausgewählten Programm ein privates GitHub-Repository hinzu.
- Überprüfen Sie dann die Eigentümerschaft des privaten GitHub-Repositorys.
Hinzufügen eines privaten GitHub-Repositorys zu einem Programm add-repo
-
Melden Sie sich unter my.cloudmanager.adobe.com bei Cloud Manager an und wählen Sie die entsprechende Organisation aus.
-
Wählen Sie in der Konsole Meine Programme das Programm aus, mit dem Sie ein privates Git-Repository verknüpfen möchten.
-
Wählen Sie im Seitenmenü unter Services
-
Klicken Sie oben rechts auf der Seite Repositorys auf Repository hinzufügen.
-
Legen Sie im Dialogfeld Repository hinzufügen die Option Privates Repository als Repository-Typ fest.
-
Geben Sie in jedem Feld jeweils die folgenden Details zu Ihrem Repository an:
table 0-row-2 1-row-2 2-row-2 3-row-2 Feld Beschreibung Repository-Name Ein aussagekräftiger Name für Ihr neues Repository. Repository-URL Die URL des privaten Repositorys, die mit .gitenden muss.
Beispiel:https://github.com/org-name/repo-name.git(URL-Pfad dient nur zu Illustrationszwecken).Beschreibung (optional) Eine längere Beschreibung des Repositorys. -
Wählen Sie Speichern aus.
Jetzt können Sie das Eigentum des privaten Repositorys überprüfen.
Überprüfen der Eigentümerschaft des privaten GitHub-Repositorys validate-ownership
Cloud Manager kennt jetzt Ihr GitHub-Repository, benötigt aber noch den Zugriff darauf. Um Zugriff zu gewähren, müssen Sie die Adobe GitHub-App installieren und sicherstellen, dass Sie Eigentümerin bzw. Eigentümer des angegebenen Repositorys sind.
So überprüfen Sie die Eigentümerschaft eines privaten GitHub-Repositorys:
-
Nachdem Sie Ihr eigenes Repository hinzugefügt haben, führen Sie die verbleibenden Schritte im Dialogfeld Validierung der Eigentümerschaft eines privaten Repositorys aus.
table 0-row-2 1-row-2 2-row-2 Beschreibung Schritt 1: GitHub-App Zur sicheren Interaktion mit Ihrem privaten Repository verwendet Cloud Manager eine GitHub-App.
• Eine Eigentümerin bzw. ein Eigentümer Ihrer GitHub-Organisation muss die App unterhttps://github.com/apps/cloud-manager-for-aeminstallieren und Zugriff auf das Repository gewähren.
• Einzelheiten zur Installation und Gewährung des Zugriffs finden Sie in der GitHub-Dokumentation.Schritt 2: Geheime Datei Um die Sicherheit zu erhöhen, müssen Sie eine geheime Datei in der Standardverzweigung Ihres Repositorys erstellen.
• Klicken Sie auf Generieren und klicken Sie dann auf Bestätigen. Cloud Manager generiert den Inhalt der privaten Datei im Textfeld Inhalt der geheimen Datei.
• Klicken Sie auf das Symbol
-
Erstellen Sie in der Standardverzweigung Ihres GitHub-Repositorys eine neue Datei mit dem Namen:
.well-known/adobe/cloud-manager-challenge -
Fügen Sie den Inhalt der geheimen Datei in die soeben erstellte, neue Datei ein und speichern Sie sie.
Sobald die App installiert und die geheime Datei im Repository vorhanden ist, fahren Sie mit dem Schritt fort.
-
Klicken Sie im Dialogfeld Validierung der Eigentümerschaft des privaten Repositorys auf Überprüfen.
Die Installation der App und die Erstellung der geheimen Datei kann in jeder beliebigen Reihenfolge erfolgen. Beide Schritte müssen jedoch vor der Validierung ausgeführt werden.
Bis zur Validierung ist das Repository mit einem roten Symbol gekennzeichnet. Dies bedeutet, dass es noch nicht validiert wurde und noch nicht verwendet werden kann.
Die Spalte Typ in der Tabelle auf der Seite Repositorys kennzeichnet die von Adobe bereitgestellten Repositorys (Adobe) und Ihre eigenen privaten Repositorys (GitHub) entsprechend.
Wenn Sie später zum Repository zurückkehren müssen, um die Validierung abzuschließen, klicken Sie auf der Seite Repositorys in der Zeile, die das gerade hinzugefügte GitHub-Repository enthält, auf das Symbol
Verwenden privater GitHub-Repositorys mit Cloud Manager using
Nachdem das GitHub-Repository in Cloud Manager validiert wurde, ist die Integration abgeschlossen. Sie können jetzt das Repository mit Cloud Manager verwenden.
So verwenden Sie private Repositorys mit Cloud Manager:
-
Beim Erstellen einer Pull-Anfrage wird automatisch eine GitHub-Prüfung ausgeführt.
-
Für jede Pull-Anfrage wird automatisch eine Full-Stack-Code-Qualitäts-Pipeline erstellt. Diese Pipeline wird bei jeder Aktualisierung einer Pull-Anfrage gestartet.
-
Die GitHub-Prüfung verbleibt im Status „Wird ausgeführt“, bis die Code-Qualitätsprüfungen abgeschlossen sind. Die Code-Qualitätsergebnisse werden dann an die GitHub-Prüfung übertragen.
Wenn die Pull-Anfrage zusammengeführt oder geschlossen wird, wird die erstellte vollständige Stack-Code-Qualitäts-Pipeline automatisch gelöscht.
Zuordnen von privaten Repositorys zu Pipelines pipelines
Validierte private Repositorys können Full-Stack- und Frontend-Pipelines zugeordnet werden.
Einschränkungen limitations
Bei der Verwendung privater Repositorys mit Cloud Manager gelten bestimmte Einschränkungen.
- Pipelines auf Web-Ebene und Konfigurations-Pipelines werden bei privaten Repositorys nicht unterstützt.
- Bei Verwendung privater Repositorys in Full-Stack-Produktions-Pipelines wird kein Git-Tag erstellt und gepusht.
- Wenn die Adobe-GitHub-App aus Ihrer GitHub-Organisation entfernt wird, wird dadurch die Funktion zur Validierung von Pull-Anfragen für alle Repositorys entfernt.
- Pipelines, die private Repositorys und den On-Commit-Build-Trigger verwenden, werden nicht automatisch gestartet, wenn ein neues Commit in die ausgewählte Verzweigung verschoben wird.
- Die Funktion zur Wiederverwendung von Artefakten gilt nicht für private Repositorys.
- Sie können die Überprüfung der Pull-Anfrage nicht mithilfe der GitHub-Prüfung über Cloud Manager anhalten.
Während der Validierung des GitHub-Repositorys in Cloud Manager versucht Cloud Manager immer, die für dieses Repository erstellten Pull-Anfragen zu validieren.