Použití předdefinovaných proměnných

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Proměnné vám poskytují pohodlný způsob, jak získat klíčové bity dat do různých částí vašeho kanálu. Toto je seznam předdefinovaných proměnných, které jsou k dispozici pro vaše použití. Může existovat několik dalších předdefinovaných proměnných, ale většinou se používají pro interní použití.

Tyto proměnné jsou automaticky nastaveny systémem a jen pro čtení. (Výjimky jsou Build.Clean a System.Debug.)

V kanálech YAML můžete odkazovat na předdefinované proměnné jako proměnné prostředí. Proměnná Build.ArtifactStagingDirectory se například stane proměnnou BUILD_ARTIFACTSTAGINGDIRECTORY.

U klasických kanálů můžete pomocí proměnných vydaných verzí v úlohách nasazení sdílet společné informace (například název prostředí, skupina prostředků atd.).

Přečtěte si další informace o práci s proměnnými.

Tip

Můžete požádat Copilot o pomoc s proměnnými. Další informace najdete v tématu Ask Copilot k vygenerování fáze s podmínkou na základě proměnných hodnot.

Build.Clean

Jedná se o zastaralou proměnnou, která upravuje způsob čištění zdroje agentem sestavení. Informace o vyčištění zdroje najdete v tématu Vyčištění místního úložiště agenta.

System.AccessToken

System.AccessToken je speciální proměnná, která nese token zabezpečení používaný spuštěným sestavením.

YAML

V YAML musíte explicitně namapovat System.AccessToken do kanálu pomocí proměnné. Můžete to provést na úrovni kroku nebo úkolu. K ověřování pomocí registru kontejneru můžete například použít System.AccessToken.

steps:
- task: Docker@2
  inputs:
    command: login
    containerRegistry: '<docker connection>'
  env:
    SYSTEM_ACCESSTOKEN: $(System.AccessToken)

Můžete nakonfigurovat výchozí obor pro System.AccessToken použití oboru autorizace úlohy sestavení.

Klasické

Skriptům a úkolům můžete povolit přístup k System.AccessTokenu na úrovni úlohy.

1. Přechod na úlohu

2. V části Další možnosti zaškrtněte políčko Povolit skriptům přístup k tokenu OAuth.

Zaškrtnutím tohoto políčka se také ponechá přihlašovací údaje nastavené v Gitu, abyste mohli spouštět zápisy a načítání skriptů.

System.Debug

Podrobnější protokoly pro ladění problémů s kanálem definujte System.Debug a nastavte na true.

1. Upravte kanál.

2. Vyberte Proměnné.

3. Přidejte novou proměnnou s názvem System.Debug a hodnotou true.

   

4. Uložte novou proměnnou.

Nastavení System.Debug pro true konfiguraci podrobných protokolů pro všechna spuštění Podrobné protokoly můžete také nakonfigurovat pro jedno spuštění pomocí zaškrtávacího políčka Povolit diagnostiku systému.

Můžete také nastavit System.Debugtrue jako proměnnou v kanálu nebo šabloně.

variables:
  system.debug: 'true'

Pokud System.Debug je nastavena na truehodnotu , je Agent.Diagnosticnastavena další proměnná s názvem true . Pokud Agent.Diagnostic je tomu truetak, agent shromažďuje další protokoly, které je možné použít k řešení potíží se sítí pro agenty v místním prostředí. Další informace najdete v tématu Diagnostika sítě pro agenty v místním prostředí.

Poznámka:

Proměnná Agent.Diagnostic je k dispozici s agentem v2.200.0 a novějším.

Další informace najdete v tématu Kontrola protokolů pro diagnostiku problémů s kanály.

Proměnné agenta (DevOps Services)

Poznámka:

Proměnné agenta můžete použít jako proměnné prostředí ve skriptech a jako parametry v úlohách sestavení. Nemůžete je použít k přizpůsobení čísla buildu nebo k použití popisku nebo značky správy verzí.

Proměnná	Popis
Agent.BuildDirectory	Místní cesta k agentu, kde se vytvoří všechny složky pro daný kanál buildu. Tato proměnná má stejnou hodnotu jako Pipeline.Workspace. Například: /home/vsts/work/1. Další informace o adresářové struktuře agenta naleznete v tématu Adresářová struktura agenta.
Agent.ContainerMapping	Mapování z názvů prostředků kontejneru v YAML na jejich ID Dockeru za běhu Příklad následuje po tabulce.
Agent.HomeDirectory	Adresář, do který je agent nainstalovaný. Tato proměnná obsahuje software agenta. Například: c:\agent. Další informace o adresářové struktuře agenta naleznete v tématu Adresářová struktura agenta.
Agent.Id	ID agenta.
Agent.JobName	Název spuštěné úlohy. Tento název je obvykle Job; nebo __default, ale ve scénářích s více konfiguracemi se jedná o konfiguraci.
Agent.JobStatus	Stav sestavení. Canceled Failed Succeeded SucceededWithIssues (částečně úspěšný) Skipped (poslední úloha) Proměnná prostředí by měla být odkazována jako AGENT_JOBSTATUS. agent.jobstatus Starší verze je k dispozici pro zpětnou kompatibilitu.
Agent.MachineName	Název počítače, na kterém je agent nainstalovaný.
Agent.Name	Název agenta zaregistrovaného ve fondu. Pokud používáte agenta v místním prostředí, zadejte název. Podívejte se na agenty.
Agent.OS	Operační systém hostitele agenta. Platné hodnoty jsou: Windows_NT Darwin Linux Pokud používáte kontejner, může hostitel agenta a kontejner spouštět různé operační systémy.
Agent.OSArchitecture	Architektura procesoru operačního systému hostitele agenta. Platné hodnoty jsou: X86 X64 ARM
Agent.TempDirectory	Dočasná složka, která se vyčistí po každé úloze kanálu. Tento adresář používají úlohy, jako je úloha rozhraní příkazového řádku .NET Core, k uložení dočasných položek, jako jsou výsledky testů před jejich publikováním. Příklad: /home/vsts/work/_temp pro Ubuntu.
Agent.ToolsDirectory	Adresář používaný úlohami, jako je instalační program nástroje Node Tool, a použít verzi Pythonu k přepínání mezi několika verzemi nástroje. Tyto úlohy přidávají nástroje z tohoto adresáře, PATH aby je mohly použít následné kroky sestavení. Přečtěte si o správě tohoto adresáře v místním agentu.
Agent.WorkFolder	Pracovní adresář pro tohoto agenta. Například: c:\agent_work. Poznámka: U tohoto adresáře není zaručeno, že je možné zapisovat úkoly kanálu (například při mapování do kontejneru). Další informace o adresářové struktuře agenta naleznete v tématu Adresářová struktura agenta.

Příklad agenta.ContainerMapping:

{
  "one_container": {
    "id": "bdbb357d73a0bd3550a1a5b778b62a4c88ed2051c7802a0659f1ff6e76910190"
  },
  "another_container": {
    "id": "82652975109ec494876a8ccbb875459c945982952e0a72ad74c91216707162bb"
  }
}

Vytváření proměnných (DevOps Services)

Pokud použijete proměnnou v šabloně, která není v šablonách označená jako dostupná, proměnná se nevykreslí. Proměnná se nevykreslí, protože její hodnota není přístupná v rámci oboru šablony.

Proměnná	Popis	K dispozici v šablonách?
Build.ArtifactStagingDirectory	Místní cesta k agentu, do kterého se před vložením do cíle zkopírují všechny artefakty. Například: c:\agent_work\1\a. Typickým způsobem použití této složky je publikování artefaktů sestavení pomocí úloh Kopírování souborů a publikování artefaktů sestavení. Poznámka: Build.ArtifactStagingDirectory a Build.StagingDirectory jsou zaměnitelné. Tento adresář se vymaže před každým novým sestavením, takže si ho nemusíte vyčistit sami. Viz Artefakty ve službě Azure Pipelines. Další informace o adresářové struktuře agenta naleznete v tématu Adresářová struktura agenta. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No
Build.BuildId	ID záznamu pro dokončené sestavení.	No
Build.BuildNumber	Název dokončeného sestavení, označovaný také jako číslo spuštění. Můžete zadat , co je součástí této hodnoty. Typickým použitím této proměnné je, aby byla součástí formátu popisku, který zadáte na kartě úložiště. Poznámka: Tato hodnota může obsahovat prázdné znaky nebo jiné neplatné znaky popisku. V těchto případech se formát popisku nezdaří. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No
Build.BuildUri	Identifikátor URI sestavení. Například: vstfs:///Build/Build/1430. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No
Build.BinariesDirectory	Místní cesta k agentu, kterou můžete použít jako výstupní složku pro kompilované binární soubory. U agentů v místním prostředí nejsou nové kanály buildu nastavené tak, aby tento adresář ve výchozím nastavení vyčistily. Sestavení můžete definovat a vyčistit ho na kartě Úložiště. Například: c:\agent_work\1\b. Další informace o adresářové struktuře agenta naleznete v tématu Adresářová struktura agenta. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No
Build.ContainerId	ID kontejneru pro váš artefakt. Když do kanálu nahrajete artefakt, přidá se do kontejneru, který je specifický pro daný artefakt.	No
Build.CronSchedule.DisplayName	Plán displayName cron, který aktivoval spuštění kanálu. Tato proměnná je nastavená pouze v případě, že naplánovaná aktivační událost YAML aktivuje spuštění kanálu. Další informace najdete v tématu schedules.cron definition - Build.CronSchedule.DisplayName variable	Ano
Build.DefinitionName	Název kanálu buildu. Poznámka: Tato hodnota může obsahovat prázdné znaky nebo jiné neplatné znaky popisku. V těchto případech se formát popisku nezdaří.	Ano
Build.DefinitionVersion	Verze kanálu buildu.	Ano
Build.QueuedBy	Viz Jak jsou nastavené proměnné identity?. Poznámka: Tato hodnota může obsahovat prázdné znaky nebo jiné neplatné znaky popisku. V těchto případech se formát popisku nezdaří.	Ano
Build.QueuedById	Viz Jak jsou nastavené proměnné identity?.	Ano
Build.Reason	Událost, která způsobila spuštění sestavení. Manual: Uživatel ručně zařadil sestavení do fronty. IndividualCI: kontinuální integrace (CI) aktivované vrácením změn Gitu nebo vrácením funkce TFVC (Team Foundation Version Control). BatchedCI: Kontinuální integrace (CI) aktivovaná oznámením Gitu nebo vrácením se změnami TFVC a byly vybrány změny služby Batch. Schedule: Naplánovaná aktivační událost. ValidateShelveset: Uživatel ručně zařadil do fronty sestavení konkrétní sady odložených zpráv TFVC. CheckInShelveset: Aktivační událost vrácení se změnami . PullRequest: Zásady větve Git, které vyžadují, aby sestavení aktivovalo sestavení. BuildCompletion: Další triggery sestavení sestavení. ResourceTrigger: trigger prostředku nebo jiné aktivační události sestavení sestavení. Viz triggery kanálu buildu, zlepšení kvality kódu pomocí zásad větve.	Ano
Build.Repository.Clean	Hodnota, kterou jste vybrali pro Vyčistit v nastavení zdrojového úložiště . Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No
Build.Repository.LocalPath	Místní cesta k agentu, do kterého se stáhnou vaše soubory zdrojového kódu. Například: c:\agent_work\1\s. U agentů v místním prostředí se nové kanály buildu ve výchozím nastavení aktualizují jenom změněné soubory. Způsob stahování souborů můžete změnit na kartě Úložiště. Důležitá poznámka: Pokud si prohlédnete jenom jedno úložiště Git, je tato cesta přesnou cestou ke kódu. Pokud si prohlédnete více úložišť, chování je následující (a může se lišit od hodnoty proměnné Build.SourcesDirectory): Pokud krok rezervace pro samoobslužné úložiště (primární) nemá definovanou žádnou vlastní cestu rezervace nebo je výchozí cesta $(Pipeline.Workspace)/s/&<RepoName> rezervace pro vlastní úložiště, hodnota této proměnné se vrátí k výchozí hodnotě, což je $(Pipeline.Workspace)/s. Pokud krok rezervace pro vlastní úložiště (primární) měl definovanou vlastní cestu rezervace, která není výchozí cestou pro více rezervace, obsahuje tato proměnná přesnou cestu k vlastnímu úložišti. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No
Build.Repository.ID	Jedinečný identifikátor úložiště. Tato hodnota se nezmění, ani když se název úložiště změní.	Ano
Build.Repository.Name	Název aktivačního úložiště.	Ano
Build.Repository.Provider	Typ aktivovaného úložiště. TfsGit: Úložiště TFS Git TfsVersionControl: Správa verzí Team Foundation Git: Úložiště Git hostované na externím serveru GitHub Svn:Svrhnutí Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No
Build.Repository.Tfvc.Workspace	Definuje se, jestli je vaše úložiště Správa verzí Team Foundation. Název pracovního prostoru TFVC, který používá agent sestavení. Pokud je c:\agent_work\12 například Agent.BuildDirectory a Agent.Id je 8, název pracovního prostoru může být: ws_12_8 Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No
Build.Repository.Uri	Adresa URL pro aktivované úložiště. Příklad: Lotr: https://fabrikamfiber@dev.azure.com/fabrikamfiber/_git/Scripts TFVC: https://dev.azure.com/fabrikamfiber/ Tuto proměnnou nelze použít jako součást čísla buildu nebo jako značku správy verzí.	Ano
Build.RequestedFor	Viz Jak jsou nastavené proměnné identity?. Poznámka: Tato hodnota může obsahovat prázdné znaky nebo jiné neplatné znaky popisku. V těchto případech se formát popisku nezdaří.	Ano
Build.RequestedForEmail	Viz Jak jsou nastavené proměnné identity?.	Ano
Build.RequestedForId	Viz Jak jsou nastavené proměnné identity?.	Ano
Build.SourceBranch	Větev aktivačního úložiště, pro které bylo sestavení zařazeno do fronty. Některé příklady: Větev úložiště Git: refs/heads/main Žádost o přijetí změn úložiště Git: refs/pull/1/merge Větev úložiště TFVC: $/teamproject/main Vrácení se změnami v úložišti TFVC: Gated_2016-06-06_05.20.51.4369;username@live.com Sestavení sady odložených odložených časů úložiště TFVC: myshelveset;username@live.com Když značka aktivuje váš kanál: refs/tags/your-tag-name Pokud použijete tuto proměnnou ve formátu čísla buildu, znaky lomítka (/) se nahradí podtržítkem (_). Poznámka: Pokud v TFVC spouštíte vrátný build check-in nebo ručně vytváříte sadu odložených položek, nemůžete tuto proměnnou použít ve formátu čísla buildu.	Ano
Build.SourceBranchName	Název větve v aktivačním úložišti, pro které bylo sestavení zařazeno do fronty. Větev úložiště Git, žádost o přijetí změn nebo značka: Poslední segment cesty v odkazu. Například v refs/heads/main této hodnotě je main. V refs/heads/feature/toolsje tato hodnota tools. V refs/tags/your-tag-nameje hodnota your_tag_name, s pomlčkami (-) nahrazenými podtržítky (_). Větev úložiště TFVC: Poslední segment cesty v cestě kořenového serveru pro pracovní prostor. Například v $/teamproject/main této hodnotě je main. Sestavení sady odložených odložených nebo kontrolních sad TFVC je název sady odložených odložených adres. Například Gated_2016-06-06_05.20.51.4369;username@live.com nebo myshelveset;username@live.com. Poznámka: Pokud v TFVC spouštíte vrátný build check-in nebo ručně vytváříte sadu odložených položek, nemůžete tuto proměnnou použít ve formátu čísla buildu.	Ano
Build.SourcesDirectory	Místní cesta k agentu, do kterého se stáhnou vaše soubory zdrojového kódu. Například: c:\agent_work\1\s. U agentů v místním prostředí se nové kanály buildu aktualizují jenom změněné soubory. Další informace o adresářové struktuře agenta naleznete v tématu Adresářová struktura agenta. Důležitá poznámka: Pokud si prohlédnete jenom jedno úložiště Git, je tato cesta přesnou cestou ke kódu. Pokud si prohlédnete více úložišť, vrátí se k výchozí hodnotě, což je $(Pipeline.Workspace)/s, i když je vlastní (primární) úložiště rezervováno na vlastní cestu, která se liší od výchozí cesty $(Pipeline.Workspace)/s/<RepoName> s více rezervacemi (v tomto ohledu se proměnná liší od chování proměnné Build.Repository.LocalPath). Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No
Build.SourceVersion	Nejnovější změna správy verzí aktivačního úložiště, které je součástí tohoto buildu. Git: ID potvrzení . TFVC: sada změn. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	Ano
Build.SourceVersionMessage	Komentář k potvrzení nebo sadě změn pro aktivační úložiště. Zprávu zkrátíme na první řádek nebo 200 znaků podle toho, co je kratší. Odpovídá Build.SourceVersionMessage zprávě při Build.SourceVersion potvrzení. Potvrzení Build.SourceVersion sestavení žádosti o přijetí změn je potvrzení sloučení (nikoli potvrzení ve zdrojové větvi). Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí. Tato proměnná je k dispozici pouze na úrovni kroku a není k dispozici v úrovni úlohy nebo fáze. To znamená, že zpráva se nevyextrahuje, dokud se úloha nespustí a kód se rezervuje. Poznámka: Proměnná Build.SourceVersionMessage nefunguje s klasickými kanály buildu v úložištích Bitbucket, když Batch změní, když probíhá sestavení.	No
Build.StageRequestedBy	Osoba, která fázi aktivovala, když se fáze spustí ručně, nebo Microsoft.VisualStudio.Services.TFS jinak. Poznámka: Tato hodnota může obsahovat prázdné znaky nebo jiné neplatné znaky popisku.	No
Build.StageRequestedForId	Identifikátor GUID identity osoby, která fázi aktivovala při ručním spuštění fáze nebo 00000002-0000-8888-8000-000000000000 jinak.	No
Build.StagingDirectory	Místní cesta k agentu, do kterého se před vložením do cíle zkopírují všechny artefakty. Například: c:\agent_work\1\a. Další informace o adresářové struktuře agenta naleznete v tématu Adresářová struktura agenta. Typickým způsobem použití této složky je publikování artefaktů sestavení pomocí úloh Kopírování souborů a publikování artefaktů sestavení. Poznámka: Build.ArtifactStagingDirectory a Build.StagingDirectory jsou zaměnitelné. Tento adresář se vymaže před každým novým sestavením, takže si ho nemusíte vyčistit sami. Viz Artefakty ve službě Azure Pipelines. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No
Build.Repository.Git.SubmoduleCheckout	Hodnota, kterou jste vybrali pro dílčích modulů rezervace, na kartě úložiště. U rezervovaných více úložišť tato hodnota sleduje nastavení aktivujícího úložiště. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No
Build.SourceTfvcShelveset	Definuje se, jestli je vaše úložiště Správa verzí Team Foundation. Pokud používáte vrátný build nebo sestavení sady odložených odložených, nastaví se tato proměnná na název sady odložených , kterou vytváříte. Poznámka: Tato proměnná poskytuje hodnotu, která je neplatná pro použití sestavení ve formátu čísla sestavení.	No
Build.TriggeredBy.BuildId	Pokud další aktivační události sestavení sestavení, je tato proměnná nastavená na BuildID aktivačního sestavení. V klasických kanálech trigger dokončení sestavení aktivuje tuto proměnnou. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí. Pokud spouštíte kanál YAML pomocí resources, měli byste místo toho použít proměnné prostředků.	No
Build.TriggeredBy.DefinitionId	Pokud další triggery sestavení sestavení, je tato proměnná nastavená na DefinitionID aktivačního sestavení. V klasických kanálech trigger dokončení sestavení aktivuje tuto proměnnou. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí. Pokud spouštíte kanál YAML pomocí resources, měli byste místo toho použít proměnné prostředků.	No
Build.TriggeredBy.DefinitionName	Pokud další triggery sestavení sestavení, nastaví se tato proměnná na název aktivačního kanálu buildu. V klasických kanálech trigger dokončení sestavení aktivuje tuto proměnnou. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí. Pokud spouštíte kanál YAML pomocí resources, měli byste místo toho použít proměnné prostředků.	No
Build.TriggeredBy.BuildNumber	Pokud další aktivační události sestavení sestavení, nastaví se tato proměnná na počet aktivačních sestavení. V klasických kanálech trigger dokončení sestavení aktivuje tuto proměnnou. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí. Pokud spouštíte kanál YAML pomocí resources, měli byste místo toho použít proměnné prostředků.	No
Build.TriggeredBy.ProjectID	Pokud další triggery sestavení sestavení, nastaví se tato proměnná na ID projektu, který obsahuje aktivační sestavení. V klasických kanálech trigger dokončení sestavení aktivuje tuto proměnnou. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí. Pokud spouštíte kanál YAML pomocí resources, měli byste místo toho použít proměnné prostředků.	No
Common.TestResultsDirectory	Místní cesta k agentu, kde se vytvoří výsledky testu. Například: c:\agent_work\1\TestResults. Další informace o adresářové struktuře agenta naleznete v tématu Adresářová struktura agenta. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No

Proměnné kanálu

Proměnná	Popis
Pipeline.Workspace	Adresář pracovního prostoru pro konkrétní kanál Tato proměnná má stejnou hodnotu jako Agent.BuildDirectory. Například /home/vsts/work/1. Další informace o adresářové struktuře agenta naleznete v tématu Adresářová struktura agenta.

Tip

Pokud používáte kanály klasické verze, můžete použít klasických verzí a proměnných artefaktů k ukládání a přístupu k datům v celém kanálu.

Proměnné úlohy nasazení

Tyto proměnné jsou vymezeny na konkrétní úlohy nasazení a jsou vyřešeny pouze v době provádění úlohy.

Proměnná	Popis
Environment.Name	Název prostředí cíleného na úlohu nasazení pro spuštění kroků nasazení a zaznamenání historie nasazení. Například smarthotel-dev.
Environment.Id	ID prostředí určeného v úloze nasazení. Například 10.
Environment.ResourceName	Název konkrétního prostředku v prostředí určeném v úloze nasazení pro spuštění kroků nasazení a zaznamenání historie nasazení. Například bookings, což je obor názvů Kubernetes, který je přidaný jako prostředek do prostředí smarthotel-dev.
Environment.ResourceId	ID konkrétního prostředku v rámci prostředí určeného v úloze nasazení pro spuštění kroků nasazení. Například 4.
Strategy.Name	Název strategie nasazení: canary, runOncenebo rolling.
Strategy.CycleName	Název aktuálního cyklu v nasazení Možnosti jsou PreIteration, Iterationnebo PostIteration.

Systémové proměnné

Pokud použijete proměnnou v šabloně, která není v šablonách označená jako dostupná, proměnná se nevykreslí. Proměnná se nevykreslí, protože její hodnota není přístupná v rámci oboru šablony.

Proměnná	Popis	K dispozici v šablonách?
System.AccessToken	Pro přístup k rozhraní REST API použijte token OAuth. Použijte System.AccessToken ze skriptů YAML. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	Ano
System.CollectionId	Identifikátor GUID organizace nebo kolekce Azure DevOps.	Ano
System.CollectionUri	Identifikátor URI organizace nebo kolekce Azure DevOps. Například: https://dev.azure.com/fabrikamfiber/.	Ano
System.DefaultWorkingDirectory	Místní cesta k agentu, do kterého se stáhnou vaše soubory zdrojového kódu. Příklad: c:\agent_work\1\s Další informace o adresářové struktuře agenta naleznete v tématu Adresářová struktura agenta. U agentů v místním prostředí se nové kanály buildu ve výchozím nastavení aktualizují jenom změněné soubory. Způsob stahování souborů můžete změnit na kartě Úložiště. Tato proměnná má obor agenta. Dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	Ano
System.DefinitionId	ID kanálu buildu.	Ano
System.HostType	Nastavte, build jestli je kanál buildem. Pro vydání jsou deployment hodnoty pro úlohu skupiny nasazení, gates během vyhodnocení bran a release pro další úlohy (agent a bez agentů).	Ano
System.JobAttempt	Při prvním pokusu o tuto úlohu nastavíte na 1 a při každém opakování úlohy se zvýší.	No
System.JobDisplayName	Jméno člověka čitelného pro práci.	No
System.JobId	Jedinečný identifikátor jednoho pokusu o jednu úlohu. Hodnota je jedinečná pro aktuální kanál.	No
System.JobName	Název úlohy, obvykle používaný pro vyjádření závislostí a přístup k výstupním proměnným.	No
System.OidcRequestUri	idToken Vygenerujte ověřování pomocí ID Entra pomocí OpenID Connect (OIDC). Další informace.	Ano
System.PhaseAttempt	Při prvním pokusu o tuto fázi se nastaví hodnota 1 a při každém opakování úlohy se zvýší. Poznámka: Fáze je převážně redundantní koncept, který představuje dobu návrhu úlohy (zatímco úloha byla verzí modulu runtime fáze). Koncept fáze se z Azure Pipelines většinou odebere. Matice a úlohy s více konfiguracemi jsou jediným místem, kde se fáze stále liší od úlohy. Jedna fáze může vytvořit instanci více úloh, které se liší pouze v jejich vstupech.	No
System.PhaseDisplayName	Lidsky čitelný název zadaný fázi.	No
System.PhaseName	Identifikátor založený na řetězci pro úlohu, obvykle používaný pro vyjádření závislostí a přístup k výstupním proměnným.	No
System.PlanId	Identifikátor založený na řetězci pro jedno spuštění kanálu.	No
System.PullRequest.IsFork	Pokud žádost o přijetí změn pochází z forku úložiště, je tato proměnná nastavená na Truehodnotu . V opačném případě je nastavená na Falsehodnotu .	Ano
System.PullRequest.PullRequestId	ID žádosti o přijetí změn, která způsobila toto sestavení. Například: 17. (Tato proměnná se inicializuje pouze v případě, že se sestavení spustilo z důvodu Žádost o přijetí změn Gitu ovlivněná zásadami větve)	No
System.PullRequest.PullRequestNumber	Počet žádostí o přijetí změn, které způsobily toto sestavení Tato proměnná se vyplní pro žádosti o přijetí změn z GitHubu, které mají jiné ID žádosti o přijetí změn a číslo žádosti o přijetí změn. Tato proměnná je k dispozici pouze v kanálu YAML, pokud zásady větve ovlivňují žádost o přijetí změn.	No
System.PullRequest.targetBranchName	Název cílové větve žádosti o přijetí změn Tuto proměnnou lze použít v kanálu k podmíněnému spouštění úloh nebo kroků na základě cílové větve žádosti o přijetí změn. Můžete například chtít aktivovat jinou sadu testů nebo nástrojů pro analýzu kódu v závislosti na větvi, do které se změny slučují.	No
System.PullRequest.SourceBranch	Větev, která se kontroluje v žádosti o přijetí změn Příklad: refs/heads/users/raisa/new-feature pro Azure Repos. (Tato proměnná se inicializuje pouze v případě, že se sestavení spustilo z důvodu Žádost o přijetí změn Gitu ovlivněná zásadami větve) Tato proměnná je k dispozici pouze v kanálu YAML, pokud zásady větve ovlivňují žádost o přijetí změn.	No
System.PullRequest.SourceCommitId	Potvrzení, které se kontroluje v žádosti o přijetí změn. (Tato proměnná se inicializuje pouze v případě, že se sestavení spustilo z důvodu Žádost o přijetí změn Gitu ovlivněná zásadami větve) Tato proměnná je k dispozici pouze v kanálu YAML, pokud zásady větve ovlivňují žádost o přijetí změn.
System.PullRequest.SourceRepositoryUri	Adresa URL úložiště, které obsahuje žádost o přijetí změn. Například: https://dev.azure.com/ouraccount/_git/OurProject.	No
System.PullRequest.TargetBranch	Větev, která je cílem žádosti o přijetí změn. Příklad: refs/heads/main Když je úložiště v Azure Repos a main kdy je vaše úložiště na GitHubu. Tato proměnná se inicializuje jenom v případě, že se sestavení spustilo kvůli zásadám větve ovlivněné žádostmi o přijetí změn Gitu. Tato proměnná je k dispozici pouze v kanálu YAML, pokud zásady větve ovlivňují žádost o přijetí změn.	No
System.StageAttempt	Při prvním pokusu o tuto fázi se nastaví hodnota 1 a při každém opakování fáze se zvýší.	No
System.StageDisplayName	Název, který je čitelný pro člověka, který je dán do fáze.	No
System.StageName	Identifikátor založený na řetězci pro fázi, obvykle používaný pro vyjádření závislostí a přístup k výstupním proměnným.	No
System.TeamFoundationCollectionUri	Identifikátor URI organizace nebo kolekce Azure DevOps. Například: https://dev.azure.com/fabrikamfiber/. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	Ano
System.TeamProject	Název projektu, který obsahuje toto sestavení.	Ano
System.TeamProjectId	ID projektu, do kterého tento build patří.	Ano
System.TimelineId	Identifikátor založený na řetězci pro podrobnosti spuštění a protokoly jednoho spuštění kanálu.	No
TF_BUILD	Pokud úloha sestavení spustí skript, nastaví se na True. Tato proměnná je vymezená agentem a dá se použít jako proměnná prostředí ve skriptu a jako parametr v úloze sestavení. Nedá se použít jako součást čísla buildu nebo jako značka správy verzí.	No

Kontroluje proměnné (DevOps Services)

Proměnná	Popis
Checks.StageAttempt	Při prvním pokusu o tuto fázi se nastaví hodnota 1 a při každém opakování fáze se zvýší. Tuto proměnnou lze použít pouze ve schválení nebo kontrolovat prostředí. Můžete například použít $(Checks.StageAttempt) v rámci kontroly rozhraní REST API vyvolání.

Jak jsou nastavené proměnné identity?

Hodnota závisí na tom, co způsobilo sestavení a které jsou specifické pro úložiště Azure Repos.

Pokud se sestavení aktivuje...	Hodnoty Build.QueuedBy a Build.QueuedById jsou pak založeny na...	Pak jsou hodnoty Build.RequestedFor a Build.RequestedForId založeny na...
V Gitu nebo triggery kontinuální integrace (CI)	Systémová identita, například: [DefaultCollection]\Project Collection Service Accounts	Osoba, která změny odeslala nebo zkontrolovala.
V Gitu nebo sestavením zásad větve	Systémová identita, například: [DefaultCollection]\Project Collection Service Accounts	Osoba, která změny zkontrolovala.
V TFVC bránou triggerem vrácení se změnami	Osoba, která změny zkontrolovala.	Osoba, která změny zkontrolovala.
V Gitu nebo TFVC podle plánovaných triggerů	Systémová identita, například: [DefaultCollection]\Project Collection Service Accounts	Systémová identita, například: [DefaultCollection]\Project Collection Service Accounts
Protože jste klikli na tlačítko Sestavení fronty	Vy	Vy

Požádejte Copilot, aby vygeneroval fázi s podmínkou na základě hodnot proměnných.

Pomocí Copilot vygenerujte fázi s podmínkou určenou hodnotou proměnné.

Tento příklad výzvy definuje fázi, která se spustí, když Agent.JobStatus indikuje, že předchozí fáze byla úspěšně spuštěna:

Vytvořte novou fázi Azure DevOps, která se spustí pouze v Agent.JobStatusSucceeded nebo SucceededWithIssues.

Výzvu můžete přizpůsobit tak, aby používala hodnoty, které splňují vaše požadavky. Můžete například požádat o pomoc s vytvořením fáze, která se spustí jenom v případě, že kanál selže.

Poznámka:

GitHub Copilot využívá technologii AI, takže jsou možná překvapení a chyby. Nezapomeňte ověřit vygenerovaný kód nebo návrhy. Další informace o obecném použití GitHub Copilotu, dopadu produktu, lidského dohledu a ochrany osobních údajů najdete v nejčastějších dotazech ke GitHubu Copilot.