Konfigurieren von Produktions-Pipelines

Erfahren Sie, wie Sie mit Cloud Manager Produktions-Pipelines zur Bereitstellung Ihres Codes erstellen und konfigurieren. Wenn Sie zunächst einen konzeptionellen Überblick darüber erhalten möchten, wie Pipelines in Cloud Manager funktionieren, finden Sie im Dokument weitere Informationen. CI/CD Pipelines.

Übersicht

Verwenden der Pipeline-Einstellungen Kachel in Cloud Manager Sie können zwei verschiedene Pipelinetypen erstellen.

  • Produktions-Pipelines - Eine Produktions-Pipelines ist eine speziell entwickelte Pipeline, die aus einer Reihe aufeinander abgestimmter Schritte besteht, um Quellcode aus Ihrem Git-Repository bis zur Produktion zu übernehmen.
  • Produktionsfremde Pipelines: Eine produktionsfremde Pipeline dient dazu, Code-Qualitätsprüfungen durchzuführen oder Quel-Code in einer Entwicklungsumgebung bereitzustellen.

Dieses Dokument konzentriert sich auf Produktions-Pipelines. Weitere Informationen zur Konfiguration von produktionsfremden Pipelines finden Sie unter Konfigurieren von produktionsfremden Pipelines.

Die Rolle Implementierungs-Manager ist für die Einrichtung der Pipeline verantwortlich. Die Pipeline-Konfiguration besteht aus folgenden Schritten:

  1. Definition des Auslösers, der die Pipeline startet
  2. Definition der Parameter zur Steuerung der Produktionsbereitstellung
  3. Konfiguration der Leistungstestparameter
HINWEIS

Die Pipeline kann erst eingerichtet werden, wenn das Git-Repository mindestens eine Verzweigung hat und die Programmeinrichtung abgeschlossen ist.

Video-Tutorial

In diesem Video erhalten Sie einen Überblick über den Pipeline-Erstellungsprozess, der in diesem Dokument beschrieben wird.

Hinzufügen einer neuen Produktions-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.

  1. Melden Sie sich unter my.cloudmanager.adobe.com bei Cloud Manager an und wählen Sie die entsprechende Organisation und das entsprechende Programm aus.

  2. Navigieren Sie von der Seite Programmübersicht zur Karte Pipelines und klicken Sie auf Hinzufügen und wählen Sie Produktions-Pipeline hinzufügen aus.

    Produktions-Pipeline hinzufügen

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

    1. Geben Sie in das Feld Name der Pipeline einen beschreibenden Namen für die Pipeline ein.

    2. Im Abschnitt Quell-Code definieren Sie, wo die Pipeline den Code abruft, den sie verarbeitet.

      • Repository: Diese Option legt fest, aus welchem Git-Repository die Pipeline den Code abrufen soll.
      TIPP

      Siehe Dokument . Programmeinrichtung , um zu erfahren, wie Sie Repositorys in Cloud Manager hinzufügen und verwalten.

      • Git-Verzweigung: Mit dieser Option wird festgelegt, von welchem Zweig in der ausgewählten Pipeline der Code abgerufen werden soll.
      • 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.

      Repos für die Pipeline definieren

    3. Im Abschnitt Umgebungen legen Sie fest, wodurch eine Bereitstellung ausgelöst wird und wie sie in den einzelnen Umgebungen ausgeführt werden soll.

      1. 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: Verwenden Sie diese Option, um die Pipeline manuell über die Cloud Manager-Benutzeroberfläche 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.
        • Verhalten bei bedeutenden Metrikfehlern: Bei der Einrichtung oder Bearbeitung der Pipeline kann der Implementierungs-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: Das ist die Standardeinstellung und erfordert manuelles Eingreifen bei einem wichtigen Fehler.
          • Sofortiger Ausfall: Wenn diese Option ausgewählt ist, wird die Pipeline bei einem gravierenden Fehler abgebrochen. Damit wird im Grunde ein Benutzer simuliert, der manuell jeden Fehler ablehnt.
          • Sofort fortfahren: Wenn diese Option ausgewählt ist, wird die Pipeline bei einem wichtigen Fehler automatisch fortgesetzt. Damit wird im Grunde ein Benutzer simuliert, der manuell jeden Fehler genehmigt.

        Bereitstellungsauslöser

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

        Staging-Bereitstellungsoptionen

        • Dispatcherkonfiguration: Die Rolle Implementierungs-Manager kann eine Reihe von Inhaltspfaden konfigurieren, die entweder ungültig gemacht oder aus dem AEM-Dispatcher-Cache gelöscht werden, wenn eine Pipeline ausgeführt wird. Wenn diese Cache-Aktionen konfiguriert sind, werden sie im Rahmen der Einrichtung der Bereitstellungs-Pipeline direkt nach der Bereitstellung etwaiger Inhaltspakete durchgeführt. Diese Einstellungen verwenden das Standardverhalten von AEM Dispatcher. Konfigurieren:

          1. Geben Sie unter PATH einen Pfad für den Inhalt an.
          2. Wählen Sie unter TYPE die Aktion aus, die mit dem Pfad durchgeführt werden soll.
          • Leeren: Eine Cache-Invalidierung durchführen, ähnlich wie bei der Aktivierung von Inhalten von einer Autoreninstanz auf einer Veröffentlichungsinstanz.
          • Invalidieren: Cache-Löschung durchführen.
          1. Klicken Sie auf Pfad hinzufügen, um den angegebenen Pfad hinzuzufügen. Sie können bis zu 100 Pfade pro Umgebung hinzufügen.

        Dispatcherkonfiguration

        TIPP

        Generell ist die Aktion „Invalidieren“ vorzuziehen. In einigen Fällen ist jedoch eine Leerung erforderlich, insbesondere bei Verwendung von AEM-HTML-Client-Bibliotheken.

      2. 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: Für die Bereitstellung ist eine manuelle Genehmigung durch einen Benutzer mit der Rolle Geschäftsinhaber, Projekt-Manager oder Implementierungs-Manager über die Benutzeroberfläche von Cloud Manager erforderlich.
          • Geplant: Mit dieser Option wird die Pipeline vor der Produktionsbereitstellung angehalten, sodass sie geplant werden kann. Wenn diese Option ausgewählt ist, wird die Pipeline nach der Bereitstellung in der Staging-Umgebung angehalten und der Benutzer wird aufgefordert, die entsprechenden Maßnahmen zu ergreifen.
            • Jetzt: Bei Auswahl dieser Option erfolgt sofort die Bereitstellung in der Produktion und die Pipeline wird damit abgeschlossen.
            • Datum: Mit dieser Option kann der Benutzer einen Zeitpunkt festlegen, zu dem die Bereitstellung abgeschlossen sein soll.
            • Ausführung stoppen: Mit dieser Option wird die Bereitstellung in der Produktionsumgebung abgebrochen.
          TIPP

          Weitere Informationen finden Sie im Dokument . Codebereitstellung, , um zu erfahren, wie Sie den Bereitstellungsplan festlegen oder die Pipeline sofort ausführen.

          • CSE-Überwachung nutzen: Bei Auswahl dieser Option wird ein CSE eingeschaltet, um die Bereitstellung tatsächlich zu starten. Wenn diese Option aktiviert ist, während eine Pipeline erstellt oder bearbeitet wird, hat die Rolle Implementierungs-Manager folgende Optionen.

            • Beliebiger CSE: Bei Auswahl dieser Option kann jeder verfügbare CSE die Bereitstellung starten.
            • Mein CSE: Bei Auswahl dieser Option kann nur der dem Kunden zugewiesene CSE die Bereitstellung starten. Dies gilt auch für den designierten CSE-Backup, wenn der CSE nicht verfügbar ist.

          Optionen für die Produktionsbereitstellung

        • Dispatcherkonfiguration: Definiert die Dispatcher-Konfiguration für die Produktionsumgebung. Es sind die gleichen Optionen wie für die Staging-Umgebung verfügbar.

  4. Klicken Sie auf Weiter, um zur Registerkarte Staging-Test zu gelangen, auf der Sie Leistungstests für AEM Sites und AEM Assets konfigurieren können, je nachdem, welche Produkte Sie lizenziert haben.

    TIPP

    Siehe Dokument . Tests der Code-Qualität Weitere Informationen zu den verfügbaren Optionen finden Sie unter Staging-Tests Registerkarte.

    1. Im Abschnitt Site-Inhaltsbereitstellung/verteilte Lastgewichtung legen Sie fest, wie die Leistungstests für Sites konfiguriert werden, basierend auf der Gewichtung der Seitenanfragen zwischen den drei Seitensätzen, die aktiviert oder deaktiviert werden können.

      • Beliebte Live-Seiten
      • Andere Live-Seiten
      • Neue Seiten

      Sites-Lastgewichtung

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

        1. FORMAT: Wählen Sie aus, ob das benutzerdefinierte Asset eine PDF-Datei eines Bilds ist.
        2. DATEINAME: Verwenden Sie die Schaltfläche „Datei-Browser“, um ein Bild auf Ihrem lokalen Computer auszuwählen.
        3. Testdatei hinzufügen: Klicken Sie darauf, um das ausgewählte Asset hochzuladen.

      Assets-Testverteilung

  5. Klicken Sie auf Speichern, um das Hinzufügen der Produktions-Pipeline abzuschließen.

Die nächsten Schritte

Nachdem die Konfiguration der Pipeline abgeschlossen ist, müssen Sie Ihren Code bereitstellen. Lesen Sie das Dokument Codebereitstellung für weitere Details.

Auf dieser Seite