DokumentationAEM as a Cloud ServiceBenutzerhandbuch

Pipeline-Variablen in Cloud Manager configuring-pipeline-variables

Last update: Thu Oct 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
  • Entwickler

Ihr Build-Prozess basiert möglicherweise auf bestimmten Konfigurationsvariablen, die nicht im Git-Repository gespeichert werden sollen. Oder Sie müssen sie ggf. zwischen Pipeline-Ausführungen in 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 können entweder als reiner Test oder im Ruhezustand verschlüsselt gespeichert werden. In beiden Fällen werden Variablen innerhalb der Build-Umgebung als Umgebungsvariable bereitgestellt, die dann in der Datei pom.xml 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 helfen beim Optimieren der Pipeline-Verwaltung, insbesondere wenn unterschiedliche Konfigurationen in verschiedenen Schritten 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.
    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 Pipelinesauf 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 Pipelinesauf 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 Befehl in der Befehlszeilenschnittstelle legt eine Variable fest.

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

Dieser Befehl listet 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
fbcff2a9-b6fe-4574-b04a-21e75df764ab