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.
NOTE
Nach der Ersteinrichtung können Sie Pipeline-Einstellungen bearbeiten.

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.

  1. 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.

  1. 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.

    Produktionsfremde Pipeline hinzufügen

  2. 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.

    Dialogfeld „Produktionsfremde Pipeline hinzufügen“

  3. 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.
  4. 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.
  5. Klicken Sie auf Weiter.

  6. 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.

NOTE
Wenn für die ausgewählte Umgebung bereits eine Pipeline mit Full-Stack-Code vorhanden ist, wird diese Auswahl deaktiviert.

Führen Sie die folgenden Schritte aus, um die Konfiguration der produktionsfremden Full-Stack-Code-Pipeline abzuschließen.

  1. 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.

    Full-Stack-Pipeline

  2. 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.

  1. Wählen Sie den benötigten Bereitstellungstyp aus.

Zielgerichtete Bereitstellungsoptionen

  1. 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.
  2. 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.

    Konfigurations-Pipeline

  3. 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>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab