Konfigurieren von Pipeline-Variablen configuring-pipeline-variables

Der Build-Prozess kann von bestimmten Konfigurationsvariablen abhängen, die nicht im Git-Repository platziert werden können oder zwischen Pipeline-Ausführungen mit derselben Verzweigung variieren müssen.  Mit Cloud Manager können Sie diese Daten als Pipeline-Variablen verwalten.

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 mit Data-at-Rest-Verschlüsselung gespeichert werden. In beiden Fällen werden Variablen innerhalb der Build-Umgebung als Umgebungsvariable bereitgestellt, die in der pom.xml-Datei oder anderen Build-Skripten referenziert werden kann.

Namenskonventionen für Pipeline-Variablen naming-conventions

Variablennamen müssen die folgenden Konventionen einhalten.

  • Variablen dürfen nur alphanumerische Zeichen und den 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.

Über die Benutzeroberfläche von Cloud Manager ui

Pipeline-Variablen können über die Cloud Manager-Benutzeroberfläche konfiguriert und verwaltet werden. 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.

Hinzufügen von Pipeline-Variablen add-ui

  1. Tippen oder klicken Sie bei der Verwaltung Ihrer Pipelinesauf die Schaltfläche mit den Auslassungspunkten der Pipeline, für die Sie Pipeline-Variablen erstellen möchten, und wählen Sie im Kontextmenü Variablen anzeigen/bearbeiten aus.

    Pipeline-Variablen anzeigen/bearbeiten

  2. Das Fenster  Variablenkonfiguration  wird geöffnet. Geben Sie die Variablendetails in die erste Zeile der Tabelle ein und tippen oder klicken Sie auf Hinzufügen.

    • Konfigurationsname ist eine eindeutige Kennung für Ihre Variable, die die Namenskonventionen für Pipeline-Variablen befolgen muss.

    • Wert ist der Wert, den die Variable enthält.

    • Angewandter Schritt ist der Schritt in der Pipeline, für den die Variable gilt. Dieser Schritt ist erforderlich.

      • Build
      • Funktionsprüfung
      • UI-Tests
    • Typ definiert, ob es sich bei der Variablen um reinen Text handelt oder ob sie als geheim verschlüsselt wurde.

    Variable hinzufügen

  3. Wird der Tabelle hinzugefügt. Fügen Sie weitere Variablen nach Bedarf hinzu und tippen oder klicken Sie dann auf Speichern, um die Variablen zu speichern, die Sie der Pipeline hinzugefügt haben.

Bearbeiten von Pipeline-Variablen edit-ui

  1. Tippen oder klicken Sie bei der Verwaltung Ihrer Pipelines auf die Schaltfläche mit Auslassungspunkten der Pipeline, für die Sie Pipeline-Variablen erstellen möchten, und wählen Sie Variablen anzeigen/bearbeiten im Kontextmenü aus.

    Pipeline-Variablen anzeigen/bearbeiten

  2. Das Fenster  Variablenkonfiguration  wird geöffnet. Tippen oder klicken Sie auf die Schaltfläche mit den Auslassungspunkten für die zu bearbeitende Variable und wählen Sie Bearbeiten aus.

    Variable bearbeiten

  3. Aktualisieren Sie den Wert der Variablen nach Bedarf und tippen oder klicken Sie dann auf Anwenden (das Häkchen am Ende der Zeile), um die Änderung anzuwenden, oder auf  Verwerfen (Pfeil nach hinten), um die Änderung rückgängig zu machen.

    • Nur der Wert der Variablen kann bearbeitet werden.

    Bearbeiten einer Variable

  4. Tippen oder klicken Sie auf Speichern, um die Änderungen zu speichern, die Sie an den Variablen in der Pipeline vorgenommen haben.

Wenn Sie eine Variable löschen möchten, wählen Sie im Fenster Variablenkonfiguration  aus dem Menü mit den Auslassungspunkten der Pipeline-Variablen Löschen anstelle von Bearbeiten aus.

Verwenden der Cloud Manager-CLI cli

Dieser CLI-Befehl 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 ähnlichen Syntax wie dieser zuzuordnen.

        <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