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

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.ArtifactStagingDirectory BUILD_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.

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:

steps:
  - script: |
      echo "Using System.AccessToken to authenticate"
      git clone https://$(System.AccessToken)@dev.azure.com/yourorganization/yourproject/_git/yourrepository
    displayName: 'Clone repository using System.AccessToken'
    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.

true Az összes futtatás részletes naplóinak konfigurálására szolgáló beállításSystem.Debug. 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.Debug true .

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
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 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", de többkonfigurációs forgatókönyvekben 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_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, akkor ezt a nevet Ön adja meg. Ü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)

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 nincs 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. Ez a változó ügynök hatókörű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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. 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ű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 a folyamatfuttatást YAML ütemezett eseményindító aktiválja. 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 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 ResourceTrigger: A buildet egy erőforrás-eseményindító aktiválta, vagy egy másik build aktiválta. Lásd: Build pipeline triggers, Improve code quality with branch policies.	Igen
Build.Repository.Clean	A forrásadattár beállításaiban a Tiszta érték. Ez a változó ügynök hatókörű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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)/sa . Ha az önkiszolgáló (elsődleges) adattár kivételi lépése rendelkezik definiált egyéni kivételi útvonalsal (és ez nem a több kivételes alapértelmezett elérési útja), ez a változó pontosan tartalmazza az öntárház elérési útját. Ez a változó ügynök hatókörű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 akkor sem változik, ha az adattár neve igen. Ez a változó ügynök hatókörű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 Ha a folyamatot egy címke aktiválja: 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. 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 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 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)/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 használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 a szakasz szintjén (vagyis az üzenet csak a feladat kezdetéig és a kód kivételéig lesz kinyerve). 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 .	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 használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem a buildszám részeként vagy verziókövetési címkeként.	Nem
Build.Repository.Git.SubmoduleCheckout	A Pénztár almodulokhoz kiválasztott érték az adattár lapon. 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 használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 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.	Nem
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. A klasszikus folyamatokban ezt a változót egy buildkiegészítési eseményindító aktiválja. Ez a változó ügynök hatókörű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 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. A klasszikus folyamatokban ezt a változót egy buildkiegészítési eseményindító aktiválja. Ez a változó ügynök hatókörű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 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. A klasszikus folyamatokban ezt a változót egy buildkiegészítési eseményindító aktiválja. Ez a változó ügynök hatókörű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 a buildet egy másik build aktiválta, akkor ez a változó az eseményindító build számára van állítva. A klasszikus folyamatokban ezt a változót egy buildkiegészítési eseményindító aktiválja. Ez a változó ügynök hatókörű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 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. A klasszikus folyamatokban ezt a változót egy buildkiegészítési eseményindító aktiválja. Ez a változó ügynök hatókörű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 Ez a változó ügynök hatókörű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem a buildszám részeként vagy verziókövetési címkeként.	Nem

Folyamatváltozók (DevOps Services)

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.

Tipp.

Ha klasszikus kiadási folyamatokat használ, a klasszikus kiadási és összetevő-változók használatával az adatokat a folyamat teljes területén tárolhatja és érheti el.

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

Ezek a változók egy adott üzembehelyezési feladat hatókörébe tartoznak, és csak a feladat végrehajtásakor lesznek feloldva.

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. Ez például egy Kubernetes-névtér, bookings amely erőforrásként lett 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 (DevOps Services)

Ha olyan sablonban használ változót, amely nincs 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 használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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	A TFS-gyűjtemény vagy az Azure DevOps-szervezet 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 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.	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" fogalmát többnyire eltávolítottuk az Azure Pipelinesból. A mátrix- és többkonfigurációs feladatok az egyetlen hely, ahol a "fázis" továbbra is eltér a "feladattó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 a lekéréses kérelmet egy ágházirend befolyásolja.	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 a lekéréses kérelmet egy ágházirend befolyásolja.	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 a lekéréses kérelmet egy ágházirend befolyásolja.
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 a lekéréses kérelmet egy ágházirend befolyásolja.	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	A TFS-gyűjtemény vagy az Azure DevOps-szervezet URI-ja. Például: https://dev.azure.com/fabrikamfiber/ Ez a változó ügynök hatókörű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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 be, True hogy a szkriptet buildelési feladat futtatja-e. Ez a változó ügynök hatókörű, és használható környezeti változóként egy szkriptben és egy buildelési feladat paramétereként, de nem 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