Konfigurera pipeline-variabler configuring-pipeline-variables
Din byggprocess kan vara beroende av specifika konfigurationsvariabler som skulle vara olämpliga att placera i Git-databasen, eller så måste du variera dem mellan pipeline-körningar som använder samma gren. Med Cloud Manager kan du hantera dessa data som pipeline-variabler.
Rörledningsvariabler pipeline-variables
Med Cloud Manager kan du konfigurera pipeline-variabler på flera olika sätt.
Variabler kan lagras som antingen oformaterad text eller krypteras i vila. I båda fallen görs variabler tillgängliga i byggmiljön som en miljövariabel som sedan kan refereras inifrån filen pom.xml eller andra byggskript.
Variabla namngivningskonventioner för pipeline naming-conventions
Variabelnamn måste följa följande konventioner.
- Variabler får endast innehålla alfanumeriska tecken och understreck (
_). - Namnen ska vara versaler.
- Det finns en gräns på 200 variabler per pipeline.
- Varje namn får innehålla högst 100 tecken.
- Varje
string-variabelvärde måste vara kortare än 2 048 tecken. - Varje
secretString-typvariabelvärde måste vara högst 500 tecken.
Via användargränssnittet i Cloud Manager ui
Pipeline-variabler kan konfigureras och hanteras via Cloud Manager UI. Du måste ha behörighet att redigera pipelinen för att kunna lägga till, redigera och ta bort pipelinevariabler.
Om en pipeline körs blockeras variabelhanteringen.
Lägga till pipeline-variabler add-ui
-
När du hanterar dina pipelines: trycker eller klickar du på ellipsknappen för den pipeline som du vill skapa pipelinevariabler för och väljer Visa/redigera variabler på snabbmenyn.
-
Fönstret Variabelkonfiguration öppnas. Ange variabelinformationen i den första raden i tabellen och tryck eller klicka på Lägg till.
-
Konfigurationsnamn är en unik identifierare för variabeln, som måste ha huvudansvaret för namngivningskonventioner för pipeline-variabler.
-
Värde är det värde som variabeln innehåller.
-
Steg som används är det steg i pipeline som variabeln gäller för. Det krävs.
- Bygg
- Funktionstestning
- UI-testning
-
Type definierar om variabeln är oformaterad text eller krypterad som en hemlighet.
-
-
Tabellen läggs till i tabellen. Lägg till ytterligare variabler efter behov och tryck eller klicka sedan på Spara för att spara de variabler du lade till i pipeline.
Redigera rörledningsvariabler edit-ui
-
När du hanterar dina pipelines: trycker eller klickar du på ellipsknappen för den pipeline som du vill skapa pipelinevariabler för och väljer Visa/redigera variabler på snabbmenyn.
-
Fönstret Variabelkonfiguration öppnas. Tryck eller klicka på ellipsknappen för variabeln som du vill redigera och välj Redigera.
-
Uppdatera variabelvärdet efter behov och tryck eller klicka på Använd (bockmarkeringen i slutet av raden) för att tillämpa ändringen eller Ignorera (bakåtpilen) för att återställa ändringen.
- Endast variabelns värde kan redigeras.
-
Tryck eller klicka på Spara för att spara ändringarna du gjort i variablerna i pipeline.
Om du vill ta bort en variabel väljer du Ta bort i stället för Redigera på ellipsmenyn för pipelinevariabeln i fönstret Variabelkonfiguration.
Använda Cloud Manager CLI cli
Det här CLI-kommandot ställer in en variabel.
$ aio cloudmanager:set-pipeline-variables PIPELINEID --variable MY_CUSTOM_VARIABLE test
Det här kommandot listar variabler.
$ aio cloudmanager:list-pipeline-variables PIPELINEID
När de används i en Maven pom.xml-fil är det oftast bra att mappa dessa variabler till Maven-egenskaper med en syntax som liknar den här.
<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>