Proměnné verze a artefakty Classic

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 – TFS 2015

při vytváření úloh pro nasazení aplikace do každé fáze v DevOps procesy CI/CD vám proměnné pomůžou:

• Definujte obecnější kanál nasazení jednou a pak ho pro každou fázi snadno přizpůsobte. Proměnnou lze například použít k reprezentaci připojovacího řetězce pro nasazení webu a hodnotu této proměnné lze změnit z jedné fáze na jinou. Jedná se o vlastní proměnné.

• Použijte informace o kontextu konkrétní verze, fáze, artefaktůnebo agenta , ve kterém se spouští kanál nasazení. Skript může například potřebovat přístup k umístění sestavení, aby ho stáhl nebo do pracovního adresáře v agentovi a vytvořil dočasné soubory. Jedná se o výchozí proměnné.

Výchozí proměnné

Informace o kontextu spuštění jsou zpřístupněny pro spuštěné úlohy prostřednictvím výchozích proměnných. Pomocí těchto proměnných můžou vaše úkoly a skripty najít informace o systému, vydané verzi, fázi nebo agentovi, na kterých běží. S výjimkou System. Debugjsou tyto proměnné jen pro čtení a jejich hodnoty jsou automaticky nastaveny systémem. Některé z nejvýznamnějších proměnných jsou popsány v následujících tabulkách. Úplný seznam naleznete v tématu zobrazení aktuálních hodnot všech proměnných.

Systém

Vydat

Fáze vydání

Agent

Obecný artefakt

Pro každý artefakt, na který je odkazováno v vydané verzi, můžete použít následující proměnné artefaktů. Ne všechny proměnné jsou smysluplné pro každý typ artefaktu. Následující tabulka uvádí výchozí proměnné artefaktů a obsahuje příklady hodnot, které mají v závislosti na typu artefaktu. Pokud je příklad prázdný, znamená to, že pro tento typ artefaktu není naplněna proměnná.

{alias}Zástupný text nahraďte hodnotou, kterou jste zadali pro {alias} , nebo s výchozí hodnotou generovanou pro kanál verze.

Viz také alias zdroje artefaktů .

Primární artefakt

Jeden z artefaktů určíte jako primární artefakt v kanálu vydání. pro určený primární artefakt Azure Pipelines naplní následující proměnné.

Použít výchozí proměnné

Výchozí proměnné můžete použít dvěma způsoby – jako parametry úloh v kanálu vydání nebo ve vašich skriptech.

Můžete přímo použít výchozí proměnnou jako vstup pro úlohu. Například pro předání Release.Artifacts.{Artifact alias}.DefinitionName zdroji artefaktu, jehož alias je Release.Artifacts.{Artifact alias}.DefinitionName do úlohy byste mohli použít $(Release.Artifacts.ASPNET4.CI.DefinitionName) .

Chcete-li použít výchozí proměnnou ve skriptu, je nutné nejprve nahradit . výchozí názvy proměnných pomocí _ . Například pro tisk hodnoty proměnné artefaktu Release.Artifacts.{Artifact alias}.DefinitionName pro zdroj artefaktu, jehož alias je Release.Artifacts.{Artifact alias}.DefinitionName ve skriptu PowerShellu použijete $env:RELEASE_ARTIFACTS_ASPNET4_CI_DEFINITIONNAME .

Všimněte si, že původní název aliasu zdroje artefaktu ASPNET4.CI je nahrazen ASPNET4_CI .

Zobrazit aktuální hodnoty všech proměnných

1. Otevřete zobrazení kanálů souhrnu pro danou verzi a vyberte fázi, které vás zajímá. V seznamu kroků klikněte na možnost inicializovat úlohu.

   

2. Tím se otevře protokol pro tento krok. Posuňte se dolů a zobrazte hodnoty používané agentem pro tuto úlohu.

   

Spustit vydání v režimu ladění

Zobrazit další informace ve formě vydání a v souborech protokolu spuštěním celé vydané verze nebo pouze úkolů v jednotlivých fázích vydané verze v režimu ladění. To může být užitečné při řešení problémů a selhání.

• Chcete-li spustit režim ladění pro celou vydanou verzi, přidejte proměnnou s názvem System.Debug s hodnotou true na kartu System.Debug kanálu vydání.

• Chcete-li spustit režim ladění pro jednu fázi, otevřete dialogové okno Konfigurovat fázi v místní nabídce fáze a přidejte proměnnou s názvem s hodnotou true na kartu true .

• Případně vytvořte skupinu proměnných obsahující proměnnou s názvem s hodnotou true a propojte tuto skupinu proměnných s kanálem verze.

Vlastní proměnné

Vlastní proměnné lze definovat v různých oborech.

• Sdílejte hodnoty napříč všemi definicemi v projektu pomocí skupin proměnných. Vyberte skupinu proměnných, pokud potřebujete použít stejné hodnoty napříč všemi definicemi, fázemi a úlohami v projektu a chcete mít možnost změnit hodnoty na jednom místě. Skupiny proměnných definujete a spravujete na kartě Knihovna .

• Sdílejte hodnoty napříč všemi fázemi pomocí proměnných kanálu uvolnění. Pokud potřebujete použít stejnou hodnotu napříč všemi fázemi a úlohami v kanálu verze, vyberte proměnnou kanálu vydání a chcete mít možnost změnit hodnotu na jednom místě. Tyto proměnné definujete a spravujete na kartě proměnné v kanálu vydání. Na stránce proměnné kanálu otevřete rozevírací seznam rozsah a vyberte verze. Ve výchozím nastavení platí, že když přidáte proměnnou, je nastavena na rozsah verze.

• Sdílejte hodnoty napříč všemi úkoly v rámci jedné konkrétní fáze pomocí proměnných fáze. Použijte proměnnou na úrovni fáze pro hodnoty, které se liší od fáze do fáze (a jsou stejné pro všechny úlohy ve fázi). Tyto proměnné definujete a spravujete na kartě proměnné kanálu vydání. Na stránce proměnné kanálu otevřete rozevírací seznam rozsah a vyberte požadovanou fázi. Když přidáte proměnnou, nastavte obor na příslušné prostředí.

Použití vlastních proměnných v rámci projektu, kanálu vydání a rozsahu fáze vám pomůže:

• Vyhněte se duplicitám hodnot, což usnadňuje aktualizaci všech výskytů jako jedné operace.

• Uložte citlivé hodnoty tak, aby je uživatelé kanálu vydané verze neviděli nebo nezměnili. Určete vlastnost konfigurace tak, aby byla zabezpečená (tajná) proměnná, a to tak, že vyberete ikonu (visacího zámku nezobrazuje) vedle proměnné.

  Důležité

  Hodnoty skrytých (tajných) proměnných jsou bezpečně uložené na serveru a uživatelé je po uložení nedají zobrazit. během nasazení služba Azure Pipelines release dešifruje tyto hodnoty, když na ně odkazují úkoly a předá je agentovi přes zabezpečený kanál HTTPS.

Použití vlastních proměnných

Chcete-li použít vlastní proměnné v úlohách sestavení a vydání, jednoduše vložte název proměnné do závorek a před ni uveďte $ znak. Například pokud máte proměnnou s názvem adminUserName, můžete vložit aktuální hodnotu proměnné do parametru úlohy jako .

Definování a úprava proměnných ve skriptu

Chcete-li definovat nebo upravit proměnnou ze skriptu, použijte task.setvariable příkaz Logging. Všimněte si, že aktualizovaná hodnota proměnné je vymezená na prováděnou úlohu a neprovádí tok mezi úlohami nebo fázemi. Názvy proměnných jsou transformované na velká písmena a znaky "." a "" jsou nahrazeny znakem "_".

Například Agent.WorkFolder se bude jednat o AGENT_WORKFOLDER . v Windows k tomuto přístupu přistupujete jako %AGENT_WORKFOLDER% nebo $env:AGENT_WORKFOLDER . V systémech Linux a macOS můžete použít $AGENT_WORKFOLDER .

@echo ##vso[task.setvariable variable=sauce]crushed tomatoes
@echo ##vso[task.setvariable variable=secret.Sauce;issecret=true]crushed tomatoes with garlic

"$(sauce)" "$(secret.Sauce)"

@echo off
set sauceArgument=%~1
set secretSauceArgument=%~2
@echo No problem reading %sauceArgument% or %SAUCE%
@echo But I cannot read %SECRET_SAUCE%
@echo But I can read %secretSauceArgument% (but the log is redacted so I do not spoil
     the secret)

Write-Host "##vso[task.setvariable variable=sauce]crushed tomatoes"
Write-Host "##vso[task.setvariable variable=secret.Sauce;issecret=true]crushed tomatoes with
            garlic"

-sauceArgument "$(sauce)" -secretSauceArgument "$(secret.Sauce)"

Param(
   [string]$sauceArgument,
   [string]$secretSauceArgument
)
Write-Host No problem reading $env:SAUCE or $sauceArgument
Write-Host But I cannot read $env:SECRET_SAUCE
Write-Host But I can read $secretSauceArgument "(but the log is redacted so I do not
           spoil the secret)"

#!/bin/bash
echo "##vso[task.setvariable variable=sauce]crushed tomatoes"
echo "##vso[task.setvariable variable=secret.Sauce;issecret=true]crushed tomatoes with garlic"

"$(sauce)" "$(secret.Sauce)"

#!/bin/bash
echo "No problem reading $SAUCE"
echo "But I cannot read $SECRET_SAUCE"

Výstup na konzole z čtení proměnných:

No problem reading crushed tomatoes or crushed tomatoes
But I cannot read 
But I can read ******** (but the log is redacted so I do not spoil the secret)