Hinzufügen einer Produktions-Pipeline configuring-production-pipelines
Erfahren Sie, wie Sie mit Cloud Manager Produktions-Pipelines erstellen und konfigurieren, um Code bereitzustellen. Einen konzeptionellen Überblick über die Funktionsweise von Pipelines in Cloud Manager finden Sie unter CI/CD-Pipelines.
Überblick overview
Über die Kachel Pipeline-Einstellungen in Cloud Manager können Sie zwei verschiedene Arten von Pipelines erstellen.
- Produktions-Pipelines: Eine Produktions-Pipeline ist eine speziell entwickelte Pipeline, die eine Reihe aufeinander abgestimmter Schritte umfasst, um Quell-Code aus dem Git-Repository in die Produktion zu übernehmen.
- Produktionsfremde Pipelines: Eine produktionsfremde Pipeline dient dazu, Code-Qualitätsprüfungen durchzuführen oder Quell-Code in einer Entwicklungsumgebung bereitzustellen.
Dieses Dokument konzentriert sich auf Produktions-Pipelines. Weitere Informationen zur Konfiguration von produktionsfremden Pipelines finden Sie unter Konfigurieren produktionsfremder Pipelines.
Die Rolle Bereitstellungs-Manager ist für die Einrichtung der Pipeline verantwortlich. Die Pipeline-Konfiguration besteht aus folgenden Schritten:
- Definition des Auslösers, der die Pipeline startet
- Definition der Parameter zur Steuerung der Produktionsbereitstellung
- Konfiguration der Leistungstestparameter
Hinzufügen einer Produktions-Pipeline add-a-production-pipeline
Sobald Sie mit der Cloud Manager-Benutzeroberfläche Ihr Programm eingerichtet haben und über mindestens eine Umgebung verfügen, können Sie eine Produktions-Pipeline hinzufügen.
-
Melden Sie sich unter my.cloudmanager.adobe.com bei Cloud Manager an und wählen Sie die entsprechende Organisation sowie das entsprechende Programm aus.
-
Navigieren Sie von der Seite Programmübersicht aus zur Karte Pipelines.
-
Klicken Sie auf +Hinzufügen und wählen Sie Produktions-Pipeline hinzufügen aus.
-
Das Dialogfeld Produktions-Pipeline hinzufügen wird geöffnet, wobei die Registerkarte Konfiguration geöffnet ist, auf eine einige Optionen für die Pipeline festgelegt werden müssen. Diese Optionen sind in ausklappbaren Abschnitten gruppiert und werden in den folgenden Schritten beschrieben.
-
Geben Sie in das Feld Name der Pipeline einen beschreibenden Namen für die Pipeline ein.
-
Im Abschnitt Umgebungen legen Sie fest, wodurch eine Bereitstellung ausgelöst wird und wie sie in den einzelnen Umgebungen ausgeführt werden soll.
-
Im Abschnitt STAGE können Sie festlegen, wie die Pipeline in Ihrer Staging-Umgebung eingesetzt wird.
-
Bereitstellungsauslöser: Sie haben die folgenden Optionen, um die Bereitstellungsauslöser für den Start der Pipeline zu definieren.
- Manuell: Diese Option startet die Pipeline manuell über die Cloud Manager-Benutzeroberfläche.
- 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.
-
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: Dies ist die Standardeinstellung, die ein manuelles Eingreifen bei jedem bedeutenden Fehler verlangt.
- Sofortiger Ausfall: Die Pipeline wird bei einem bedeutenden Fehler abgebrochen. Damit werden Benutzende simuliert, die manuell jeden Fehler ablehnen.
- Sofort fortsetzen: Die Pipeline wird bei einem bedeutenden Fehler automatisch fortgesetzt. Damit werden Benutzende simuliert, die manuell jeden Fehler genehmigen.
-
Bereitstellungsoptionen: Sie können bestimmte Bereitstellungsaufgaben beschleunigen.
-
Nach Staging-Bereitstellung genehmigen: Diese Genehmigung erfolgt nach der Bereitstellung in der Staging-Umgebung, bevor irgendwelche Tests durchgeführt werden. Andernfalls erfolgt die Genehmigung vor der Produktionsbereitstellung, die nach Abschluss aller Tests erfolgt.
-
Änderungen am Load-Balancer überspringen: Änderungen am Load-Balancer werden nicht vorgenommen.
-
-
Dispatcher-Konfiguration: Die Rolle Bereitstellungs-Manager kann eine Reihe von Inhaltspfaden konfigurieren, die beim Ausführen einer Pipeline entweder invalidiert oder aus dem AEM Dispatcher-Cache gelöscht werden. Diese Cache-Aktionen werden als Teil des Bereitstellungs-Pipeline-Schritts ausgeführt, nachdem alle Inhaltspakete bereitgestellt wurden. Diese Einstellungen verwenden das Standardverhalten von AEM Dispatcher. Gehen Sie zur Konfiguration wie folgt vor:
-
Geben Sie unter PATH einen Pfad für den Inhalt an.
-
Wählen Sie unter TYPE die Aktion aus, die mit dem Pfad durchgeführt werden soll.
- Leeren: Löschen des Cache-Inhalts.
- Invalidieren: Eine Cache-Invalidierung durchführen, ähnlich wie bei der Aktivierung von Inhalten von einer Autoreninstanz auf einer Veröffentlichungsinstanz.
-
Klicken Sie auf Pfad hinzufügen, um den angegebenen Pfad hinzuzufügen. Sie können bis zu 100 Pfade pro Umgebung hinzufügen.
-
note tip TIP Generell ist die Aktion „Invalidieren“ vorzuziehen. In einigen Fällen ist jedoch eine Leerung erforderlich, insbesondere bei Verwendung von AEM-HTML-Client-Bibliotheken. -
-
Im Abschnitt PRODUCTION können Sie festlegen, wie die Pipeline in der Produktionsumgebung eingesetzt werden soll.
-
Bereitstellungsoptionen: Sie können die Parameter zur Steuerung der Produktionsbereitstellung definieren.
-
GoLive-Genehmigung verwenden: Eine Benutzerin oder ein Benutzer mit der Rolle Geschäftsinhaber, Projekt-Manager oder Bereitstellungs-Manager muss eine Bereitstellung über die Cloud Manager-Benutzeroberfläche manuell genehmigen.
-
Geplant: Diese Option hält die Pipeline vor der Produktionsbereitstellung an, sodass sie geplant werden kann. Wenn diese Option ausgewählt ist, wird die Pipeline nach der Bereitstellung in der Staging-Umgebung angehalten und die Benutzerin oder der Benutzer wird aufgefordert, die entsprechenden Maßnahmen zu ergreifen.
Now: Dieser Option sorgt dafür, dass die Bereitstellung in der Produktionsumgebung sofort erfolgt. Die Pipeline wird damit abgeschlossen.- Datum: Diese Option ermöglicht es Benutzenden, einen Zeitpunkt festzulegen, zu dem die Bereitstellung abgeschlossen sein soll.
- Ausführung stoppen: Diese Option bricht die Bereitstellung in der Produktionsumgebung ab.
note tip TIP Weitere Informationen dazu, wie Sie einen Bereitstellungsplan festlegen oder die Pipeline sofort ausführen können, finden Sie unter Bereitstellung von Code. -
CSE-Überwachung nutzen: Bei Auswahl dieser Option wird ein Mitglied des Customer Success Engineer(CSE)-Teams eingeschaltet, um die tatsächliche Bereitstellung zu starten. Wenn diese Option aktiviert ist, während eine Pipeline erstellt oder bearbeitet wird, hat die Rolle Bereitstellungs-Manager folgende Optionen.
- Beliebiger CSE: Diese Option ermöglicht es, dass jedes verfügbare Mitglied des CSE-Teams die Bereitstellung starten kann.
- Mein CSE: Diese Option sorgt dafür, dass nur das der Kundin oder dem Kunden zugewiesene Mitglied des CSE-Teams die Bereitstellung starten kann. Diese Option gilt auch für die vorgesehene CSE-Backup-Person, wenn das zugewiesene Mitglied des CSE-Teams nicht verfügbar ist.
-
-
Dispatcher-Konfiguration: Definieren Sie die Dispatcher-Konfiguration für die Produktionsumgebung. Es sind die gleichen Optionen wie für die Staging-Umgebung verfügbar.
-
-
-
-
Klicken Sie Weiter, um zur Registerkarte Source-Code zu gelangen, auf der Sie den Code-Typ auswählen, der bereitgestellt und das Quell-Repository konfiguriert werden soll.
-
Wählen unter „Code für Bereitstellung" den Bereitstellungstyp aus:
- Full-Stack-Code - Code für Ihre gesamte AEM-Anwendung.
- Web-Stufen-: Dispatcher-Eigenschaften zum Speichern, Verarbeiten und Bereitstellen von Web-Seiten für den Client.
Weitere zu diesen Bereitstellungstypen finden unter CI/CD-Pipelines . Die restlichen Schritte zum Abschließen der Pipeline-Konfiguration hängen vom ausgewählten Typ ab. Folgen Sie den obigen Links, um zum entsprechenden Abschnitt dieses Dokuments zu springen.
-
-
Klicken Sie auf Weiter, um zur Registerkarte Staging-Tests zu gelangen. Dort können Sie abhängig von den von Ihnen lizenzierten Produkten Leistungstests für AEM Sites und AEM Assets konfigurieren.
note tip TIP Weitere Informationen zu den verfügbaren Optionen auf der Registerkarte Staging-Tests finden Sie unter Testen der Code-Qualität. -
Im Abschnitt Site-Inhaltsbereitstellung/verteilte Lastgewichtung konfigurieren Sie die Site-Leistungstests anhand der Gewichtung von Seitenanfragen zwischen drei Seitensätzen. Sie können die Seitensätze nach Bedarf aktivieren oder deaktivieren.
- Beliebte Live-Seiten
- Andere Live-Seiten
- Neue Seiten
-
Im Abschnitt Asset-Leistungstestverteilung definieren Sie sowohl die Testverteilung von Bildern und PDFs als auch eigene Test-Assets.
-
Bilder: Stellen Sie den Schieberegler ein, um die Aufteilung des Tests zwischen Bildern und PDFs anzupassen.
-
PDFs: Stellen Sie den Schieberegler ein, um die Aufteilung des Tests zwischen Bildern und PDFs anzupassen.
-
Definieren Sie eigene benutzerdefinierte Assets, indem Sie sie hochladen.
- FORMAT - Wählen Sie aus, ob das benutzerdefinierte Asset eine PDF oder ein Bild ist.
- DATEINAME: Verwenden Sie die Schaltfläche „Datei-Browser“, um ein Bild auf Ihrem lokalen Computer auszuwählen.
- Testdatei hinzufügen: Klicken Sie darauf, um das ausgewählte Asset hochzuladen.
-
-
-
Klicken Sie auf Speichern, um das Hinzufügen der Produktions-Pipeline abzuschließen.
Full-Stack-Code full-stack-code
Eine Pipeline mit Full-Stack-Code stellt Backend- und Frontend-Code-Builds zusammen mit der HTTPD/Dispatcher-Konfiguration bereit.
So konfigurieren Sie eine Produktions-Pipeline mit Full-Stack-Code:
-
Definieren Sie auf der Registerkarte Quell-Code die folgenden Optionen:
- Repository - Definiert, aus welchem Git-Repository die Pipeline den Code abruft.
note tip TIP Im Dokument Einrichten von Programmen erfahren Sie, wie Sie Repositorys in Cloud Manager hinzufügen und verwalten können. - Git-Verzweigung - Legt fest, von welcher Verzweigung die Pipeline den Code abruft.
- Konfiguration der Web-Stufe ignorieren: Wenn diese Option aktiviert ist, stellt die Pipeline Ihre Web-Stufenkonfiguration nicht bereit. Wenn für dieselbe Umgebung bereits eine Web-Stufen-Konfigurations-Pipeline vorhanden ist, wird dieses Kontrollkästchen automatisch aktiviert und deaktiviert, da diese Pipeline stattdessen die Web-Stufen-Konfiguration verwaltet. Wenn keine Web-Stufen-Konfigurations-Pipeline vorhanden ist, können Sie diese Option aktivieren oder deaktivieren, um zu steuern, ob die Full-Stack-Pipeline die Dispatcher-Konfiguration bereitstellt.
-
Klicken Sie Weiter, um zur Registerkarte Staging-Tests zu gelangen. Weitere Informationen finden unter .
Web-Stufen-Konfiguration web-tier-config
Eine Web-Stufen-Konfigurations-Pipeline stellt nur die HTTPD-/Dispatcher-Konfiguration bereit. Weitere zu diesem Pipeline-Typ finden unter CI/CD-Pipelines .
Wenn Sie eine Konfigurations-Pipeline auf Web-Ebene für eine Umgebung mit einer vorhandenen Full-Stack-Pipeline erstellen, wird die Konfiguration auf Web-Ebene in der Full-Stack-Pipeline ignoriert. Diese Änderung betrifft nur die Web-Stufen-Konfiguration in dieser Umgebung.
So konfigurieren Sie eine Web-Stufen-Konfigurations-Produktions-Pipeline:
-
Definieren Sie auf der Registerkarte Quell-Code die folgenden Optionen:
- Repository - Wählen Sie in der Dropdown-Liste das Git-Repository aus, das die Web-Stufen-Konfiguration enthält.
- Git-Verzweigung - Wählen Sie die Verzweigung im ausgewählten Repository aus, die Cloud Manager für die Bereitstellung verwendet.
- Code-Speicherort - Geben Sie den Pfad in das ausgewählte Repository ein, das die bereitzustellende Web-Stufen-Konfiguration enthält. Der Standardspeicherort ist der Repository-Stamm (
/).
note NOTE Wenn der Code-Speicherort nicht auf den Dispatcher-Code-Speicherort verweist, kann zusätzlicher Anwendungs-Code in das Artefaktpaket gezogen und im Dispatcher bereitgestellt werden, was dazu führt, dass Apache beim Neustart fehlschlägt und die Pipeline fehlschlägt. Stellen Sie sicher, dass Sie den richtigen Pfad zu den Dispatcher-Dateien im Repository festlegen. 
-
Klicken Sie Weiter, um zur Registerkarte Staging-Tests zu gelangen. Weitere Informationen finden unter .
Verwenden von Smart Build in einer Produktions-Pipeline about-smart-build
Smart Build in Cloud Manager ist eine optimierte Build-Strategie für Produktions-Pipelines. Smartes Erstellen reduziert Build-Zeiten, indem Module zwischengespeichert und nur die Module neu erstellt werden, die seit der letzten erfolgreichen Ausführung geändert wurden. Unveränderte Module werden aus dem Cache wiederverwendet, während nur geänderte Module und ihre Abhängigkeiten neu erstellt werden, was die Effizienz für Workflows für die iterative Entwicklung verbessert.
Smart Build ist derzeit für Folgendes verfügbar:
- Code-Qualitäts-Pipelines
- Implementierungs-Pipelines für Entwicklung, Staging und Produktion mit Full-Stack.
Smartes Erstellen wird empfohlen, wenn Folgendes zutrifft:
- Sie entwickeln aktiv und nehmen häufige inkrementelle Änderungen vor.
- Ihr Projekt enthält mehrere Maven-Module.
- Vollständige Builds beanspruchen viel Zeit.
Smartes Erstellen ist nicht immer ideal, wenn Folgendes zutrifft:
- Ihr Build beruht in hohem Maße auf Plug-ins, die Vorgänge außerhalb des Abhängigkeitsdiagramms von Maven durchführen.
- Sie benötigen bei jeder Ausführung eine vollständige Neuaufbauvalidierung.
Grundlegendes zur Build-Leistung smart-build-performance
Der Leistungsgewinn durch die Verwendung von Smart Build hängt von mehreren Faktoren ab, darunter den folgenden:
- Die Anzahl der Module im Projekt.
- Häufigkeit und Umfang von Code-Änderungen.
- Die Verteilung von Abhängigkeiten über Module hinweg.
Die größte Verbesserung können Projekte mit vielen unabhängigen Modulen verzeichnen.
Opt-out aus dem Cache pro Modul smart-build-cache-optout
Smart Build bietet eine differenzierte Steuerung, mit der Sie das Caching für bestimmte Module deaktivieren können. Diese Funktion ist nützlich, wenn bestimmte Module:
- Verwenden Sie Plug-ins wie
exec-maven-pluginodermaven-antrun-plugin. - Führen Sie Dateivorgänge aus, die nicht von Maven-Abhängigkeiten verfolgt werden.
- Erzeugt im Cache inkonsistente Ergebnisse.
Deaktivieren der Zwischenspeicherung für ein Modul smart-build-disable-caching
Sie können die folgende Eigenschaft zum pom.xml des betroffenen Moduls hinzufügen:
<properties>
<maven.build.cache.enabled>false</maven.build.cache.enabled>
</properties>
Diese Syntax zwingt das Modul bei jeder Pipeline-Ausführung neu zu erstellen, während andere Module weiterhin vom Caching profitieren.
Einschränkungen und Überlegungen bei der Verwendung von Smart Build smart-build-limitations
Beachten Sie bei der Verwendung von Smart Build Folgendes:
- Smarter Build beruht auf Maven-Abhängigkeitsanalyse.
- Bei Änderungen außerhalb des Abhängigkeitsdiagramms werden Trigger-Neuaufbauten nicht unterstützt.
- Einige Plug-ins sind nicht vollständig mit der Zwischenspeicherung kompatibel.
- Sie können jederzeit wieder zu Vollständiger Build wechseln, indem Sie die Produktions-Pipeline bearbeiten.
Wenn Sie auf unerwartetes Build-Verhalten stoßen, sollten Sie das Caching für bestimmte Module deaktivieren oder Ihre Build-Strategie vorübergehend auf Vollständiger Build umstellen.
Beheben von Problemen mit der intelligenten Erstellung smart-build-troubleshoot
・ Überprüfen des Plug-in-Verhaltens (insbesondere
exec/antrun-Plug-ins).・ Prüfen Sie, ob die meisten Module häufig wechseln.
・ Verwenden Sie Vollständiger Build zur Überprüfung.
Informationen zum Aktivieren von Smart Build Sie unter „Hinzufügen einer Produktions-Pipeline.
Die nächsten Schritte the-next-steps
Nachdem die Konfiguration der Pipeline abgeschlossen ist, müssen Sie Ihren Code bereitstellen. Weitere Informationen finden Sie unter Bereitstellung von Code.
Video-Tutorial video-tutorial-one
In diesem Video erhalten Sie einen Überblick über den Pipeline-Erstellungsprozess, der in diesem Dokument beschrieben wird.