Előre definiált változók használata

Cikk
01/29/2025

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

A változók segítségével kényelmesen lekérheti a kulcsbiteket a folyamat különböző részeibe. Ez az elérhető előre megadott változók listája. Lehetnek más előre definiált változók is, de ezek többnyire belső használatra készültek.

Ezeket a változókat a rendszer automatikusan beállítja, és írásvédett. (A kivételek a Build.Clean és a System.Debug.)

A YAML-folyamatokban az előre definiált változókra környezeti változóként hivatkozhat. A változó például a változó Build.ArtifactStagingDirectoryBUILD_ARTIFACTSTAGINGDIRECTORYlesz.

Klasszikus folyamatok esetén az üzembe helyezési feladatok kiadási változóival megoszthatja a gyakori információkat (például a környezet nevét, az erőforráscsoportot stb.).

További információ a változók használatával kapcsolatban.

Tipp.

A változókkal kapcsolatban segítséget kérhet Copilot. További információ: A Copilot kérése változó értékeken alapuló feltételt tartalmazó szakasz létrehozására.

Build.Clean

Ez egy elavult változó, amely módosítja, hogy a buildügynök hogyan tisztítja meg a forrást. A forrás törlésének módjáról az ügynök helyi adattárának megtisztítása című témakörben olvashat.

System.AccessToken

System.AccessToken egy speciális változó, amely a futó build által használt biztonsági jogkivonatot tartalmazza.

YAML
Klasszikus

A YAML-ben explicit módon le kell képeznie System.AccessToken magát a folyamatba egy változó használatával. Ezt a lépés vagy a feladat szintjén teheti meg. Használhatja például a System.AccessToken egy tárolóregisztrációs adatbázissal való hitelesítéshez.

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

Konfigurálhatja az alapértelmezett hatókört a buildelési feladat engedélyezési hatókörének System.AccessTokenhasználatára.

System.Debug

A folyamatproblémák hibakereséséhez részletesebb naplókért definiálja System.Debug és állítsa be a következőre true: .

Szerkessze a folyamatot.
Válassza a Változók lehetőséget.
Adjon hozzá egy új változót a névvel System.Debug és az értékkel true.
Mentse az új változót.

System.Debug Az összes futtatás részletes naplóinak konfigurálására szolgáló beállítástrue. A rendszerdiagnosztika engedélyezése jelölőnégyzettel részletes naplókat is konfigurálhat egyetlen futtatáshoz.

A folyamat vagy sablon változóként is beállítható System.Debugtrue .

variables:
  system.debug: 'true'

Ha System.Debug be van állítva true, a rendszer egy további névvel ellátott Agent.Diagnostic változót trueállít be. Ha Agent.Diagnostic igen true, az ügynök további naplókat gyűjt, amelyek a saját üzemeltetésű ügynökök hálózati problémáinak elhárítására használhatók. További információért lásd: Helyi ügynökök hálózati diagnosztikája.

Feljegyzés

A Agent.Diagnostic változó a 2.200.0-s és újabb ügynökkel érhető el.

További információ: Naplók áttekintése a folyamatproblémák diagnosztizálásához.

Ügynökváltozók (DevOps Services)

Feljegyzés

Az ügynökváltozókat környezeti változókként használhatja a szkriptekben és paraméterekként a buildelési feladatokban. Nem használhatja őket a buildszám testreszabására, illetve verziókövetési címke vagy címke alkalmazására.

Változó	Leírás
Agent.BuildDirectory	Az ügynök helyi elérési útja, ahol egy adott buildfolyamat összes mappája létrejön. Ez a változó ugyanazzal az értékkel rendelkezik, mint a `Pipeline.Workspace`. Például: `/home/vsts/work/1` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.
Agent.ContainerMapping	A YAML-ben található tárolóerőforrás-nevek és a Docker-azonosítók futásidejű leképezése. A példa a táblázatot követi.
Agent.HomeDirectory	A címtár, amelybe az ügynök telepítve van. Ez a változó az ügynökszoftvert tartalmazza. Például: `c:\agent` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.
Agent.Id	Az ügynök azonosítója.
Agent.JobName	A futó feladat neve. Ez a név általában `Job`; vagy `__default`, de többkonfigurációs forgatókönyvekben ez a konfiguráció.
Agent.JobStatus	A build állapota. `Canceled` `Failed` `Succeeded` `SucceededWithIssues` (részben sikeres) `Skipped` (utolsó feladat) A környezeti változóra `AGENT_JOBSTATUS`a következőként kell hivatkozni: . A régebbi `agent.jobstatus` verzió a visszamenőleges kompatibilitás érdekében érhető el.
Agent.MachineName	Annak a gépnek a neve, amelyre az ügynök telepítve van.
Agent.Name	A készletben regisztrált ügynök neve. Ha saját üzemeltetésű ügynököt használ, adja meg a nevet. Ügynökök megtekintése.
Agent.OS	Az ügynök gazdagépének operációs rendszere. Az érvényes értékek a következők: `Windows_NT` `Darwin` `Linux` Ha tárolóban fut, az ügynök gazdagépe és tárolója különböző operációs rendszereket futtathat.
Agent.OSArchitecture	Az ügynök gazdagépének operációsrendszer-processzorarchitektúrája. Az érvényes értékek a következők: `X86` `X64` `ARM`
Agent.TempDirectory	Az egyes folyamatfeladatok után megtisztított ideiglenes mappa. Ezt a könyvtárat olyan tevékenységek használják, mint például a .NET Core CLI-feladat , amely ideiglenes elemeket, például teszteredményeket tárol a közzétételük előtt. Például: `/home/vsts/work/_temp` Ubuntu esetén.
Agent.ToolsDirectory	Az olyan feladatok által használt címtár, mint a Node Tool Installer és a Python-verzió használata az eszköz több verziója közötti váltáshoz. Ezek a feladatok eszközöket adnak hozzá a könyvtárból `PATH` , hogy a későbbi buildelési lépések használhassák őket. Ismerje meg, hogyan kezelheti ezt a címtárat egy saját üzemeltetésű ügynökön.
Agent.WorkFolder	Az ügynök munkakönyvtára. Például: `c:\agent_work` Megjegyzés: Ez a könyvtár nem garantáltan írható folyamatfeladatokkal (például tárolóba leképezve). Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.

Példa az Agent.ContainerMappingra:

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

Változók létrehozása (DevOps Services)

Ha olyan sablonban használ változót, amely nem szerepel a sablonokban elérhetőként megjelölve, a változó nem jelenik meg. A változó nem jelenik meg, mert értéke nem érhető el a sablon hatókörén belül.

Változó	Leírás	Elérhető sablonokban?
Build.ArtifactStagingDirectory	Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: `c:\agent_work\1\a` A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Tekintse meg az Azure Pipelines összetevőit. Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.BuildId	A befejezett build rekordjának azonosítója.	Nem
Build.BuildNumber	A befejezett build neve, más néven a futtatási szám. Megadhatja , hogy mi szerepel ebben az értékben. Ennek a változónak általában az a célja, hogy az adattár lapon megadott címkeformátum része legyen. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.BuildUri	A build URI-ja. Például: `vstfs:///Build/Build/1430` Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.BinariesDirectory	Az ügynök helyi elérési útja, amelyet kimeneti mappaként használhat a lefordított bináris fájlokhoz. A saját üzemeltetésű ügynökök esetében az új buildelési folyamatok alapértelmezés szerint nem lesznek beállítva a címtár tisztítására. A buildet úgy határozhatja meg, hogy megtisztítsa azt az Adattár lapon. Például: `c:\agent_work\1\b` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.ContainerId	Az összetevő tárolójának azonosítója. Amikor feltölt egy összetevőt a folyamatba, az hozzáadódik egy olyan tárolóhoz, amely az adott összetevőre jellemző.	Nem
Build.CronSchedule.DisplayName	A `displayName` folyamatfuttatást kiváltó cron-ütemezés. Ez a változó csak akkor van beállítva, ha egy YAML ütemezett eseményindító aktiválja a folyamat futtatását. További információ: schedules.cron definition – Build.CronSchedule.DisplayName változó	Igen
Build.DefinitionName	A buildelési folyamat neve. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul.	Igen
Build.DefinitionVersion	A buildelési folyamat verziója.	Igen
Build.QueuedBy	Lásd Hogyan vannak beállítva az identitásváltozók?. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul.	Igen
Build.QueuedById	Lásd Hogyan vannak beállítva az identitásváltozók?.	Igen
Build.Reason	Az az esemény, amely a build futtatását okozta. `Manual`: Egy felhasználó manuálisan várólistára helyezett egy buildet. `IndividualCI`: Git-leküldés vagy a Team Foundation verziókövetési (TFVC) bejelentkezése által aktivált folyamatos integráció (CI). `BatchedCI`: Git-leküldés vagy TFVC-bejelentkezés által aktivált folyamatos integráció (CI), és a Batch-módosítások ki lett választva. `Schedule`: Ütemezett eseményindító. `ValidateShelveset`: Egy felhasználó manuálisan várólistára helyezett egy adott TFVC-polckészletet. `CheckInShelveset`: Kapus bejelentkezési eseményindító. `PullRequest`: A Buildet igénylő Git-ágszabályzat aktiválja a buildet. `BuildCompletion`: Egy másik buildindító a buildet. `ResourceTrigger`: Egy erőforrás-eseményindító vagy egy másik buildindító a build. Lásd: Build pipeline triggers, Improve code quality with branch policies.	Igen
Build.Repository.Clean	A Tisztaforrásadattár beállításaiban kiválasztott érték. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.LocalPath	Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: `c:\agent_work\1\s` A saját üzemeltetésű ügynökök esetében az új buildfolyamatok alapértelmezés szerint csak a módosított fájlokat frissítik. Az Adattár lapon módosíthatja a fájlok letöltési módját. Fontos megjegyzés: Ha csak egy Git-adattárat tekint meg, ez az elérési út a kód pontos elérési útja. Ha több adattárat is kivesz, a viselkedés a következő (és eltérhet a Build.SourcesDirectory változó értékétől): Ha az önkiszolgáló (elsődleges) adattár kivételi lépése nem definiált egyéni kivételi útvonalat, vagy a kivételi útvonal az öntárház több kivételes alapértelmezett elérési útja `$(Pipeline.Workspace)/s/&<RepoName>` , a változó értéke visszaáll az alapértelmezett értékre, azaz `$(Pipeline.Workspace)/s`a . Ha az önkiszolgáló (elsődleges) adattár kivételi lépése olyan egyéni kivételi útvonalat definiált, amely nem a több kivételes alapértelmezett elérési útja, ez a változó tartalmazza az öntárház pontos elérési útját. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.ID	Az adattár egyedi azonosítója. Ez az érték akkor sem változik, ha az adattár neve igen. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Name	Az eseményindító adattár neve. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Provider	Az eseményindító adattár típusa. `TfsGit`: TFS Git-adattár `TfsVersionControl`: Team Foundation verziókövetés `Git`: Külső kiszolgálón üzemeltetett Git-adattár `GitHub` `Svn`:Felforgatás Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Tfvc.Workspace	Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. A buildügynök által használt TFVC-munkaterület neve. Ha például az Agent.BuildDirectory az `c:\agent_work\12` , és a Agent.Id, `8`a munkaterület neve a következő lehet: `ws_12_8` Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Uri	Az eseményindító adattár URL-címe. Példa: Git: https://fabrikamfiber@dev.azure.com/fabrikamfiber/_git/Scripts TFVC: https://dev.azure.com/fabrikamfiber/ Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.RequestedFor	Lásd Hogyan vannak beállítva az identitásváltozók?. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul.	Igen
Build.RequestedForEmail	Lásd Hogyan vannak beállítva az identitásváltozók?.	Igen
Build.RequestedForId	Lásd Hogyan vannak beállítva az identitásváltozók?.	Igen
Build.SourceBranch	A buildet aktiváló adattár ága várólistára került. Néhány példa: Git-adattárág: `refs/heads/main` Git-adattár lekéréses kérése: `refs/pull/1/merge` TFVC-adattárág: `$/teamproject/main` TFVC-adattár kapus bejelentkezése: `Gated_2016-06-06_05.20.51.4369;username@live.com` TFVC-adattár polckészlet összeállítása: `myshelveset;username@live.com` Amikor egy címke aktiválja a folyamatot: `refs/tags/your-tag-name` Ha ezt a változót buildszámformátumban használja, a perjelek (`/`) karaktereit aláhúzásjelek (`_`) váltják fel. Megjegyzés: A TFVC-ben, ha kapus bejelentkezési buildet futtat, vagy manuálisan készít egy polckészletet, nem használhatja ezt a változót a buildszámformátumában.	Igen
Build.SourceBranchName	A buildet aktiváló adattár ágának neve várólistára került. Git-adattárág, lekéréses kérelem vagy címke: A ref utolsó elérési útszakasza. Ebben az értékben `refs/heads/main` például a következő: `main`. A `refs/heads/feature/tools`ez az érték `tools`. A `refs/tags/your-tag-name`az érték `your_tag_name`, és az aláhúzásjelek (`-`) helyett aláhúzásjelek (`_`) lépnek. TFVC-adattárág: A munkaterület gyökérkiszolgálói elérési útjának utolsó elérési útja. Ebben az értékben `$/teamproject/main` például a következő: `main`. A TFVC adattárkapus beadása vagy a polckészlet összeállítása a polckészlet neve. Például, `Gated_2016-06-06_05.20.51.4369;username@live.com` vagy `myshelveset;username@live.com`. Megjegyzés: A TFVC-ben, ha kapus bejelentkezési buildet futtat, vagy manuálisan készít egy polckészletet, nem használhatja ezt a változót a buildszámformátumában.	Igen
Build.SourcesDirectory	Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: `c:\agent_work\1\s` A saját üzemeltetésű ügynökök esetében az új buildelési folyamatok csak a módosított fájlokat frissítik. Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. Fontos megjegyzés: Ha csak egy Git-adattárat tekint meg, ez az elérési út a kód pontos elérési útja. Ha több adattárat is kivesz, az visszaáll az alapértelmezett értékre, vagyis `$(Pipeline.Workspace)/s`még akkor is, ha az önkiszolgáló (elsődleges) adattárat a rendszer a több kivételes alapértelmezett elérési úttól `$(Pipeline.Workspace)/s/<RepoName>` eltérő egyéni elérési útra irányítja (ebben a tekintetben a változó eltér a Build.Repository.LocalPath változó viselkedésétől). Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.SourceVersion	A buildben található triggerelő adattár legújabb verziókövetési módosítása. Git: A véglegesítés azonosítója. TFVC: a változáskészlet. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Igen
Build.SourceVersionMessage	Az eseményindító adattár véglegesítésének vagy változáskészletének megjegyzése. Az üzenetet az első sorra vagy 200 karakterre csonkítjuk, attól függően, hogy melyik rövidebb. A `Build.SourceVersionMessage` véglegesítéskor `Build.SourceVersion` megjelenő üzenetnek felel meg. A `Build.SourceVersion` pr-buildek véglegesítése az egyesítési véglegesítés (nem a forráság véglegesítése). Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Emellett ez a változó csak a lépés szintjén érhető el, és nem érhető el a feladat- vagy szakaszszinteken. Vagyis az üzenet nem lesz kinyerve, amíg a feladat el nem indul, és a kód ki van véve. Megjegyzés: A Build.SourceVersionMessage változó nem működik a Bitbucket-adattárak klasszikus buildelési folyamataival, ha Batch-módosításokat végez, miközben a buildelés folyamatban van, engedélyezve van.	Nem
Build.StagingDirectory	Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: `c:\agent_work\1\a` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Tekintse meg az Azure Pipelines összetevőit. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Git.SubmoduleCheckout	A Kivétel almodulok kiválasztott érték az adattár lapján. Ha több adattárat is kivett, ez az érték nyomon követi az eseményindító adattár beállításait. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.SourceTfvcShelveset	Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. Ha kapus buildelési vagy polckészlet-összeállításifuttat, ez a változó az éppen létrehozott polckészlet nevére van állítva. Megjegyzés: Ez a változó olyan értéket ad, amely a buildszámformátumban való buildhasználathoz érvénytelen.	Nem
Build.TriggerBy.BuildId	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build BuildID azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot `resources`aktivál, használja inkább az erőforrásváltozókat .	Nem
Build.TriggerBy.DefinitionId	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build DefinitionID azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot `resources`aktivál, használja inkább az erőforrásváltozókat .	Nem
Build.TriggerBy.DefinitionName	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító buildfolyamat nevére van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot `resources`aktivál, használja inkább az erőforrásváltozókat .	Nem
Build.TriggerBy.BuildNumber	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build számára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot `resources`aktivál, használja inkább az erőforrásváltozókat .	Nem
Build.TriggerBy.ProjectID	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító buildet tartalmazó projekt azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot `resources`aktivál, használja inkább az erőforrásváltozókat .	Nem
Common.TestResultsDirectory	Annak az ügynöknek a helyi elérési útja, ahol a teszteredmények létrejönnek. Például: `c:\agent_work\1\TestResults` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem

Folyamatváltozók

Változó	Leírás
Pipeline.Workspace	Egy adott folyamat munkaterületi címtára. Ez a változó ugyanazzal az értékkel rendelkezik, mint a `Agent.BuildDirectory`. Például: `/home/vsts/work/1`. Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.

Tipp.

Ha klasszikus kiadási folyamatokat használ, klasszikus kiadások és összetevők változói az adatok tárolására és elérésére a folyamat teljes területén.

Üzembehelyezési feladat változói

Ezek a változók egy adott üzembehelyezési feladatra vonatkoznak, és csak a feladat végrehajtásakor oldódnak fel.

Változó	Leírás
Environment.Name	Az üzembe helyezési feladatban megcélzott környezet neve az üzembe helyezési lépések futtatásához és az üzembe helyezési előzmények rögzítéséhez. Például: `smarthotel-dev`.
Environment.Id	Az üzembe helyezési feladatban megcélzott környezet azonosítója. Például: `10`.
Environment.ResourceName	Az üzembe helyezési lépések futtatásához és az üzembe helyezési előzmények rögzítéséhez az üzembe helyezési feladatban megcélzott környezetben lévő adott erőforrás neve. Például `bookings`, amely egy Kubernetes-névtér, amely erőforrásként van hozzáadva a környezethez `smarthotel-dev`.
Environment.ResourceId	Az üzembe helyezési lépések futtatásához az üzembe helyezési feladatban megcélzott környezetben lévő adott erőforrás azonosítója. Például: `4`.
Strategy.Name	Az üzembehelyezési stratégia neve: `canary`, `runOnce`vagy `rolling`.
Strategy.CycleName	Az üzemelő példány aktuális ciklusneve. A beállítások a következők `PreIteration`: , `Iteration`vagy `PostIteration`.

Rendszerváltozók

Változó	Leírás	Elérhető sablonokban?
System.AccessToken	Az OAuth-jogkivonat használatával érheti el a REST API-t. Használja a System.AccessTokent YAML-szkriptekből. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Igen
System.CollectionId	Az Azure DevOps-szervezet vagy -gyűjtemény GUID azonosítója.	Igen
System.CollectionUri	Az Azure DevOps-szervezet vagy -gyűjtemény URI-ja. Például: `https://dev.azure.com/fabrikamfiber/`	Igen
System.DefaultWorkingDirectory	Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: `c:\agent_work\1\s` Az ügynökkönyvtár struktúrájáról további információt Ügynökkönyvtár-struktúracímű témakörben talál. A saját üzemeltetésű ügynökök esetében az új buildfolyamatok alapértelmezés szerint csak a módosított fájlokat frissítik. Az Adattár lapon módosíthatja a fájlok letöltési módját. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Igen
System.DefinitionId	A buildelési folyamat azonosítója.	Igen
System.HostType	Állítsa be, hogy `build` a folyamat build-e. Egy kiadás esetében az értékek `deployment` egy üzembehelyezési csoport feladatához, `gates` a kapuk kiértékelése során, valamint `release` más (ügynök- és ügynök nélküli) feladatokhoz tartoznak.	Igen
System.JobAttempt	Állítsa 1 értékre a feladat első kísérletekor, és minden alkalommal növekszik, amikor a feladat újrapróbálkozott.	Nem
System.JobDisplayName	Az ember által olvasható név, amit egy feladatnak adtak.	Nem
System.JobId	Egyetlen feladat egyetlen kísérletének egyedi azonosítója. Az érték egyedi az aktuális folyamathoz.	Nem
System.JobName	A feladat neve, amely általában a függőségek kifejezésére és a kimeneti változók elérésére szolgál.	Nem
System.OidcRequestUri	Hozzon létre egy `idToken` hitelesítést Entra-azonosítóval az OpenID Connect (OIDC) használatával. További információ.	Igen
System.PhaseAttempt	Állítsa 1 értékre a fázis első kísérletekor, és minden alkalommal növekszik, amikor a feladat újrapróbálkozott. Megjegyzés: A "Fázis" egy többnyire redundáns fogalom, amely egy feladat tervezési idejét jelöli (míg a feladat egy fázis futtatókörnyezeti verziója volt). A fázis fogalma többnyire el van távolítva az Azure Pipelinesból. A mátrix- és többkonfigurációs feladatok az egyetlen olyan hely, ahol a fázisok továbbra is eltérnek a feladatoktól. Egy fázis több feladatot is képes létrehozni, amelyek csak a bemeneteikben különböznek.	Nem
System.PhaseDisplayName	Az ember által olvasható név, amelyet egy fázisnak adnak.	Nem
System.PhaseName	Egy feladat sztringalapú azonosítója, amely általában függőségek kifejezésére és kimeneti változók elérésére szolgál.	Nem
System.PlanId	Sztringalapú azonosító egyetlen folyamatfuttatáshoz.	Nem
System.PullRequest.IsFork	Ha a lekéréses kérelem az adattár egy elágazásából származik, ez a változó a következőre `True`van állítva: . Ellenkező esetben a következőre `False`van állítva: .	Igen
System.PullRequest.PullRequestId	A buildet okozó lekéréses kérelem azonosítója. Például: `17` (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR).	Nem
System.PullRequest.PullRequestNumber	A buildet okozó lekéréses kérelem száma. Ez a változó a GitHubról érkező lekéréses kérelmekhez van feltöltve, amelyek eltérő lekéréses kérelmek azonosítójával és lekéréses kérelmek számmal rendelkeznek. Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre.	Nem
System.PullRequest.targetBranchName	A lekéréses kérelem célágának neve. Ez a változó egy folyamatban a lekéréses kérelem célága alapján feltételesen hajthat végre feladatokat vagy lépéseket. Előfordulhat például, hogy a módosításokat egyesítő ágtól függően más teszteket vagy kódelemzési eszközöket szeretne aktiválni.	Nem
System.PullRequest.SourceBranch	A lekéréses kérelemben áttekintett ág. Például: `refs/heads/users/raisa/new-feature` Azure-adattárak esetén. (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre.	Nem
System.PullRequest.SourceCommitId	A lekéréses kérelemben áttekintett véglegesítés. (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre.
System.PullRequest.SourceRepositoryURI	A lekéréses kérelmet tartalmazó adattár URL-címe. Például: `https://dev.azure.com/ouraccount/_git/OurProject`	Nem
System.PullRequest.TargetBranch	A lekéréses kérelem céljaként megadott ág. Például ha `refs/heads/main` az adattár az Azure-adattárban van, és `main` amikor az adattár a GitHubon található. Ez a változó csak akkor inicializálódik, ha a build egy ágszabályzat által érintett Git PR miatt futott. Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre.	Nem
System.StageAttempt	Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekményes, amikor a szakasz újrapróbálkozott.	Nem
System.StageDisplayName	Az ember által olvasható név, amit egy szakasznak adtak.	Nem
System.StageName	Egy szakasz sztringalapú azonosítója, amely általában függőségek kifejezésére és kimeneti változók elérésére szolgál.	Nem
System.TeamFoundationCollectionUri	Az Azure DevOps-szervezet vagy -gyűjtemény URI-ja. Például: `https://dev.azure.com/fabrikamfiber/` Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Igen
System.TeamProject	A buildet tartalmazó projekt neve.	Igen
System.TeamProjectId	Annak a projektnek az azonosítója, amelyhez ez a build tartozik.	Igen
System.TimelineId	Sztringalapú azonosító egyetlen folyamatfuttatás végrehajtási részleteihez és naplóihoz.	Nem
TF_BUILD	Állítsa `True`, ha egy buildelési feladat futtatja a szkriptet. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem

Változók ellenőrzése (DevOps Services)

Változó	Leírás
Checks.StageAttempt	Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekményes, amikor a szakasz újrapróbálkozott. Ez a változó csak jóváhagyás vagy környezet ellenőrzése során használható. Használhatja például `$(Checks.StageAttempt)` egy REST API-ellenőrzés meghívása során.

Ügynökváltozók (DevOps Server 2022)

Feljegyzés

Változó	Leírás
Agent.BuildDirectory	Az ügynök helyi elérési útja, ahol egy adott buildfolyamat összes mappája létrejön. Ez a változó ugyanazzal az értékkel rendelkezik, mint a `Pipeline.Workspace`. Például: `/home/vsts/work/1` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.
Agent.ContainerMapping	A YAML-ben található tárolóerőforrás-nevek és a Docker-azonosítók futásidejű leképezése. A példa a táblázatot követi.
Agent.HomeDirectory	A címtár, amelybe az ügynök telepítve van, és tartalmazza az ügynökszoftvert. Például: `c:\agent` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.
Agent.Id	Az ügynök azonosítója.
Agent.JobName	A futó feladat neve. A név általában `Job` vagy `__default`, de több konfigurációs forgatókönyvben ez a konfiguráció.
Agent.JobStatus	A build állapota. `Canceled` `Failed` `Succeeded` `SucceededWithIssues` (részben sikeres) `Skipped` (utolsó feladat) A környezeti változóra `AGENT_JOBSTATUS`a következőként kell hivatkozni: . A régebbi `agent.jobstatus` verzió a visszamenőleges kompatibilitás érdekében érhető el.
Agent.MachineName	Annak a gépnek a neve, amelyre az ügynök telepítve van.
Agent.Name	A készletben regisztrált ügynök neve. Ha saját üzemeltetésű ügynököt használ, akkor ez az érték a megadott név. Ügynökök megtekintése.
Agent.OS	Az ügynök gazdagépének operációs rendszere. Az érvényes értékek a következők: `Windows_NT` `Darwin` `Linux` Ha tárolóban fut, előfordulhat, hogy az ügynök gazdagépe és tárolója különböző operációs rendszereket futtat.
Agent.OSArchitecture	Az ügynök gazdagépének operációsrendszer-processzorarchitektúrája. Az érvényes értékek a következők: `X86` `X64` `ARM`
Agent.TempDirectory	Az egyes folyamatfeladatok után megtisztított ideiglenes mappa. Ezt a könyvtárat olyan tevékenységek használják, mint például a .NET Core CLI-feladat , amely ideiglenes elemeket, például teszteredményeket tárol a közzétételük előtt. Például: `/home/vsts/work/_temp` Ubuntu esetén.
Agent.ToolsDirectory	Az olyan feladatok által használt címtár, mint a Node Tool Installer és a Python-verzió használata az eszköz több verziója közötti váltáshoz. Ezek a feladatok eszközöket adnak hozzá a könyvtárból `PATH` , hogy a későbbi buildelési lépések használhassák őket. Ismerje meg, hogyan kezelheti ezt a címtárat egy saját üzemeltetésű ügynökön.
Agent.WorkFolder	Az ügynök munkakönyvtára. Például: `c:\agent_work` Megjegyzés: Ez a könyvtár nem garantáltan írható folyamatfeladatokkal (például tárolóba leképezve). Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.

Példa az Agent.ContainerMappingra:

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

Változók összeállítása (DevOps Server 2022)

Változó	Leírás	Elérhető sablonokban?
Build.ArtifactStagingDirectory	Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: `c:\agent_work\1\a` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Tekintse meg az Azure Pipelines összetevőit. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.BuildId	A befejezett build rekordjának azonosítója.	Nem
Build.BuildNumber	A befejezett build neve, más néven a futtatási szám. Megadhatja , hogy mi szerepel ebben az értékben. Ennek a változónak általában az a célja, hogy az adattár lapon megadott címkeformátum része legyen. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.BuildUri	A build URI-ja. Például: `vstfs:///Build/Build/1430` Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.BinariesDirectory	Az ügynök helyi elérési útja, amelyet kimeneti mappaként használhat a lefordított bináris fájlokhoz. Például: `c:\agent_work\1\b` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. Alapértelmezés szerint az új buildfolyamatok nincsenek beállítva a címtár tisztítására. A buildet úgy határozhatja meg, hogy megtisztítsa azt az Adattár lapon. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.ContainerId	Az összetevő tárolójának azonosítója. Amikor feltölt egy összetevőt a folyamatba, az hozzáadódik egy olyan tárolóhoz, amely az adott összetevőre jellemző.	Nem
Build.CronSchedule.DisplayName	A `displayName` folyamatfuttatást kiváltó cron-ütemezés. Ez a változó csak akkor van beállítva, ha egy YAML ütemezett eseményindító aktiválja a folyamat futtatását. További információ: schedules.cron definition – Build.CronSchedule.DisplayName változó. Ez a változó az Azure DevOps Server 2022.1 és újabb verzióiban érhető el.	Igen
Build.DefinitionName	A buildelési folyamat neve. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul.	Igen
Build.DefinitionVersion	A buildelési folyamat verziója.	Igen
Build.QueuedBy	Lásd Hogyan vannak beállítva az identitásváltozók?. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul.	Igen
Build.QueuedById	Lásd Hogyan vannak beállítva az identitásváltozók?.	Igen
Build.Reason	Az az esemény, amely a build futtatását okozta. `Manual`: Egy felhasználó manuálisan várólistára helyezett egy buildet. `IndividualCI`: Git-leküldés vagy TFVC-bejelentkezés által aktivált folyamatos integráció (CI ). `BatchedCI`: Git-leküldés vagy TFVC-bejelentkezés által aktivált folyamatos integráció (CI), és a Batch-módosítások ki lett választva. `Schedule`: Ütemezett eseményindító. `ValidateShelveset`: Egy felhasználó manuálisan várólistára helyezett egy adott TFVC-polckészletet. `CheckInShelveset`: Kapus bejelentkezési eseményindító. `PullRequest`: A Buildet igénylő Git-ágszabályzat aktiválja a buildet. `BuildCompletion`: egy másik build aktiválja a buildet `ResourceTrigger`: Egy erőforrás-eseményindító vagy egy másik build aktiválja a buildet. Lásd: Build pipeline triggers, Improve code quality with branch policies.	Igen
Build.Repository.Clean	A forrásadattár beállításaiTiszta beállításnál megadott érték. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.LocalPath	Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: `c:\agent_work\1\s` Alapértelmezés szerint az új buildelési folyamatok csak a módosított fájlokat frissítik. Az Adattár lapon módosíthatja a fájlok letöltési módját. Fontos megjegyzés: Ha csak egy Git-adattárat tekint meg, ez az elérési út a kód pontos elérési útja. Ha több adattárat is kivesz, a viselkedés a következő (és eltérhet a Build.SourcesDirectory változó értékétől): Ha az önkiszolgáló (elsődleges) adattár kivételi lépése nem definiált egyéni kivételi útvonalat, vagy a kivételi útvonal az öntárház több kivételes alapértelmezett elérési útja `$(Pipeline.Workspace)/s/<RepoName>` , a változó értéke visszaáll az alapértelmezett értékre, azaz `$(Pipeline.Workspace)/s`a . Ha az önkiszolgáló (elsődleges) adattár kivételi lépése egyéni kivételi útvonalként van definiálva, és nem a több kivételes alapértelmezett elérési útja, ez a változó pontosan tartalmazza az önadattár elérési útját. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.ID	Az adattár egyedi azonosítója. Ez az érték akkor sem változik, ha az adattár neve igen. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Name	Az eseményindító adattár neve. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Provider	Az eseményindító adattár típusa. `TfsGit`: TFS Git-adattár `TfsVersionControl`: Team Foundation verziókövetési (TFVC) `Git`: Külső kiszolgálón üzemeltetett Git-adattár `GitHub` `Svn`:Felforgatás Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Tfvc.Workspace	Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. A buildügynök által használt TFVC-munkaterület neve. Ha például az Agent.BuildDirectory az `c:\agent_work\12` , és a Agent.Id, `8`akkor a munkaterület neve a következő lehet: `ws_12_8`. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Uri	Az eseményindító adattár URL-címe. Példa: Git: https://fabrikamfiber@dev.azure.com/fabrikamfiber/_git/Scripts TFVC: https://dev.azure.com/fabrikamfiber/ Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.RequestedFor	Lásd: "Hogyan vannak beállítva az identitásváltozók?". Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul.	Igen
Build.RequestedForEmail	Lásd: "Hogyan vannak beállítva az identitásváltozók?".	Igen
Build.RequestedForId	Lásd: "Hogyan vannak beállítva az identitásváltozók?".	Igen
Build.SourceBranch	A buildet aktiváló adattár ága várólistára került. Néhány példa: Git-adattárág: `refs/heads/main` Git-adattár lekéréses kérése: `refs/pull/1/merge` TFVC-adattárág: `$/teamproject/main` TFVC-adattár kapus bejelentkezése: `Gated_2016-06-06_05.20.51.4369;username@live.com` TFVC-adattár polckészlet összeállítása: `myshelveset;username@live.com` Amikor egy címke aktiválja a folyamatot: `refs/tags/your-tag-name` Ha ezt a változót buildszámformátumban használja, a perjelek (`/`) karaktereit aláhúzásjelek `_`váltják fel. Megjegyzés: A TFVC-ben, ha kapus bejelentkezési buildet futtat, vagy manuálisan készít egy polckészletet, nem használhatja ezt a változót a buildszámformátumában.	Igen
Build.SourceBranchName	A buildet aktiváló adattár ágának neve várólistára került. Git-adattárág, lekéréses kérelem vagy címke: A ref utolsó elérési útszakasza. `refs/heads/main`például ez az érték `main`. A `refs/heads/feature/tools`ez az érték `tools`. A `refs/tags/your-tag-name`ez az érték `your-tag-name`. TFVC-adattárág: A munkaterület gyökérkiszolgálói elérési útjának utolsó elérési útja. `$/teamproject/main`például ez az érték `main`. A TFVC adattárkapus beadása vagy a polckészlet összeállítása a polckészlet neve. Például, `Gated_2016-06-06_05.20.51.4369;username@live.com` vagy `myshelveset;username@live.com`. Megjegyzés: A TFVC-ben, ha kapus bejelentkezési buildet futtat, vagy manuálisan készít egy polckészletet, nem használhatja ezt a változót a buildszámformátumában.	Igen
Build.SourcesDirectory	Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: `c:\agent_work\1\s` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. Alapértelmezés szerint az új buildelési folyamatok csak a módosított fájlokat frissítik. Fontos megjegyzés: Ha csak egy Git-adattárat tekint meg, ez az elérési út a kód pontos elérési útja. Ha több adattárat is kivesz, az visszaáll az alapértelmezett értékre, vagyis `$(Pipeline.Workspace)/s`még akkor is, ha az önkiszolgáló (elsődleges) adattárat a rendszer a több kivételes alapértelmezett elérési úttól `$(Pipeline.Workspace)/s/<RepoName>` eltérő egyéni elérési útra irányítja (ebben a tekintetben a változó eltér a Build.Repository.LocalPath változó viselkedésétől). Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.SourceVersion	A buildben található triggerelő adattár legújabb verziókövetési módosítása. Git: A véglegesítés azonosítója. TFVC: a változáskészlet. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Igen
Build.SourceVersionMessage	Az eseményindító adattár véglegesítésének vagy változáskészletének megjegyzése. Az üzenetet az első sorra vagy 200 karakterre csonkítjuk, attól függően, hogy melyik rövidebb. A `Build.SourceVersionMessage` véglegesítéskor `Build.SourceVersion` megjelenő üzenetnek felel meg. A `Build.SourceVersion` pr-buildek véglegesítése az egyesítési véglegesítés (nem a forráság véglegesítése). Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Emellett ez a változó csak a lépés szintjén érhető el. A feladat- vagy szakaszszintek nem érhetők el. Vagyis az üzenet nem lesz kinyerve, amíg a feladat el nem indul, és a kód ki van véve. >Megjegyzés: A Build.SourceVersionMessage változó nem működik a Bitbucket-adattárak klasszikus buildelési folyamataival, ha Batch-módosításokat végez, miközben a buildelés folyamatban van, engedélyezve van.	Nem
Build.StagingDirectory	Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: `c:\agent_work\1\a` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Tekintse meg az Azure Pipelines összetevőit. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Git.SubmoduleCheckout	A Kivétel almodulok a adattár lapján. Ha több adattárat is kivett, ez az érték nyomon követi az eseményindító adattár beállításait. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.SourceTfvcShelveset	Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. Ha kapus buildelési vagy polckészlet-összeállításifuttat, ez a változó az éppen létrehozott polckészlet nevére van állítva. Megjegyzés: Ez a változó olyan értéket ad, amely a buildszámformátumban való buildhasználathoz érvénytelen.	Nem
Build.TriggerBy.BuildId	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build BuildID azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot `resources`aktivál, használja inkább az erőforrásváltozókat .	Nem
Build.TriggerBy.DefinitionId	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build DefinitionID azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot `resources`aktivál, használja inkább az erőforrásváltozókat .	Nem
Build.TriggerBy.DefinitionName	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító buildfolyamat nevére van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot `resources`aktivál, használja inkább az erőforrásváltozókat .	Nem
Build.TriggerBy.BuildNumber	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build számára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot `resources`aktivál, használja inkább az erőforrásváltozókat .	Nem
Build.TriggerBy.ProjectID	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító buildet tartalmazó projekt azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot `resources`aktivál, használja inkább az erőforrásváltozókat .	Nem
Common.TestResultsDirectory	Annak az ügynöknek a helyi elérési útja, ahol a teszteredmények létrejönnek. Például: `c:\agent_work\1\TestResults` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem

Folyamatváltozók (DevOps Server 2022)

Változó	Leírás
Pipeline.Workspace	Egy adott folyamat munkaterületi címtára. Ez a változó ugyanazzal az értékkel rendelkezik, mint a `Agent.BuildDirectory`. Például: `/home/vsts/work/1`. Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.

Tipp.

Ha klasszikus kiadási folyamatokat használ, klasszikus kiadások és összetevők változói az adatok tárolására és elérésére a folyamat teljes területén.

Üzembehelyezési feladat változói (DevOps Server 2022)

Ezek a változók egy adott üzembehelyezési feladatra vonatkoznak, és csak a feladat végrehajtásakor oldódnak fel.

Változó	Leírás
Environment.Name	Az üzembe helyezési feladatban megcélzott környezet neve az üzembe helyezési lépések futtatásához és az üzembe helyezési előzmények rögzítéséhez. Például: `smarthotel-dev`.
Environment.Id	Az üzembe helyezési feladatban megcélzott környezet azonosítója. Például: `10`.
Environment.ResourceName	Az üzembe helyezési lépések futtatásához és az üzembe helyezési előzmények rögzítéséhez az üzembe helyezési feladatban megcélzott környezetben lévő adott erőforrás neve. Például `bookings`, amely egy Kubernetes-névtér, amely erőforrásként van hozzáadva a környezethez `smarthotel-dev`.
Environment.ResourceId	Az üzembe helyezési lépések futtatásához az üzembe helyezési feladatban megcélzott környezetben lévő adott erőforrás azonosítója. Például: `4`.
Strategy.Name	Az üzembehelyezési stratégia neve: `canary`, `runOnce`vagy `rolling`.
Strategy.CycleName	Az üzemelő példány aktuális ciklusneve. A beállítások a következők `PreIteration`: , `Iteration`vagy `PostIteration`.

Rendszerváltozók (DevOps Server 2022)

Változó	Leírás	Elérhető sablonokban?
System.AccessToken	Az OAuth-jogkivonat használatával érheti el a REST API-t. Használja a System.AccessTokent YAML-szkriptekből. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Igen
System.CollectionId	Az Azure DevOps-szervezet vagy -gyűjtemény GUID azonosítója.	Igen
System.CollectionUri	Az Azure DevOps-szervezet vagy -gyűjtemény URI-ja. Például: `https://dev.azure.com/fabrikamfiber/`	Igen
System.DefaultWorkingDirectory	Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: `c:\agent_work\1\s` Az ügynökkönyvtár struktúrájáról további információt Ügynökkönyvtár-struktúracímű témakörben talál. A saját üzemeltetésű ügynökök esetében az új buildfolyamatok alapértelmezés szerint csak a módosított fájlokat frissítik. Az Adattár lapon módosíthatja a fájlok letöltési módját. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Igen
System.DefinitionId	A buildelési folyamat azonosítója.	Igen
System.HostType	Állítsa be, hogy `build` a folyamat build-e. Egy kiadás esetében az értékek `deployment` egy üzembehelyezési csoport feladatához, `gates` a kapuk kiértékelése során, valamint `release` más (ügynök- és ügynök nélküli) feladatokhoz tartoznak.	Igen
System.JobAttempt	Állítsa 1 értékre a feladat első kísérletekor, és minden alkalommal növekszik, amikor a feladat újrapróbálkozott.	Nem
System.JobDisplayName	Az ember által olvasható név, amit egy feladatnak adtak.	Nem
System.JobId	Egyetlen feladat egyetlen kísérletének egyedi azonosítója. Az érték egyedi az aktuális folyamathoz.	Nem
System.JobName	A feladat neve, amely általában a függőségek kifejezésére és a kimeneti változók elérésére szolgál.	Nem
System.PhaseAttempt	Állítsa 1 értékre a fázis első kísérletekor, és minden alkalommal növekszik, amikor a feladat újrapróbálkozott. Megjegyzés: fázis egy többnyire redundáns fogalom, amely egy feladat tervezési idejét jelöli (míg a feladat egy fázis futtatókörnyezeti verziója volt). A fázis fogalma többnyire el van távolítva az Azure Pipelinesból. A mátrix- és többkonfigurációs feladatok az egyetlen olyan hely, ahol a fázisok továbbra is eltérnek a feladatoktól. Egy fázis több feladatot is képes létrehozni, amelyek csak a bemeneteikben különböznek.	Nem
System.PhaseDisplayName	Az ember által olvasható név, amelyet egy fázisnak adnak.	Nem
System.PhaseName	Egy feladat sztringalapú azonosítója, amely általában függőségek kifejezésére és kimeneti változók elérésére szolgál.	Nem
System.PlanId	Sztringalapú azonosító egyetlen folyamatfuttatáshoz.	Nem
System.PullRequest.IsFork	Ha a lekéréses kérelem az adattár egy elágazásából származik, ez a változó a következőre `True`van állítva: . Ellenkező esetben a következőre `False`van állítva: .	Igen
System.PullRequest.PullRequestId	A buildet okozó lekéréses kérelem azonosítója. Például: `17` (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR).	Nem
System.PullRequest.PullRequestNumber	A buildet okozó lekéréses kérelem száma. Ez a változó a GitHubról érkező lekéréses kérelmekhez van feltöltve, amelyek eltérő lekéréses kérelmek azonosítójával és lekéréses kérelmek számmal rendelkeznek. Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre.	Nem
System.PullRequest.targetBranchName	A lekéréses kérelem célágának neve. Ez a változó egy folyamatban a lekéréses kérelem célága alapján feltételesen hajthat végre feladatokat vagy lépéseket. Előfordulhat például, hogy a módosításokat egyesítő ágtól függően más teszteket vagy kódelemzési eszközöket szeretne aktiválni.	Nem
System.PullRequest.SourceBranch	A lekéréses kérelemben áttekintett ág. Például: `refs/heads/users/raisa/new-feature` Azure-adattárak esetén. (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre.	Nem
System.PullRequest.SourceRepositoryURI	A lekéréses kérelmet tartalmazó adattár URL-címe. Például: `https://dev.azure.com/ouraccount/_git/OurProject`	Nem
System.PullRequest.TargetBranch	A lekéréses kérelem céljaként megadott ág. Például ha `refs/heads/main` az adattár az Azure-adattárban van, és `main` amikor az adattár a GitHubon található. Ez a változó csak akkor inicializálódik, ha a build egy ágszabályzat által érintett Git PR miatt futott. Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre.	Nem
System.StageAttempt	Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekményes, amikor a szakasz újrapróbálkozott.	Nem
System.StageDisplayName	Az ember által olvasható név, amit egy szakasznak adtak.	Nem
System.StageName	Egy szakasz sztringalapú azonosítója, amely általában függőségek kifejezésére és kimeneti változók elérésére szolgál.	Nem
System.TeamFoundationCollectionUri	Az Azure DevOps-szervezet vagy -gyűjtemény URI-ja. Például: `https://dev.azure.com/fabrikamfiber/` Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Igen
System.TeamProject	A buildet tartalmazó projekt neve.	Igen
System.TeamProjectId	Annak a projektnek az azonosítója, amelyhez ez a build tartozik.	Igen
System.TimelineId	Sztringalapú azonosító egyetlen folyamatfuttatás végrehajtási részleteihez és naplóihoz.	Nem
TF_BUILD	Állítsa `True`, ha egy buildelési feladat futtatja a szkriptet. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem

Változók ellenőrzése (DevOps Server 2022)

Változó	Leírás
Checks.StageAttempt	Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekményes, amikor a szakasz újrapróbálkozott. Ez a változó csak jóváhagyás vagy környezet ellenőrzése során használható. Használhatja például `$(Checks.StageAttempt)` egy REST API-ellenőrzés meghívása során.

Ügynökváltozók (DevOps Server 2020)

Feljegyzés

Változó	Leírás
Agent.BuildDirectory	Az ügynök helyi elérési útja, ahol egy adott buildfolyamat összes mappája létrejön. Ez a változó ugyanazzal az értékkel rendelkezik, mint a `Pipeline.Workspace`. Például: `/home/vsts/work/1` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.
Agent.HomeDirectory	A címtár, amelybe az ügynök telepítve van, és tartalmazza az ügynökszoftvert. Például: `c:\agent` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.
Agent.Id	Az ügynök azonosítója.
Agent.JobName	A futó feladat neve. A név általában `Job` vagy `_default`, de többkonfigurációs forgatókönyvekben ez a konfiguráció.
Agent.JobStatus	A build állapota. `Canceled` `Failed` `Succeeded` `SucceededWithIssues` (részben sikeres) `Skipped` (utolsó feladat) A környezeti változóra `AGENT_JOBSTATUS`a következőként kell hivatkozni: . A régebbi `agent.jobstatus` verzió a visszamenőleges kompatibilitás érdekében érhető el.
Agent.MachineName	Annak a gépnek a neve, amelyre az ügynök telepítve van.
Agent.Name	A készletben regisztrált ügynök neve. Ha saját üzemeltetésű ügynököt használ, akkor ezt a nevet Ön állítja be. Ügynökök megtekintése.
Agent.OS	Az ügynök gazdagépének operációs rendszere. Az érvényes értékek a következők: `Windows_NT` `Darwin` `Linux` Ha tárolóban fut, előfordulhat, hogy az ügynök gazdagépe és tárolója különböző operációs rendszereket futtat.
Agent.OSArchitecture	Az ügynök gazdagépének operációsrendszer-processzorarchitektúrája. Az érvényes értékek a következők: `X86` `X64` `ARM processor`
Agent.TempDirectory	Az egyes folyamatfeladatok után megtisztított ideiglenes mappa. Ezt a könyvtárat olyan tevékenységek használják, mint például a .NET Core CLI-feladat , amely ideiglenes elemeket, például teszteredményeket tárol a közzétételük előtt. Például: `/home/vsts/work/_temp` Ubuntu esetén.
Agent.ToolsDirectory	Az olyan feladatok által használt címtár, mint a Node Tool Installer és a Python-verzió használata az eszköz több verziója közötti váltáshoz. Ezek a feladatok eszközöket adnak hozzá a könyvtárból `PATH` , hogy a későbbi buildelési lépések használhassák őket. Ismerje meg, hogyan kezelheti ezt a címtárat egy saját üzemeltetésű ügynökön.
Agent.WorkFolder	Az ügynök munkakönyvtára. Például: `c:\agent_work` Megjegyzés: Ez a könyvtár nem garantáltan írható folyamatfeladatokkal (például tárolóba leképezve). Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.

Változók összeállítása (DevOps Server 2020)

Ha olyan változót használ sablonban, amely nem szerepel a sablonokban elérhetőként megjelölve. A változó nem jelenik meg, mert értéke nem érhető el a sablon hatókörén belül.

Változó	Leírás	Elérhető sablonokban?
Build.ArtifactStagingDirectory	Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: `c:\agent_work\1\a` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Tekintse meg az Azure Pipelines összetevőit. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.BuildId	A befejezett build rekordjának azonosítója.	Nem
Build.BuildNumber	A befejezett build neve, más néven a futtatási szám. Megadhatja , hogy mi szerepel ebben az értékben. Ennek a változónak általában az a célja, hogy az adattár lapon megadott címkeformátum része legyen. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.BuildUri	A build URI-ja. Például: `vstfs:///Build/Build/1430` Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.BinariesDirectory	Az ügynök helyi elérési útja, amelyet kimeneti mappaként használhat a lefordított bináris fájlokhoz. Például: `c:\agent_work\1\b` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. Alapértelmezés szerint az új buildfolyamatok nincsenek beállítva a címtár tisztítására. A buildet úgy határozhatja meg, hogy megtisztítsa azt az Adattár lapon. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.ContainerId	Az összetevő tárolójának azonosítója. Amikor feltölt egy összetevőt a folyamatba, az hozzáadódik egy olyan tárolóhoz, amely az adott összetevőre jellemző.	Nem
Build.DefinitionName	A buildelési folyamat neve. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul.	Igen
Build.DefinitionVersion	A buildelési folyamat verziója.	Igen
Build.QueuedBy	Lásd Hogyan vannak beállítva az identitásváltozók?. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul.	Igen
Build.QueuedById	Lásd Hogyan vannak beállítva az identitásváltozók?.	Igen
Build.Reason	Az az esemény, amely a build futtatását okozta. `Manual`: Egy felhasználó manuálisan várólistára helyezett egy buildet. `IndividualCI`: Git-leküldés vagy TFVC-bejelentkezés által aktivált folyamatos integráció (CI ). `BatchedCI`: Git-leküldés vagy TFVC-bejelentkezés által aktivált folyamatos integráció (CI), és a Batch-módosítások ki lett választva. `Schedule`: Ütemezett eseményindító. `ValidateShelveset`: Egy felhasználó manuálisan várólistára helyezett egy adott TFVC-polckészletet. `CheckInShelveset`: Kapus bejelentkezési eseményindító. `PullRequest`: A Buildet igénylő Git-ágszabályzat aktiválja a buildet. `BuildCompletion`: egy másik build aktiválja a buildet `ResourceTrigger`: Egy erőforrás-eseményindító vagy egy másik build aktiválja a buildet. Lásd: Build pipeline triggers, Improve code quality with branch policies.	Igen
Build.Repository.Clean	A Tisztaforrásadattár beállításaiban kiválasztott érték. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.LocalPath	Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: `c:\agent_work\1\s` Alapértelmezés szerint az új buildelési folyamatok csak a módosított fájlokat frissítik. Az Adattár lapon módosíthatja a fájlok letöltési módját. Fontos megjegyzés: Ha csak egy Git-adattárat tekint meg, ez az elérési út a kód pontos elérési útja. Ha több adattárat is kivesz, a viselkedés a következő (és eltérhet a Build.SourcesDirectory változó értékétől): Ha az önkiszolgáló (elsődleges) adattár kivételi lépése nem definiált egyéni kivételi útvonalat, vagy a kivételi útvonal az öntárház több kivételes alapértelmezett elérési útja `$(Pipeline.Workspace)/s/<RepoName>` , a változó értéke visszaáll az alapértelmezett értékre, azaz `$(Pipeline.Workspace)/s`a . Ha az önkiszolgáló (elsődleges) adattár kivételi lépése egyéni kivételi útvonalként van definiálva, és nem a több kivételes alapértelmezett elérési útja, ez a változó pontosan tartalmazza az önadattár elérési útját. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.ID	Az adattár egyedi azonosítója. Az érték nem változik, még akkor sem, ha az adattár neve igen. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Name	Az eseményindító adattár neve. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Provider	Az eseményindító adattár típusa. `TfsGit`: TFS Git-adattár `TfsVersionControl`: Team Foundation verziókövetés `Git`: Külső kiszolgálón üzemeltetett Git-adattár `GitHub` `Svn`:Felforgatás Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Tfvc.Workspace	Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. A buildügynök által használt TFVC-munkaterület neve. Ha például az Agent.BuildDirectory az `c:\agent_work\12` , és a Agent.Id, `8`akkor a munkaterület neve a következő lehet: `ws_12_8`. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Uri	Az eseményindító adattár URL-címe. Példa: Git: https://dev.azure.com/fabrikamfiber/_git/Scripts TFVC: https://dev.azure.com/fabrikamfiber/ Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.RequestedFor	Lásd Hogyan vannak beállítva az identitásváltozók?. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul.	Igen
Build.RequestedForEmail	Lásd Hogyan vannak beállítva az identitásváltozók?.	Igen
Build.RequestedForId	Lásd Hogyan vannak beállítva az identitásváltozók?.	Igen
Build.SourceBranch	A buildet aktiváló adattár ága várólistára került. Néhány példa: Git-adattárág: `refs/heads/main` Git-adattár lekéréses kérése: `refs/pull/1/merge` TFVC-adattárág: `$/teamproject/main` TFVC-adattár kapus bejelentkezése: `Gated_2016-06-06_05.20.51.4369;username@live.com` TFVC-adattár polckészlet összeállítása: `myshelveset;username@live.com` Amikor egy címke aktiválja a folyamatot: `refs/tags/your-tag-name` Ha ezt a változót buildszámformátumban használja, a perjelek (`/`) karaktereit aláhúzásjelek `_`váltják fel. Megjegyzés: A TFVC-ben, ha kapus bejelentkezési buildet futtat, vagy manuálisan készít egy polckészletet, nem használhatja ezt a változót a buildszámformátumában.	Igen
Build.SourceBranchName	A buildet aktiváló adattár ágának neve várólistára került. Git-adattárág, lekéréses kérelem vagy címke: A ref utolsó elérési útszakasza. Ebben az értékben `refs/heads/main` például a következő: `main`. A `refs/heads/feature/tools`ez az érték `tools`. A `refs/tags/your-tag-name`ez az érték `your-tag-name`. TFVC-adattárág: A munkaterület gyökérkiszolgálói elérési útjának utolsó elérési útja. Ebben az értékben `$/teamproject/main` például a következő: `main`. A TFVC adattárkapus beadása vagy a polckészlet összeállítása a polckészlet neve. Például, `Gated_2016-06-06_05.20.51.4369;username@live.com` vagy `myshelveset;username@live.com`. Megjegyzés: A TFVC-ben, ha kapus bejelentkezési buildet futtat, vagy manuálisan készít egy polckészletet, nem használhatja ezt a változót a buildszámformátumában.	Igen
Build.SourcesDirectory	Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: `c:\agent_work\1\s` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. Alapértelmezés szerint az új buildelési folyamatok csak a módosított fájlokat frissítik. Fontos megjegyzés: Ha csak egy Git-adattárat tekint meg, ez az elérési út a kód pontos elérési útja. Ha több adattárat is kivesz, az visszaáll az alapértelmezett értékre, vagyis `$(Pipeline.Workspace)/s`még akkor is, ha az önkiszolgáló (elsődleges) adattárat a rendszer a több kivételes alapértelmezett elérési úttól `$(Pipeline.Workspace)/s/<RepoName>` eltérő egyéni elérési útra irányítja (ebben a tekintetben a változó eltér a Build.Repository.LocalPath változó viselkedésétől). Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.SourceVersion	A buildben található triggerelő adattár legújabb verziókövetési módosítása. Git: A véglegesítés azonosítója. TFVC: a változáskészlet. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Igen
Build.SourceVersionMessage	Az eseményindító adattár véglegesítésének vagy változáskészletének megjegyzése. Az üzenetet az első sorra vagy 200 karakterre csonkítjuk, attól függően, hogy melyik rövidebb. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Emellett ez a változó csak a lépés szintjén érhető el. A feladat- vagy szakaszszintek nem érhetők el. Vagyis az üzenet nem lesz kinyerve, amíg a feladat el nem indul, és ki nem veszi a kódot. Megjegyzés: A Build.SourceVersionMessage változó nem működik a Bitbucket-adattárak klasszikus buildelési folyamataival, ha Batch-módosításokat végez, miközben a buildelés folyamatban van, engedélyezve van.	Nem
Build.StagingDirectory	Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: `c:\agent_work\1\a` A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Tekintse meg az Azure Pipelines összetevőit. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Git.SubmoduleCheckout	A Kivétel almodulok a adattár lapján. Ha több adattárat is kivett, ez az érték nyomon követi az eseményindító adattár beállításait. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.SourceTfvcShelveset	Akkor van definiálva, ha a adattár a Team Foundation verziókövetése (TFVC). Ha kapus buildelési vagy polckészlet-összeállításifuttat, ez a változó az éppen létrehozott polckészlet nevére van állítva. Megjegyzés: Ez a változó olyan értéket ad, amely a buildszámformátumban való buildhasználathoz érvénytelen.	Nem
Build.TriggerBy.BuildId	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build BuildID azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.TriggerBy.DefinitionId	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build DefinitionID azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.TriggerBy.DefinitionName	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító buildfolyamat nevére van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.TriggerBy.BuildNumber	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build számára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.TriggerBy.ProjectID	Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító buildet tartalmazó projekt azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
Common.TestResultsDirectory	Annak az ügynöknek a helyi elérési útja, ahol a teszteredmények létrejönnek. Például: `c:\agent_work\1\TestResults` Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem

Folyamatváltozók (DevOps Server 2020)

Változó	Leírás
Pipeline.Workspace	Egy adott folyamat munkaterületi címtára. Ez a változó ugyanazzal az értékkel rendelkezik, mint a `Agent.BuildDirectory`. Például: `/home/vsts/work/1`. Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.

Üzembehelyezési feladat változói (DevOps Server 2020)

Ezek a változók egy adott üzembehelyezési feladatra vonatkoznak, és csak a feladat végrehajtásakor oldódnak fel.

Változó	Leírás
Environment.Name	Az üzembe helyezési feladatban megcélzott környezet neve az üzembe helyezési lépések futtatásához és az üzembe helyezési előzmények rögzítéséhez. Például: `smarthotel-dev`.
Environment.Id	Az üzembe helyezési feladatban megcélzott környezet azonosítója. Például: `10`.
Environment.ResourceName	Az üzembe helyezési lépések futtatásához és az üzembe helyezési előzmények rögzítéséhez az üzembe helyezési feladatban megcélzott környezetben lévő adott erőforrás neve. Például `bookings`, amely egy Kubernetes-névtér, amely erőforrásként van hozzáadva a környezethez `smarthotel-dev`.
Environment.ResourceId	Az üzembe helyezési lépések futtatásához az üzembe helyezési feladatban megcélzott környezetben lévő adott erőforrás azonosítója. Például: `4`.

Rendszerváltozók (DevOps Server 2020)

Ha olyan változót használ sablonban, amely nem szerepel a sablonokban elérhetőként megjelölve. A változó nem jelenik meg, mert értéke nem érhető el a sablon hatókörén belül.

Változó	Leírás	Elérhető sablonokban?
System.AccessToken	Az OAuth-jogkivonat használatával érheti el a REST API-t. Használja a System.AccessTokent YAML-szkriptekből. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Igen
System.CollectionId	A TFS-gyűjtemény vagy az Azure DevOps-szervezet GUID azonosítója	Igen
System.CollectionUri	Egy sztring Team Foundation-kiszolgáló gyűjteményének URI-ja.	Igen
System.DefaultWorkingDirectory	Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: `c:\agent_work\1\s` Az ügynökkönyvtár struktúrájáról további információt Ügynökkönyvtár-struktúracímű témakörben talál. A saját üzemeltetésű ügynökök esetében az új buildfolyamatok alapértelmezés szerint csak a módosított fájlokat frissítik. Az Adattár lapon módosíthatja a fájlok letöltési módját. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem
System.DefinitionId	A buildelési folyamat azonosítója.	Igen
System.HostType	Állítsa be, hogy `build` a folyamat build-e. Egy kiadás esetében az értékek `deployment` egy üzembehelyezési csoport feladatához, `gates` a kapuk kiértékelése során, valamint `release` más (ügynök- és ügynök nélküli) feladatokhoz tartoznak.	Igen
System.JobAttempt	Állítsa 1 értékre a feladat első kísérletekor, és minden alkalommal növekszik, amikor a feladat újrapróbálkozott.	Nem
System.JobDisplayName	Az ember által olvasható név, amit egy feladatnak adtak.	Nem
System.JobId	Egyetlen feladat egyetlen kísérletének egyedi azonosítója. Az érték egyedi az aktuális folyamathoz.	Nem
System.JobName	A feladat neve, amely általában a függőségek kifejezésére és a kimeneti változók elérésére szolgál.	Nem
System.PhaseAttempt	Állítsa 1 értékre a fázis első kísérletekor, és minden alkalommal növekszik, amikor a feladat újrapróbálkozott. Megjegyzés: fázis egy többnyire redundáns fogalom, amely egy feladat tervezési idejét jelöli (míg a feladat egy fázis futtatókörnyezeti verziója volt). A fázis fogalma többnyire el van távolítva az Azure Pipelinesból. A mátrix- és többkonfigurációs feladatok az egyetlen olyan hely, ahol a fázisok továbbra is eltérnek a feladatoktól. Egy fázis több feladatot is képes létrehozni, amelyek csak a bemeneteikben különböznek.	Nem
System.PhaseDisplayName	Az ember által olvasható név, amelyet egy fázisnak adnak.	Nem
System.PhaseName	Egy feladat sztringalapú azonosítója, amely általában függőségek kifejezésére és kimeneti változók elérésére szolgál.	Nem
System.StageAttempt	Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekszik, amikor a feladat újrapróbálkozott.	Nem
System.StageDisplayName	Az ember által olvasható név, amit egy szakasznak adtak.	Nem
System.StageName	Egy szakasz sztringalapú azonosítója, amely általában függőségek kifejezésére és kimeneti változók elérésére szolgál.	Igen
System.PullRequest.IsFork	Ha a lekéréses kérelem az adattár egy elágazásából származik, ez a változó a következőre `True`van állítva: . Ellenkező esetben az értéke `False`.	Igen
System.PullRequest.PullRequestId	A buildet okozó lekéréses kérelem azonosítója. Például: `17` (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR).	Nem
System.PullRequest.PullRequestNumber	A buildet okozó lekéréses kérelem száma. Ez a változó a GitHubról érkező lekéréses kérelmekhez van feltöltve, amelyek eltérő lekéréses kérelmek azonosítójával és lekéréses kérelmek számmal rendelkeznek. Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre.	Nem
System.PullRequest.targetBranchName	A lekéréses kérelem célágának neve. Ez a változó egy folyamatban a lekéréses kérelem célága alapján feltételesen hajthat végre feladatokat vagy lépéseket. Előfordulhat például, hogy a módosításokat egyesítő ágtól függően más teszteket vagy kódelemzési eszközöket szeretne aktiválni.	Nem
System.PullRequest.SourceBranch	A lekéréses kérelemben áttekintett ág. Például: `refs/heads/users/raisa/new-feature` (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre.	Nem
System.PullRequest.SourceCommitId	A lekéréses kérelemben áttekintett véglegesítés. (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre.
System.PullRequest.SourceRepositoryURI	A lekéréses kérelmet tartalmazó adattár URL-címe. Például: `https://dev.azure.com/ouraccount/_git/OurProject`	Nem
System.PullRequest.TargetBranch	A lekéréses kérelem céljaként megadott ág. Például ha `refs/heads/main` az adattár az Azure-adattárban van, és `main` amikor az adattár a GitHubon található. Ez a változó csak akkor inicializálódik, ha a build egy ágszabályzat által érintett Git PR miatt futott. Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre.	Nem
System.TeamFoundationCollectionUri	A csapatalapítási gyűjtemény URI-ja. Például: `https://dev.azure.com/fabrikamfiber/` Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Igen
System.TeamProject	A buildet tartalmazó projekt neve.	Igen
System.TeamProjectId	Annak a projektnek az azonosítója, amelyhez ez a build tartozik.	Igen
TF_BUILD	Állítsa `True`, ha egy buildelési feladat futtatja a szkriptet. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.	Nem

Ügynökváltozók (DevOps Server 2019)

Feljegyzés

Változó	Leírás
Agent.BuildDirectory	Az ügynök helyi elérési útja, ahol egy adott buildfolyamat összes mappája létrejön. Például: `c:\agent_work\1`
Agent.HomeDirectory	A címtár, amelybe az ügynök telepítve van. Ez tartalmazza az ügynökszoftvert. Például: `c:\agent`
Agent.Id	Az ügynök azonosítója.
Agent.JobName	A futó feladat neve. Ez általában "Feladat" vagy "__default" lesz, de több konfigurációs forgatókönyv esetén ez lesz a konfiguráció.
Agent.JobStatus	A build állapota. `Canceled` `Failed` `Succeeded` `SucceededWithIssues` (részben sikeres) `Skipped` (utolsó feladat) A környezeti változóra `AGENT_JOBSTATUS`a következőként kell hivatkozni: . A régebbi `agent.jobstatus` verzió a visszamenőleges kompatibilitás érdekében érhető el.
Agent.MachineName	Annak a gépnek a neve, amelyre az ügynök telepítve van.
Agent.Name	A készletben regisztrált ügynök neve. Ha saját üzemeltetésű ügynököt használ, akkor ezt a nevet ön állítja be. Ügynökök megtekintése.
Agent.OS	Az ügynök gazdagépének operációs rendszere. Az érvényes értékek a következők: `Windows_NT` `Darwin` `Linux` Ha tárolóban fut, előfordulhat, hogy az ügynök gazdagépe és tárolója különböző operációs rendszereket futtat.
Agent.OSArchitecture	Az ügynök gazdagépének operációsrendszer-processzorarchitektúrája. Az érvényes értékek a következők: `X86` `X64` `ARM processor`
Agent.TempDirectory	Az egyes folyamatfeladatok után megtisztított ideiglenes mappa. Ezt a könyvtárat olyan tevékenységek használják, mint például a .NET Core CLI-feladat , amely ideiglenes elemeket, például teszteredményeket tárol a közzétételük előtt.
Agent.ToolsDirectory	Az olyan feladatok által használt címtár, mint a Node Tool Installer és a Python-verzió használata az eszköz több verziója közötti váltáshoz. Ezek a feladatok eszközöket adnak hozzá a könyvtárból `PATH` , hogy a későbbi buildelési lépések használhassák őket. Ismerje meg, hogyan kezelheti ezt a címtárat egy saját üzemeltetésű ügynökön.
Agent.WorkFolder	Az ügynök munkakönyvtára. Például: `c:\agent_work` Ez a könyvtár nem garantáltan írható folyamatfeladatokkal (például tárolóba leképezve).

Változók összeállítása (DevOps Server 2019)

Változó	Leírás
Build.ArtifactStagingDirectory	Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: `c:\agent_work\1\a` A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Tekintse meg az Azure Pipelines összetevőit. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.BuildId	A befejezett build rekordjának azonosítója.
Build.BuildNumber	A befejezett build neve. A folyamatbeállításokban megadhatja az értéket generáló buildszámformátumot. Ennek a változónak általában az a célja, hogy az adattár lapon megadott címkeformátum része legyen. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.BuildUri	A build URI-ja. Például: `vstfs:///Build/Build/1430` Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.BinariesDirectory	Az ügynök helyi elérési útja, amelyet kimeneti mappaként használhat a lefordított bináris fájlokhoz. Alapértelmezés szerint az új buildfolyamatok nincsenek beállítva a címtár tisztítására. A buildet úgy határozhatja meg, hogy megtisztítsa azt az Adattár lapon. Például: `c:\agent_work\1\b` Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.DefinitionName	A buildelési folyamat neve. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma sikertelen lesz.
Build.DefinitionVersion	A buildelési folyamat verziója.
Build.QueuedBy	Lásd: "Hogyan vannak beállítva az identitásváltozók?". Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul.
Build.QueuedById	Lásd: "Hogyan vannak beállítva az identitásváltozók?".
Build.Reason	Az az esemény, amely a build futtatását okozta. `Manual`: Egy felhasználó manuálisan várólistára helyezett egy buildet. `IndividualCI`: Git-leküldés vagy TFVC-bejelentkezés által aktivált folyamatos integráció (CI ). `BatchedCI`: Git-leküldés vagy TFVC-bejelentkezés által aktivált folyamatos integráció (CI), és a Batch-módosítások ki lett választva. `Schedule`: Ütemezett eseményindító. `ValidateShelveset`: Egy felhasználó manuálisan várólistára helyezett egy adott TFVC-polckészletet. `CheckInShelveset`: Kapus bejelentkezési eseményindító. `PullRequest`: A buildet egy Git-ágszabályzat aktiválta, amely buildet igényel. `BuildCompletion`: A buildet egy másik build aktiválta. Lásd: Build pipeline triggers, Improve code quality with branch policies.
Build.Repository.Clean	A forrásadattár beállításaiban a Tiszta érték. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.Repository.LocalPath	Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: `c:\agent_work\1\s` Alapértelmezés szerint az új buildelési folyamatok csak a módosított fájlokat frissítik. Az Adattár lapon módosíthatja a fájlok letöltési módját. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. Ez a változó a Build.SourcesDirectory szinonimája.
Build.Repository.Name	Az adattár neve. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.Repository.Provider	A kiválasztott adattár típusa. `TfsGit`: TFS Git-adattár `TfsVersionControl`: Team Foundation verziókövetés `Git`: Külső kiszolgálón üzemeltetett Git-adattár `GitHub` `Svn`:Felforgatás Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.Repository.Tfvc.Workspace	Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. A buildügynök által használt TFVC-munkaterület neve. Ha például az Agent.BuildDirectory az `c:\agent_work\12` , és a Agent.Id, `8`akkor a munkaterület neve a következő lehet: `ws_12_8`. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.Repository.Uri	Az adattár URL-címe. Példa: Git: https://dev.azure.com/fabrikamfiber/_git/Scripts TFVC: https://dev.azure.com/fabrikamfiber/ Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.RequestedFor	Lásd: "Hogyan vannak beállítva az identitásváltozók?". Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul.
Build.RequestedForEmail	Lásd: "Hogyan vannak beállítva az identitásváltozók?".
Build.RequestedForId	Lásd: "Hogyan vannak beállítva az identitásváltozók?".
Build.SourceBranch	Az az ág, amelyhez a build várólistára került. Néhány példa: Git-adattárág: `refs/heads/main` Git-adattár lekéréses kérése: `refs/pull/1/merge` TFVC-adattárág: `$/teamproject/main` TFVC-adattár kapus bejelentkezése: `Gated_2016-06-06_05.20.51.4369;username@live.com` TFVC-adattár polckészlet összeállítása: `myshelveset;username@live.com` Ha ezt a változót buildszámformátumban használja, a perjelek (`/`) karaktereit aláhúzásjelek (`_`) váltják fel. Megjegyzés: A TFVC-ben, ha kapus bejelentkezési buildet futtat, vagy manuálisan készít egy polckészletet, nem használhatja ezt a változót a buildszámformátumában.
Build.SourceBranchName	Annak az ágnak a neve, amelyhez a build várólistára került. Git-adattárág, lekéréses kérelem vagy címke: A ref utolsó elérési útszakasza. Ebben az értékben `refs/heads/main` például a következő: `main`. Ebben az értékben `refs/heads/feature/tools` a .`tools` Ebben az értékben `refs/tags/your-tag-name` a .`your-tag-name` TFVC-adattárág: A munkaterület gyökérkiszolgálói elérési útjának utolsó elérési útja. Ebben az értékben `$/teamproject/main` például a .`main` A TFVC adattárkapus beadása vagy a polckészlet összeállítása a polckészlet neve. Például, `Gated_2016-06-06_05.20.51.4369;username@live.com` vagy `myshelveset;username@live.com`. Megjegyzés: A TFVC-ben, ha kapus bejelentkezési buildet futtat, vagy manuálisan készít egy polckészletet, nem használhatja ezt a változót a buildszámformátumában.
Build.SourcesDirectory	Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: `c:\agent_work\1\s` Alapértelmezés szerint az új buildelési folyamatok csak a módosított fájlokat frissítik. Az Adattár lapon módosíthatja a fájlok letöltési módját. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. Ez a változó a Build.Repository.LocalPath szinonimája.
Build.SourceVersion	A buildben szereplő legújabb verziókövetési módosítás. Git: A véglegesítés azonosítója. TFVC: a változáskészlet. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.SourceVersionMessage	A véglegesítés vagy a módosításkészlet megjegyzése. Az üzenetet az első sorra vagy 200 karakterre csonkítjuk, attól függően, hogy melyik rövidebb. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. Megjegyzés: Ez a változó a TFS 2015.4-ben érhető el. Megjegyzés: A Build.SourceVersionMessage változó nem működik a Bitbucket-adattárak klasszikus buildfolyamataival, amikor a Batch megváltozik, miközben a build engedélyezve van .
Build.StagingDirectory	Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: `c:\agent_work\1\a` A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Tekintse meg az Azure Pipelines összetevőit. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.Repository.Git.SubmoduleCheckout	A Pénztár almodulokhoz kiválasztott érték az adattár lapon. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.SourceTfvcShelveset	Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. Ha egy zárt vagy egy polckészlet-buildet futtat, akkor ez az építendő polckészlet nevére van állítva. Megjegyzés: Ez a változó olyan értéket ad, amely a buildszámformátumban való buildhasználathoz érvénytelen.
Build.TriggerBy.BuildId	Ha a buildet egy másik build aktiválta, akkor ez a változó az eseményindító build BuildID azonosítójára van állítva. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.TriggerBy.DefinitionId	Ha a buildet egy másik build aktiválta, akkor ez a változó az eseményindító build DefinitionID azonosítójára van állítva. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.TriggerBy.DefinitionName	Ha a buildet egy másik build aktiválta, akkor ez a változó az eseményindító buildelési folyamat nevére van állítva. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.TriggerBy.BuildNumber	Ha a buildet egy másik build aktiválta, akkor ez a változó az eseményindító build számára van állítva. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Build.TriggerBy.ProjectID	Ha a buildet egy másik build aktiválta, akkor ez a változó az eseményindító buildet tartalmazó projekt azonosítójára van állítva. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
Common.TestResultsDirectory	Annak az ügynöknek a helyi elérési útja, ahol a teszteredmények létrejönnek. Például: `c:\agent_work\1\TestResults` Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.

Rendszerváltozók (DevOps Server 2019)

Példa PowerShell-szkriptre: hozzáférés a REST API-hoz

Változó	Leírás
System.AccessToken	Az OAuth-jogkivonat használatával érheti el a REST API-t. Használja a System.AccessTokent YAML-szkriptekből. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
System.CollectionId	A TFS-gyűjtemény vagy az Azure DevOps-szervezet GUID azonosítója
System.DefaultWorkingDirectory	Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: `c:\agent_work\1\s` Az ügynökkönyvtár struktúrájáról további információt Ügynökkönyvtár-struktúracímű témakörben talál. A saját üzemeltetésű ügynökök esetében az új buildfolyamatok alapértelmezés szerint csak a módosított fájlokat frissítik. Az Adattár lapon módosíthatja a fájlok letöltési módját. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként.
System.DefinitionId	A buildelési folyamat azonosítója.
System.HostType	Állítsa be, hogy `build` a folyamat build-e. Kiadás esetén az értékek `deployment` egy üzembe helyezési csoportfeladat és `release` egy ügynökfeladat értékei.
System.PullRequest.IsFork	Ha a lekéréses kérelem az adattár egy elágazásából származik, ez a változó a következőre `True`van állítva: . Ellenkező esetben a beállítás értéke .`False`
System.PullRequest.PullRequestId	A buildet okozó lekéréses kérelem azonosítója. Például: `17` (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR.)
System.PullRequest.PullRequestNumber	A buildet okozó lekéréses kérelem száma. Ez a változó a GitHubról érkező lekéréses kérelmekhez van feltöltve, amelyek eltérő lekéréses kérelmek azonosítójával és lekéréses kérelmek számmal rendelkeznek.
System.PullRequest.SourceBranch	A lekéréses kérelemben áttekintett ág. Például: `refs/heads/users/raisa/new-feature` (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR.)
System.PullRequest.SourceCommitId	A lekéréses kérelemben áttekintett véglegesítés. (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR.)
System.PullRequest.SourceRepositoryURI	A lekéréses kérelmet tartalmazó adattár URL-címe. Például: `https://dev.azure.com/ouraccount/_git/OurProject` (Ez a változó csak akkor inicializálódik, ha a build egy Egy ágszabályzat által érintett Azure Repos Git PR. Nem inicializálva a GitHub PRS-ekhez.)
System.PullRequest.TargetBranch	A lekéréses kérelem céljaként megadott ág. Például: `refs/heads/main` Ez a változó csak akkor inicializálódik, ha a build egy ágszabályzat által érintett Git PR miatt futott.
System.TeamFoundationCollectionUri	A csapatalapítási gyűjtemény URI-ja. Például: `https://dev.azure.com/fabrikamfiber/` Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.
System.TeamProject	A buildet tartalmazó projekt neve.
System.TeamProjectId	Annak a projektnek az azonosítója, amelyhez ez a build tartozik.
TF_BUILD	Állítsa be, `True` hogy a szkriptet buildelési feladat futtatja-e. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként.

Hogyan vannak beállítva az identitásváltozók?

Az érték attól függ, hogy mi okozta a buildet, és az Azure-adattárakra jellemző.

Ha a build aktiválódik...	Ezután a Build.QueuedBy és a Build.QueuedById értékek...	Ezután a Build.RequestedFor és a Build.RequestedForId értékek...
A Gitben vagy a folyamatos integrációs (CI) eseményindítókon	A rendszer identitása, például: `[DefaultCollection]\Project Collection Service Accounts`	Az a személy, aki leküldte vagy beadta a módosításokat.
Gitben vagy ágszabályzat-buildben.	A rendszer identitása, például: `[DefaultCollection]\Project Collection Service Accounts`	Az a személy, aki bejelentkezett a módosításokba.
TFVC-ben egy kapus bejelentkezési eseményindítóval	Az a személy, aki bejelentkezett a módosításokba.	Az a személy, aki bejelentkezett a módosításokba.
Gitben vagy TFVC-ben az ütemezett eseményindítók	A rendszer identitása, például: `[DefaultCollection]\Project Collection Service Accounts`	A rendszer identitása, például: `[DefaultCollection]\Project Collection Service Accounts`
Mert a Várólista összeállítása gombra kattintott	Ön	Ön

Kérje meg a Copilot, hogy hozzon létre egy változó értékeken alapuló feltételt tartalmazó szakaszt

A Copilot használatával hozzon létre egy szakaszt egy változó értéke által meghatározott feltétellel.

Ez a példakérés egy olyan szakaszt határoz meg, amely akkor fut, amikor Agent.JobStatus azt jelzi, hogy az előző szakasz sikeresen futott:

Hozzon létre egy új Azure DevOps-szakaszt, amely csak akkor fut, ha Agent.JobStatusSucceeded vagy SucceededWithIssues.

Testre szabhatja a kérést, hogy a követelményeknek megfelelő értékeket használjon. Kérhet például segítséget egy olyan szakasz létrehozásához, amely csak akkor fut, ha egy folyamat meghibásodik.

Feljegyzés

A GitHub Copilot mesterséges intelligenciával működik, így meglepetések és hibák lehetségesek. Ellenőrizze a létrehozott kódot vagy javaslatokat. A GitHub Copilot általános használatáról, a termék hatásáról, az emberi felügyeletről és az adatvédelemről további információt a GitHub Copilot gyakori kérdések .

Megosztás a következőn keresztül:

Előre definiált változók használata

Build.Clean

System.AccessToken

System.Debug

Ügynökváltozók (DevOps Services)

Változók létrehozása (DevOps Services)

Folyamatváltozók

Üzembehelyezési feladat változói

Rendszerváltozók

Változók ellenőrzése (DevOps Services)

Ügynökváltozók (DevOps Server 2022)

Változók összeállítása (DevOps Server 2022)

Folyamatváltozók (DevOps Server 2022)

Üzembehelyezési feladat változói (DevOps Server 2022)

Rendszerváltozók (DevOps Server 2022)

Változók ellenőrzése (DevOps Server 2022)

Ügynökváltozók (DevOps Server 2020)

Változók összeállítása (DevOps Server 2020)

Folyamatváltozók (DevOps Server 2020)

Üzembehelyezési feladat változói (DevOps Server 2020)

Rendszerváltozók (DevOps Server 2020)

Ügynökváltozók (DevOps Server 2019)

Változók összeállítása (DevOps Server 2019)

Rendszerváltozók (DevOps Server 2019)

Hogyan vannak beállítva az identitásváltozók?

Kérje meg a Copilot, hogy hozzon létre egy változó értékeken alapuló feltételt tartalmazó szakaszt

Visszajelzés

További források