DokumentationAEMBenutzerhandbuch

Pipeline-Variablen in Cloud Manager configuring-pipeline-variables

Letzte Aktualisierung: 6. November 2025
  • Gilt für:
  • Experience Manager as a Cloud Service

Erstellt für:

  • Admin
  • Developer

Ihr Build-Prozess verwendet bestimmte Konfigurationsvariablen, die nicht im Git-Repository gespeichert sind. Oder Sie müssen sie zwischen Pipeline-Ausführungen auf derselben Verzweigung anpassen. Mit Cloud Manager können Sie diese Einstellungen als Pipeline-Variablen verwalten.

Über Pipeline-Variablen pipeline-variables

Mithilfe von Cloud Manager können Sie Pipeline-Variablen auf verschiedene Arten konfigurieren.

Variablen werden entweder als reiner Text oder im Ruhezustand verschlüsselt gespeichert. Variablen sind innerhalb der Build-Umgebung als Umgebungsvariable verfügbar, die dann von der pom.xml-Datei oder anderen Build-Skripten referenziert werden kann.

Hinzufügen einer Pipeline-Variablen über Cloud Manager ui

Pipeline-Variablen können über die Cloud Manager-Benutzeroberfläche konfiguriert und verwaltet werden. Sie vereinfachen die Pipeline-Verwaltung, insbesondere wenn in verschiedenen Schritten unterschiedliche Konfigurationen erforderlich sind.

Sie müssen über Berechtigungen zum Bearbeiten der Pipeline verfügen, um Pipeline-Variablen hinzufügen, bearbeiten und löschen zu können.

Wenn eine Pipeline ausgeführt wird, wird die Variablenverwaltung blockiert.

So fügen Sie eine Pipeline-Variable über Cloud Manager hinzu:

  1. Klicken Sie beim Verwalten Ihrer Pipelines auf das Symbol Auslassungspunkte – Mehrsymbol der Pipeline, für die Pipeline-Variablen erstellt werden sollen.

  2. Klicken Sie im Dropdown-Menü auf Variablen anzeigen/bearbeiten.

    Bearbeiten/Anzeigen von Pipeline-Variablen

  3. Geben Sie im Dialogfeld Variablenkonfiguration die Details in die erste Zeile der Tabelle ein.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Feld Beschreibung
    Name

    Ein eindeutiger Name der Konfigurationsvariablen. Er identifiziert die spezifische Variable, die in der Pipeline verwendet wird, und muss den folgenden Namenskonventionen entsprechen:

    • Variablen dürfen nur alphanumerische Zeichen und einen Unterstrich (_) enthalten.
    • Die Namen sollten in Großbuchstaben geschrieben sein.
    • Pro Pipeline sind maximal 200 Variablen zulässig.
    • Jeder Name darf maximal 100 Zeichen lang sein.
    • Jede string-Variable darf höchstens 2047 Zeichen enthalten.
    • Jede Variable des Typs secretString darf maximal 500 Zeichen enthalten.
    Wert Der Wert, den die Variable enthält.
    Angewendeter Schritt

    Erforderlich. Der Schritt in der Pipeline, für den die Variable gilt:

    • Build: Die Variable wird während des Build-Prozesses angewendet.
    • Funktionsprüfung: Die Variable wird während des Schritts „Funktionsprüfung“ verwendet.
    • UI-Tests – Die Variable wird während der UI-Testphase verwendet.
    • Bereitstellen - Die Variable wird während des Bereitstellungsschritts verwendet. Verwenden Sie diese Variable beispielsweise für Edge Delivery Services-Pipelines.
    Typ Wählen Sie aus, ob es sich bei der Variablen um reinen Text handelt oder ob sie als geheim verschlüsselt wurde.

    Variable hinzufügen

  4. Klicken Sie auf Hinzufügen.

    Fügen Sie nach Bedarf weitere Variablen hinzu.

  5. Klicken Sie auf Speichern.

Bearbeiten einer Pipeline-Variablen edit-ui

  1. Klicken Sie bei der Verwaltung Ihrer Pipelines ​ auf Auslassungspunkte – Mehr-Symbol neben der Pipeline, für die Sie Pipeline-Variablen bearbeiten möchten.

  2. Klicken Sie im Dropdown-Menü auf Variablen anzeigen/bearbeiten.

    Pipeline-Variablen anzeigen/bearbeiten

  3. Klicken Sie im Dialogfeld Variablenkonfiguration auf Auslassungspunkte – Mehr-Symbol der Variable, die Sie ändern möchten.

  4. Klicken Sie im Dropdown-Menü auf Bearbeiten.

    Variable bearbeiten

  5. Aktualisieren Sie den Wert der Variablen nach Bedarf.

    Nur der Wert der Variablen kann geändert werden.

  6. Führen Sie einen der folgenden Schritte aus:

    • Klicken Sie auf Apply - Checkmark icon , um die Änderung anzuwenden.
    • Klicken Sie auf Undo icon , um die Änderung zurückzusetzen.

  7. Klicken Sie auf Speichern.

Löschen einer Pipeline-Variablen delete-ui

  1. Klicken Sie bei der Verwaltung Ihrer Pipelines ​ auf Auslassungspunkte – Mehr-Symbol neben der Pipeline, für die Sie Pipeline-Variablen löschen möchten.

  2. Klicken Sie im Dropdown-Menü auf Variablen anzeigen/bearbeiten.

    Pipeline-Variablen anzeigen/bearbeiten

  3. Klicken Sie im Dialogfeld Variablenkonfiguration auf Auslassungspunkte – Mehr-Symbol neben der Variable, die Sie entfernen möchten. Klicken Sie anschließend auf Löschen.

Festlegen von Pipeline-Variablen mithilfe der Cloud Manager-Befehlszeilenschnittstelle cli

Dieser CLI-Befehl (Command Line Interface) konfiguriert Variablen.

$ aio cloudmanager:set-pipeline-variables PIPELINEID --variable MY_CUSTOM_VARIABLE test

Dieser Befehl listet die Variablen auf.

$ aio cloudmanager:list-pipeline-variables PIPELINEID

Bei Verwendung in einer Maven-Datei pom.xml ist es in der Regel hilfreich, diese Variablen Maven-Eigenschaften mithilfe einer Syntax zuzuordnen, die dem folgenden Beispiel ähnelt:

        <profile>
            <id>cmBuild</id>
            <activation>
                <property>
                    <name>env.CM_BUILD</name>
                </property>
            </activation>
            <properties>
                <my.custom.property>${env.MY_CUSTOM_VARIABLE}</my.custom.property>
            </properties>
        </profile>
recommendation-more-help
experience-manager-cloud-service-help-main-toc