Konfigurieren von produktionsfremden Pipelines configuring-non-production-pipelines
Erfahren Sie, wie Sie produktionsfremde Pipelines so konfigurieren, dass die Qualität des Codes vor seiner Bereitstellung in Produktionsumgebungen getestet wird.
Benutzende müssen über die Rolle Bereitstellungs-Manager verfügen, um produktionsfremde Pipelines konfigurieren zu können.
Produktionsfremde Pipelines non-production-pipelines
Zusätzlich zu Produktions-Pipelines, die in Staging- und Produktionsumgebungen bereitstellen, können Sie auch produktionsfremde Pipelines zur Validierung Ihres Codes einrichten.
Es gibt zwei Arten von produktionsfremden Pipelines:
- Code-Qualitäts-Pipelines: Diese Pipelines führen Code-Qualitätsprüfungen für den Code in einer Git-Verzweigung durch und sie führen die Build- und Code-Qualitätsschritte aus.
- Bereitstellungs-Pipelines: Diese Pipelines führen nicht nur wie die Code-Qualitäts-Pipelines die Build- und Code-Qualitätsschritte aus, sondern stellen den Code auch in einer produktionsfremden Umgebung bereit.
Hinzufügen einer neuen produktionsfremden Pipeline adding-non-production-pipeline
Sobald Sie mit der Benutzeroberfläche von Cloud Manager Ihr Programm eingerichtet und mindestens eine Umgebung haben, können Sie eine produktionsfremde 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 auf dem Bildschirm Meine Programme das Programm aus.
-
Rufen Sie die Karte Pipelines über den Startbildschirm von Cloud Manager auf. Klicken Sie auf +Hinzufügen und wählen Sie Produktionsfremde Pipeline hinzufügen aus.
-
Wählen Sie im Dialogfeld Hinzufügen einer produktionsfremden Pipeline auf der Registerkarte Konfiguration den Typ der produktionsfremden Pipeline aus, die Sie hinzufügen möchten.
- Code-Qualitäts-Pipeline – Erstellen Sie eine Pipeline, die Ihren Code erstellt, Komponententests durchführt und die Code-Qualität auswertet, aber NICHT implementiert.
- Implementierungs-Pipeline – Erstellen Sie eine Pipeline, die Ihren Code erstellt, Komponententests durchführt, die Code-Qualität auswertet und in einer Umgebung implementiert.
-
Geben Sie einen Namen für die produktionsfremde Pipeline an, um Ihre Pipeline zu identifizieren, sowie die folgenden zusätzlichen Informationen.
-
Bereitstellungsauslöser: Beim Definieren der Bereitstellungsauslöser für den Start der Pipeline haben Sie die folgenden Optionen.
- Manuell: Verwenden Sie diese Option, um die Pipeline manuell zu starten.
- Bei Git-Änderungen: Diese Option startet die CI/CD-Pipeline, wenn zur konfigurierten Git-Verzweigung bestätigte Änderungen hinzugefügt werden. Mit dieser Option können Sie die Pipeline bei Bedarf immer noch manuell starten.
-
-
Wenn Sie eine Bereitstellungs-Pipeline erstellen möchten, müssen Sie auch das Verhalten bei bedeutenden Metrikfehlern definieren.
- Jedes Mal fragen: Dieses Verhalten ist die Standardeinstellung und erfordert ein manuelles Eingreifen bei einem bedeutenden Fehler.
- Sofortiger Ausfall: Wenn diese Option ausgewählt ist, wird die Pipeline bei einem bedeutenden Fehler abgebrochen. Damit werden im Grunde Benutzende simuliert, die manuell jeden Fehler ablehnen.
- Sofort fortfahren: Wenn diese Option ausgewählt ist, wird die Pipeline bei einem bedeutenden Fehler automatisch fortgesetzt. Damit werden im Grunde Benutzende simuliert, die manuell jeden Fehler genehmigen.
-
Klicken Sie auf Weiter.
-
Auf der Registerkarte Quell-Code im Dialogfeld Produktionsfremde Pipeline hinzufügen müssen Sie auswählen, welche Art von Code die Pipeline verarbeiten soll.
Weitere Informationen zu den Pipeline-Typen finden Sie unter CI/CD-Pipelines.
Die Schritte zum Abschluss der Erstellung Ihrer produktionsfremden Pipeline variieren entsprechend der von Ihnen gewählten Option für den Quell-Code. Folgen Sie den oben stehenden Links, um zum nächsten Abschnitt dieses Dokuments zu springen und die Konfiguration Ihrer Pipeline abzuschließen.
Full-Stack-Code 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.
Führen Sie die folgenden Schritte aus, um die Konfiguration der produktionsfremden Full-Stack-Code-Pipeline abzuschließen.
-
In der Registerkarte Quell-Code müssen Sie die folgenden Optionen definieren.
- Berechtigte Bereitstellungsumgebungen: Wenn es sich bei Ihrer Pipeline um eine Bereitstellungs-Pipeline handelt, müssen Sie auswählen, in welche Umgebungen sie bereitstellen soll.
- 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. Dies hilft Ihnen, die entsprechenden auswählbaren Verzweigungen zu suchen.
-
Konfiguration der Web-Stufe ignorieren: Wenn diese Option aktiviert ist, stellt die Pipeline Ihre Web-Stufenkonfiguration nicht bereit.
-
Pipeline: Wenn es sich bei Ihrer Pipeline um eine Bereitstellungs-Pipeline handelt, können Sie eine Testphase ausführen. Aktivieren Sie die Optionen, die Sie in dieser Phase aktivieren möchten. Wenn keine der Optionen ausgewählt ist, wird die Testphase während der Pipeline-Ausführung nicht angezeigt.
- Funktionstests für das Produkt – Führen Sie Produktfunktionstests mit der Entwicklungsumgebung durch.
- Benutzerdefinierte Funktionstests – Führen Sie benutzerdefinierte Funktionstests gegen die Entwicklungsumgebung durch.
- Benutzerdefinierte UI-Tests – Führen Sie benutzerdefinierte UI-Tests für benutzerdefinierte Anwendungen aus.
- Erlebnisprüfung – Ausführen einer Erlebnisprüfung
-
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.
Zielgerichtete Bereitstellung 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 auswählen, einen der folgenden Code-Typen einzuschließen:
-
Konfiguration: Konfigurieren Sie die Einstellungen für Traffic-Filterregeln in Ihrer AEM-Umgebung.
- Im Dokument Traffic-Filterregeln einschließlich WAF-Regeln finden Sie Informationen dazu, wie Sie Traffic-Filterregeln in Ihrem Repository verwalten, damit sie ordnungsgemäß bereitgestellt werden.
- Beim Ausführen einer zielgerichteten Bereitstellungs-Pipeline werden Konfigurationen wie etwa WAF-Konfigurationen bereitgestellt, sofern sie in der Umgebung, im Repository und in der Verzweigung gespeichert sind, die Sie in der Pipeline definiert haben.
- 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-Stufen-Konfiguration – Konfigurieren Sie die Dispatcher-Eigenschaften zum Speichern, Verarbeiten und Bereitstellen von Web-Seiten für den Client.
- Weitere Einzelheiten 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 über eine vorhandene Full-Stack-Pipeline verfügen, die in einer Umgebung bereitgestellt wird, wird beim Erstellen einer Web-Stufen-Konfigurations-Pipeline für dieselbe Umgebung die vorhandene Web-Stufen-Konfiguration in der Full-Stack-Pipeline ignoriert.
Die Schritte zum Fertigstellen Ihrer produktionsfremden zielgerichteten Bereitstellungs-Pipeline sind dieselben, wenn Sie einen Bereitstellungstyp auswählen.
- 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.
-
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
Wenn Sie möchten, dass Dispatcher-Pakete als Teil Ihrer Pipeline erstellt werden, sie aber nicht im Build-Speicher veröffentlicht werden sollen, können Sie die Veröffentlichung deaktivieren, was die Laufzeit der Pipeline verkürzen kann.
Die folgende Konfiguration zum Deaktivieren von Veröffentlichungs-Dispatcher-Paketen muss über die pom.xml
-Datei Ihres Projekts hinzugefügt werden. Sie basiert auf einer Umgebungsvariablen, die als Markierung dient, welche Sie im Cloud Manager-Build-Container festlegen können, um zu definieren, wann Dispatcher-Pakete ignoriert werden sollen.
<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>