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


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

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

  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.

    A rendszer hibakeresésének beállítása igaz értékre

  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.

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

Adja hozzá a szakaszkísérletet paraméterként.

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

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, é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_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 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)

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 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)/sa .
  • 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.
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, 8akkor 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: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/mainpéldául ez az érték main. A refs/heads/feature/toolsez az érték tools. A refs/tags/your-tag-nameez 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/mainpé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)/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).

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

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

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

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

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

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, 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 Server 2022)

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.

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 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.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.
Adja hozzá a szakaszkísérletet paraméterként.

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

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.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_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 á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/&lt;RepoName&gt; , 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 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.
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, 8akkor 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:
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/toolsez az érték tools. A refs/tags/your-tag-nameez 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)/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.
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 Truevan á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

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. 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_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 á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.
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, 8akkor 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:
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.
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 Truevan á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 .