Hinzufügen von privaten Repositorys in Cloud Manager private-repositories
Erfahren Sie, wie Sie Cloud Manager für die Arbeit mit Ihren eigenen privaten GitHub-Repositorys einrichten.
Übersicht overview
Indem Sie Cloud Manager mit Ihren privaten GitHub-Repositorys konfigurieren, können Sie Code direkt in GitHub validieren, sodass eine regelmäßige Synchronisierung mit dem Adobe-Repository nicht mehr erforderlich ist.
Konfiguration configuration
Die Konfiguration erfolgt in zwei Hauptschritten:
Hinzufügen eines Repositorys add-repo
-
Klicken Sie in Cloud Manager auf der Seite Programmübersicht auf die Registerkarte Repositorys, um zur Seite Repositorys zu wechseln. Klicken Sie dann auf Repository hinzufügen.
-
Legen Sie im Dialogfeld Repository hinzufügen die Option Privates Repository als Repository-Typ fest.
-
Angabe von Details zu Ihrem Repository
- Repository-Name – Ein aussagekräftiger Name
- Repository-URL – Die URL des Repositorys, die mit
.gitenden muss - Beschreibung (optional) – Eine längere Beschreibung des Repositorys nach Bedarf
-
Klicken Sie auf Speichern.
Validieren der Eigentümerschaft eines privaten 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.
-
Nachdem Sie Ihr eigenes Repository hinzugefügt haben, wird das Dialogfeld Validierung der Eigentümerschaft eines privaten Repositorys angezeigt.
-
Zur sicheren Interaktion mit Ihrem Repository verwendet Cloud Manager eine GitHub-App.
Eine Verantwortliche bzw. ein Verantwortlicher Ihrer GitHub-Organisation muss die App unter
https://github.com/apps/cloud-manager-for-aeminstallieren und Zugriff auf das Repository gewähren. Weitere Informationen finden Sie in der GitHub-Dokumentation. -
Um die Sicherheit zu erhöhen, erstellen Sie eine geheime Datei in der Standardverzweigung Ihres Repositorys. Klicken Sie auf Generieren.
-
Bestätigen Sie die Generierung der geheimen Datei, indem Sie auf Bestätigen klicken.
-
Im Fenster Validierung der Eigentümerschaft eines privaten Repositorys hat Cloud Manager den Inhalt im Feld Inhalt der geheimen Datei generiert. Kopieren Sie den Inhalt aus diesem Feld.
Der Inhalt der geheimen Datei wird nur einmal angezeigt. Wenn Sie den Inhalt nicht kopieren, bevor Sie dieses Fenster schließen, müssen Sie das Geheimnis neu generieren.
-
Erstellen Sie in der Standardverzweigung Ihres GitHub-Repositorys eine neue Datei mit dem Namen
.well-known/adobe/cloud-manager-challenge, fügen Sie den geheimen Dateiinhalt in diese Datei ein und speichern Sie sie. -
Sobald die App installiert ist und sich die geheime Datei im Repository befindet, können Sie im Dialogfeld Validierung der Eigentümerschaft eines privaten Repositorys auf die Option Validieren klicken.
Die App kann installiert werden und Sie können eine geheime Datei in beliebiger Reihenfolge generieren. 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.
Beachten Sie, dass in der Spalte Typ die von Adobe bereitgestellten Repositorys (Adobe) und Ihre eigenen GitHub-Repositorys (GitHub) leicht erkennbar aufgeführt sind.
Um später zum Repository zurückzukehren und die Validierung abzuschließen, gehen Sie zur Seite Repositorys. Klicken Sie auf die Schaltfläche mit den Auslassungspunkten neben dem von Ihnen hinzugefügten GitHub-Repository und wählen Sie im Dropdown-Menü die Option Validierung der Eigentümerschaft aus.
Verwenden privater Repositorys mit Cloud Manager using
Nachdem das GitHub-Repository in Cloud Manager validiert wurde, ist die Integration abgeschlossen und Sie können 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 geschlossen oder zusammengeführt 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 auch 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 Validierung 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, die für dieses Repository erstellten Pull-Anfragen zu validieren.