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 für die Verwendung mit Ihren eigenen privaten GitHub-Repositorys konfigurieren, können Sie Ihren Code über Cloud Manager direkt in Ihrem GitHub-Repository validieren, sodass Sie ihn nicht ständig mit dem Adobe-Repository synchronisieren müssen.
Konfiguration configuration
Die Konfiguration erfolgt in zwei Hauptschritten:
Repository hinzufügen add-repo
-
Tippen oder klicken Sie in Cloud Manager auf der Seite Programmübersicht auf die Registerkarte Repositorys, um zur Seite Repositorys zu wechseln, und dann auf Repository hinzufügen.
-
Wählen Sie im Dialogfeld Repository hinzufügen als Repository-Typ Privates Repository.
-
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
-
Tippen oder klicken Sie auf Speichern.
Validierung 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 der Dialog Validierung der Eigentümerschaft eines privaten Repositorys geöffnet.
-
Zur sicheren Interaktion mit Ihrem Repository verwendet Cloud Manager eine GitHub-App.
- Eine Eigentümerin bzw. ein Eigentümer Ihrer GitHub-Organisation muss die App unter
https://github.com/apps/cloud-manager-for-aeminstallieren und Zugriff auf das Repository gewähren. - Weitere Informationen dazu finden Sie in der GitHub-Dokumentation.
- Eine Eigentümerin bzw. ein Eigentümer Ihrer GitHub-Organisation muss die App unter
-
Um die Sicherheit zu erhöhen, müssen Sie eine geheime Datei in der Standardverzweigung Ihres Repositorys erstellen. Tippen oder 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 der privaten Datei im Feld Geheimer Dateiinhalt 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 die geheime Datei 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 Bestätigen tippen oder klicken.
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, das angibt, 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.
Wenn Sie zu einem späteren Zeitpunkt zum Repository zurückkehren müssen, um die Validierung abzuschließen, klicken oder tippen Sie auf der Seite Repositorys auf die Schaltfläche mit den Auslassungspunkten in der Zeile mit dem soeben von Ihnen hinzugefügten GitHub-Repository und wählen Sie Eigentümervalidierung aus dem Dropdown-Menü.
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.
-
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 Ergebnisse der Code-Qualität 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-Pipelines zugeordnet werden.
Einschränkungen limitations
Bei der Verwendung privater Repositorys mit Cloud Manager gelten bestimmte Einschränkungen.
- 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 versucht Cloud Manager immer, die für dieses Repository erstellten Pull-Anfragen zu validieren.
- Wenn die Adobe GitHub-App aus Ihrer GitHub-Organisation entfernt wird, wird dadurch auch die Überprüfungsfunktion für Pull-Anfragen für alle Repositorys entfernt.
- Bei Verwendung privater Repositorys in Full-Stack-Produktions-Pipelines wird kein Git-Tag erstellt und gesendet.
- 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.