Hinzufügen einer Produktions-Pipeline configure-production-pipeline
Erfahren Sie, wie Sie Produktions-Pipelines konfigurieren, um Ihren Code zu erstellen und in Produktionsumgebungen bereitzustellen. Eine Produktions-Pipeline stellt Code zuerst in der Staging-Umgebung bereit. Bei der Genehmigung wird derselbe Code in der Produktionsumgebung bereitgestellt.
Benutzende müssen über die Rolle Bereitstellungs-Manager verfügen, um Produktions-Pipelines konfigurieren zu können.
- Das Programm wird erstellt.
- Das Git-Repository hat mindestens eine Verzweigung.
- Die Produktions- und Staging-Umgebungen werden erstellt.
Bevor Sie mit der Bereitstellung des Codes beginnen, konfigurieren Sie Ihre Pipeline-Einstellungen über Cloud Manager.
Hinzufügen einer neuen Produktions-Pipeline adding-production-pipeline
Sobald Sie mit der Benutzeroberfläche von Cloud Manager Ihr Programm eingerichtet und mindestens eine Umgebung haben, können Sie eine Produktions-Pipeline hinzufügen, indem Sie die folgenden Schritte ausführen.
-
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.
-
Gehen Sie von der Seite Programmübersicht zur Karte Pipelines, klicken Sie auf Hinzufügen und wählen Sie dann Produktions-Pipeline hinzufügen aus.
-
Das Dialogfeld Produktions-Pipeline hinzufügen erscheint. Geben Sie einen Pipeline-Name an, um Ihre Pipeline zu identifizieren, sowie die folgenden Optionen. Klicken Sie auf Weiter.
Bereitstellungsauslöser: Beim Definieren der Bereitstellungsauslöser für den Start der Pipeline haben Sie die folgenden Optionen.
- Manuell - Starten Sie die Pipeline manuell.
- Bei Git-Änderungen - Startet die CI/CD-Pipeline, sobald der konfigurierten Git-Verzweigung Commits hinzugefügt werden. Mit dieser Option können Sie die Pipeline bei Bedarf immer noch manuell starten.
Verhalten bei bedeutenden Metrikfehlern: Bei der Einrichtung oder Bearbeitung der Pipeline kann der Bereitstellungs-Manager festlegen, wie sich die Pipeline verhält, wenn bei einem der Quality Gates ein wichtiger Fehler auftritt. Folgende Optionen sind verfügbar:
- Jedes Mal fragen - Standardeinstellung. Es erfordert manuelles Eingreifen bei einem wichtigen Fehler.
- Sofortiger Ausfall: Wenn diese Option ausgewählt ist, wird die Pipeline bei einem bedeutenden Fehler abgebrochen. Dieser Prozess emuliert im Wesentlichen einen Benutzer, der jeden Fehler manuell ablehnt.
- Sofort fortfahren - Wenn ausgewählt, wird die Pipeline automatisch fortgesetzt, sobald ein wichtiger Fehler auftritt. Dieser Prozess emuliert im Wesentlichen einen Benutzer, der manuell jeden Fehler genehmigt.
-
Wählen Sie auf der Registerkarte Source-Code den Code aus, den die Pipeline verarbeiten soll.
Weitere Informationen zu diesem Pipeline-Typ finden Sie unter CI/CD-Pipelines.
Die Schritte zum Abschluss der Erstellung Ihrer Produktions-Pipeline variieren je nach dem von Ihnen gewählten Typ von Quell-Code. Folgen Sie den oben stehenden Links, um zum nächsten Abschnitt dieses Dokuments zu springen und die Konfiguration Ihrer Pipeline abzuschließen.
Konfigurieren einer vollständigen Stack-Code-Pipeline full-stack-code
Eine Pipeline mit Full-Stack-Code stellt gleichzeitig Backend- und Frontend-Code-Builds bereit, die ein oder mehrere AEM-Server-Programme zusammen mit der HTTPD-/Dispatcher-Konfiguration enthalten.
So konfigurieren Sie eine vollständige Stack-Code-Pipeline:
-
Definieren Sie auf der Registerkarte Source-Code die folgenden Optionen.
- Repository - Definiert, aus welchem Git-Repository die Pipeline den Code abrufen soll.
note tip TIP Informationen zum Hinzufügen und Verwalten von Repositorys in Cloud Manager finden Sie unter Hinzufügen und Verwalten von Repositorys . - Git-Verzweigung - Definiert, von welcher Verzweigung die ausgewählte Pipeline den Code abrufen soll.
Geben Sie die ersten Zeichen des Zweignamens ein, und die Funktion zum automatischen Vervollständigen dieses Felds sucht nach den entsprechenden Verzweigungen, die Ihnen bei der Auswahl helfen. - Konfiguration der Web-Stufe ignorieren: Wenn diese Option aktiviert ist, stellt die Pipeline Ihre Web-Stufenkonfiguration nicht bereit.
- Pause vor der Bereitstellung in der Produktion - Hält die Pipeline vor der Bereitstellung in der Produktion an.
- Geplant - Ermöglicht dem Benutzer die Aktivierung der geplanten Produktionsbereitstellung.
-
Klicken Sie auf Weiter, um zur Registerkarte Experience Audit zu gelangen, auf der Sie die Pfade definieren können, die immer in das Experience Audit einbezogen werden sollen.
-
Geben Sie Pfade an, die in die Erlebnisprüfung aufgenommen werden sollen.
- Weitere Informationen finden Sie unter Erlebnisprüfungstests .
-
Klicken Sie auf Speichern, um die Pipeline zu speichern.
Wenn die Pipeline ausgeführt wird, werden für Experience Audit konfigurierte Pfade basierend auf Leistungs-, Zugänglichkeits-, SEO-, Best Practices- und PWA-Tests gesendet und ausgewertet. Weitere Informationen finden Sie unter Verstehen der Ergebnisse von Erlebnisprüfungen.
Die Pipeline wird gespeichert, und auf der Seite Programmübersicht können Sie nun über die Karte Pipelines Ihre Pipelines verwalten.
Zielgerichtete Bereitstellungspipeline konfigurieren targeted-deployment
Bei einer zielgerichteten Bereitstellung wird Code nur für ausgewählte Teile Ihrer AEM-Anwendung bereitgestellt. In einer solchen Bereitstellung können Sie einen der folgenden Code-Typen für Einschließen auswählen:
-
Konfiguration - Konfigurieren Sie Einstellungen für verschiedene Funktionen in Ihrer AEM.
- Eine Liste der unterstützten Konfigurationen, einschließlich Protokollweiterleitung, bereinigungsbezogener Wartungsaufgaben und verschiedener CDN-Konfigurationen, sowie Informationen zu deren ordnungsgemäßer Bereitstellung im Repository finden Sie unter Verwenden von Konfigurations-Pipelines.
- Beim Ausführen einer zielgerichteten Bereitstellungs-Pipeline werden Konfigurationen bereitgestellt, sofern sie in der in der Pipeline definierten Umgebung, im Repository und in der Verzweigung gespeichert wurden.
- Es kann immer nur eine Konfigurations-Pipeline pro Umgebung geben.
-
Frontend-Code – Konfigurieren Sie JavaScript und CSS für das Frontend Ihrer AEM-Anwendung.
- Mit Frontend-Pipelines erhalten Frontend-Entwickelnde mehr Unabhängigkeit, und der Entwicklungsprozess kann beschleunigt werden.
- Weitere Informationen dazu, wie dieser Prozess abläuft und was dabei zu beachten ist, um das volle Potenzial dieses Prozesses auszuschöpfen, finden Sie im Dokument Entwickeln von Sites mit der Frontend-Pipeline.
-
Web-Ebene-Konfiguration - Konfigurieren Sie Dispatcher-Eigenschaften zum Speichern, Verarbeiten und Bereitstellen von Webseiten für den Client.
- Weitere Informationen finden Sie im Dokument CI/CD-Pipelines.
- Wenn für die ausgewählte Umgebung bereits eine Web-Stufen-Code-Pipeline vorhanden ist, wird diese Auswahl deaktiviert.
- Wenn Sie eine Web-Tier-Konfigurationspipeline für eine Umgebung mit einer vorhandenen Vollstapelpipeline erstellen, wird die Webstufenkonfiguration in der Vollstapelpipeline ignoriert. Diese Änderung betrifft nur die Webstufenkonfiguration in dieser Umgebung.
So konfigurieren Sie eine zielgerichtete Bereitstellungs-Pipeline:
- Wählen Sie den benötigten Bereitstellungstyp aus.
-
Definieren Sie die geeigneten Bereitstellungsumgebungen.
- Wenn es sich bei Ihrer Pipeline um eine Bereitstellungs-Pipeline handelt, müssen Sie auswählen, für welche Umgebungen sie etwas bereitstellen soll.
-
Definieren Sie unter Quell-Code die folgenden Optionen:
- Repository: Diese Option legt fest, aus welchem Git-Repository die Pipeline den Code abrufen soll.
note tip TIP Weitere Informationen dazu, wie Sie Repositorys in Cloud Manager hinzufügen und verwalten, finden Sie unter Hinzufügen und Verwalten von Repositorys. - Git-Verzweigung: Mit dieser Option wird festgelegt, von welcher Verzweigung in der ausgewählten Pipeline der Code abgerufen werden soll.
- Geben Sie die ersten Zeichen des Verzweigungsnamens und die Funktion zur automatischen Vervollständigung dieses Felds ein. Es werden die entsprechenden auswählbaren Verzweigungen gesucht.
- Speicherort des Codes: Mit dieser Option wird der Pfad in der Verzweigung des ausgewählten Repositorys festgelegt, aus dem die Pipeline den Code abrufen soll.
- Anhalten vor der Bereitstellung in der Produktion: Diese Option setzt die Pipeline vor der Bereitstellung in der Produktion aus.
- Geplant - Ermöglicht dem Benutzer die Aktivierung der geplanten Produktionsbereitstellung. Nur für Web-Stufen-spezifische Bereitstellungen verfügbar.
-
Klicken Sie auf Speichern.
Die Pipeline wird gespeichert, und auf der Seite Programmübersicht können Sie nun über die Karte Pipelines Ihre Pipelines verwalten.
Überspringen von Dispatcher-Paketen skip-dispatcher-packages
Um Dispatcher-Pakete in Ihrer Pipeline zu erstellen, ohne sie für den Build-Speicher zu veröffentlichen, können Sie die Veröffentlichungsoption deaktivieren. Dies kann dazu beitragen, die Laufzeit der Pipeline zu verkürzen.
Die folgende Konfiguration zum Deaktivieren von Veröffentlichungs-Dispatcher-Paketen muss über die pom.xml-Datei Ihres Projekts hinzugefügt werden. Eine Umgebungsvariable dient als Markierung, die Sie im Cloud Manager-Build-Container festlegen, um zu bestimmen, wann Dispatcher-Pakete ignoriert werden.
<profile>
<id>only-include-dispatcher-when-it-isnt-ignored</id>
<activation>
<property>
<name>env.IGNORE_DISPATCHER_PACKAGES</name>
<value>!true</value>
</property>
</activation>
<modules>
<module>dispatcher</module>
</modules>
</profile>