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

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

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

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.

Klasszikus

Engedélyezheti a szkriptek és feladatok számára a System.AccessToken elérését a feladat szintjén.

1. Ugrás a feladatra

2. A További beállítások csoportban jelölje be az OAuth-jogkivonat elérésének engedélyezése szkriptek számára jelölőnégyzetet.

Ha bejelöli ezt a jelölőnégyzetet, a hitelesítőadat-készletet is a Gitben hagyja, így leküldéseket és lekéréseket futtathat a szkriptekben.

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: .

1. Szerkessze a folyamatot.

2. Válassza a Változók lehetőséget.

3. Adjon hozzá egy új változót a névvel System.Debug és az értékkel true.

   

4. 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_JOBSTATUSa 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)/sa . 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.	Igen
Build.Repository.Name	Az eseményindító adattár neve.	Igen
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, 8a 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ó nem használható a buildszám részeként vagy verziókövetési címkeként.	Igen
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/toolsez az érték tools. A refs/tags/your-tag-nameaz é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)/smé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.StageRequestedBy	Az a személy, aki a szakasz manuális futtatásakor aktiválta a szakaszt, vagy Microsoft.VisualStudio.Services.TFS más módon. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert.	Nem
Build.StageRequestedForId	A szakaszt manuálisan vagy 00000002-0000-8888-8000-000000000000 más módon aktiváló személy identitásának GUID azonosítója.	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 resourcesaktivá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 resourcesaktivá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 resourcesaktivá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 resourcesaktivá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 resourcesaktivá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, runOncevagy rolling.
Strategy.CycleName	Az üzemelő példány aktuális ciklusneve. A beállítások a következők PreIteration: , Iterationvagy PostIteration.

Rendszerváltozók

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?
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 Truevan állítva: . Ellenkező esetben a következőre Falsevan á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.

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 .