Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
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 Copilot kérhet segítséget. További információ: Ask Copilot változó értékeken alapuló feltételt tartalmazó szakasz létrehozásához.
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: .
Szerkessze a folyamatot.
Válassza a Változók lehetőséget.
Adjon hozzá egy új változót a névvel
System.Debugés az értékkeltrue.
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.
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:
|
| Agent.OSArchitecture | Az ügynök gazdagépének operációsrendszer-processzorarchitektúrája. Az érvényes értékek a következők:
|
| Agent.TempDirectory | Az egyes folyamatfeladatok után megtisztított ideiglenes mappa. Ezt a könyvtárat olyan tevékenységek használják, mint a .NET alapvető parancssori felületi tevékenység az ideiglenes elemek, például a teszteredmények tárolására a közzététel előtt. Például: /home/vsts/work/_temp Ubuntu esetén. |
| Agent.ToolsDirectory | A Node Tool Installer és A Python verzió által használt könyvtár 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_workMegjegyzé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\aA 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. Lásd: Artifacts in Azure Pipelines. 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/1430Ez 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.
|
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\sA 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):
|
Nem |
| Build.Repository.ID | Az adattár egyedi azonosítója. Ez az érték akkor sem változik, ha az adattár neve igen. |
Igen |
| Build.Repository.Name | Az eseményindító adattár neve. | Igen |
| Build.Repository.Provider | Az eseményindító adattár típusa.
|
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_8Ez 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ó nem használható a buildszám részeként vagy verziókövetési címkeként. |
Igen |
| Build.RequestedFor | Lásd Hogyan vannak beállítva az identitásváltozók?. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul. |
Igen |
| Build.RequestedForEmail | Lásd Hogyan vannak beállítva az identitásváltozók?. | Igen |
| Build.RequestedForId | Lásd Hogyan vannak beállítva az identitásváltozók?. | Igen |
| Build.SourceBranch | A buildet aktiváló adattár ága várólistára került. Néhány példa:
/) 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.
|
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\sA 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.
|
Igen |
| Build.SourceVersionMessage | Az eseményindító adattár véglegesítésének vagy változáskészletének megjegyzése. Az üzenetet az első sorra vagy 200 karakterre csonkítjuk, attól függően, hogy melyik rövidebb. A Build.SourceVersionMessage véglegesítéskor Build.SourceVersion megjelenő üzenetnek felel meg. A Build.SourceVersion pr-buildek véglegesítése az egyesítési véglegesítés (nem a forráság véglegesítése).Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Emellett ez a változó csak a lépés szintjén érhető el, és nem érhető el a feladat- vagy szakaszszinteken. Vagyis az üzenet nem lesz kinyerve, amíg a feladat el nem indul, és a kód ki van véve. Megjegyzés: A Build.SourceVersionMessage változó nem működik a Bitbucket-adattárak klasszikus buildelési folyamataival, ha Batch-módosításokat végez, miközben a buildelés folyamatban van, engedélyezve van. |
Nem |
| Build.StageRequestedBy | Az a személy, aki a szakasz manuális futtatásakor aktiválta a szakaszt, vagy máskülönben Microsoft.VisualStudio.Services.TFS. Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. |
Nem |
| Build.StageRequestedForId | A szakaszt manuálisan vagy 00000002-0000-8888-8000-000000000000 más módon aktiváló személy identitásának GUID azonosítója. |
Nem |
| Build.StagingDirectory | Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: c:\agent_work\1\a Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Lásd: Artifacts in Azure Pipelines. 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 | A Azure DevOps szervezet vagy gyűjtemény GUID azonosítója. | Igen |
| System.CollectionUri | A 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 az OpenID Connect (OIDC) használatával történő Entra ID hitelesítéshez.
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 phase fogalma többnyire el van távolítva a Azure Pipelines. 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ó olyan GitHub lekéréses kérelmeihez van feltöltve, amelyek eltérő lekéréses kérelemazonosító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 Repos. (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: refs/heads/main, ha az adattár Azure Repos és main, amikor az adattár GitHub 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 | A Azure DevOps szervezet vagy gyűjtemény URI-ja. Például: https://dev.azure.com/fabrikamfiber/Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Igen |
| System.TeamProject | A buildet tartalmazó projekt neve. | Igen |
| System.TeamProjectId | Annak a projektnek az azonosítója, amelyhez ez a build tartozik. | Igen |
| System.TimelineId | Sztringalapú azonosító egyetlen folyamatfuttatás végrehajtási részleteihez és naplóihoz. | Nem |
| TF_BUILD | Állítsa True, ha egy buildelési feladat futtatja a szkriptet.Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Változók ellenőrzése (DevOps Services)
| Változó | Leírás |
|---|---|
| Checks.StageAttempt | Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekményes, amikor a szakasz újrapróbálkozott. Ez a változó csak jóváhagyás vagy környezet ellenőrzése során használható. Használhatja például $(Checks.StageAttempt) egy REST API-ellenőrzés meghívása során.
|
Ügynökváltozók (Azure DevOps Server)
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.
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:
|
| Agent.OSArchitecture | Az ügynök gazdagépének operációsrendszer-processzorarchitektúrája. Az érvényes értékek a következők:
|
| Agent.TempDirectory | Az egyes folyamatfeladatok után megtisztított ideiglenes mappa. Ezt a könyvtárat olyan tevékenységek használják, mint a .NET alapvető parancssori felületi tevékenység az ideiglenes elemek, például a teszteredmények tárolására a közzététel előtt. Például: /home/vsts/work/_temp Ubuntu esetén. |
| Agent.ToolsDirectory | A Node Tool Installer és A Python verzió által használt könyvtár 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_workMegjegyzé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 (Azure DevOps Server)
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. Lásd: Artifacts in Azure Pipelines. 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ó a 2022.1-Azure DevOps Server és újabb verziókban é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.
|
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):
|
Nem |
| Build.Repository.ID | Az adattár egyedi azonosítója. | Igen |
| Build.Repository.Name | Az eseményindító adattár neve. | Igen |
| Build.Repository.Provider | Az eseményindító adattár típusa.
|
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:Ez a változó nem használható a buildszám részeként vagy verziókövetési címkeként. | Igen |
| Build.RequestedFor | Lásd: "Hogyan vannak beállítva az identitásváltozók?". Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul. |
Igen |
| Build.RequestedForEmail | Lásd: "Hogyan vannak beállítva az identitásváltozók?". | Igen |
| Build.RequestedForId | Lásd: "Hogyan vannak beállítva az identitásváltozók?". | Igen |
| Build.SourceBranch | A buildet aktiváló adattár ága várólistára került. Néhány példa:
/) 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.
|
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.
|
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. Lásd: Artifacts in Azure Pipelines. 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 (Azure DevOps Server)
| 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 (Azure DevOps Server)
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 (Azure DevOps Server)
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 | A Azure DevOps szervezet vagy gyűjtemény GUID azonosítója. | Igen |
| System.CollectionUri | A 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 fogalmát többnyire eltávolítják a Azure Pipelines. 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ó olyan GitHub lekéréses kérelmeihez van feltöltve, amelyek eltérő lekéréses kérelemazonosító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 Repos. (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: refs/heads/main, ha az adattár Azure Repos és main, amikor az adattár GitHub 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 | A 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 (Azure DevOps Server)
| Változó | Leírás |
|---|---|
| Checks.StageAttempt | Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekményes, amikor a szakasz újrapróbálkozott. Ez a változó csak jóváhagyás vagy környezet ellenőrzése során használható. Használhatja például $(Checks.StageAttempt) egy REST API-ellenőrzés meghívása során.
|
Ügynökváltozók (2022-Azure DevOps Server)
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.
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:
|
| Agent.OSArchitecture | Az ügynök gazdagépének operációsrendszer-processzorarchitektúrája. Az érvényes értékek a következők:
|
| Agent.TempDirectory | Az egyes folyamatfeladatok után megtisztított ideiglenes mappa. Ezt a könyvtárat olyan tevékenységek használják, mint a .NET alapvető parancssori felületi tevékenység az ideiglenes elemek, például a teszteredmények tárolására a közzététel előtt. Például: /home/vsts/work/_temp Ubuntu esetén. |
| Agent.ToolsDirectory | A Node Tool Installer és A Python verzió által használt könyvtár 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_workMegjegyzé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 (Azure 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. Lásd: Artifacts in Azure Pipelines. 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ó a 2022.1-Azure DevOps Server és újabb verziókban é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.
|
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):
|
Nem |
| Build.Repository.ID | Az adattár egyedi azonosítója. | Igen |
| Build.Repository.Name | Az eseményindító adattár neve. | Igen |
| Build.Repository.Provider | Az eseményindító adattár típusa.
|
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:Ez a változó nem használható a buildszám részeként vagy verziókövetési címkeként. | Igen |
| Build.RequestedFor | Lásd: "Hogyan vannak beállítva az identitásváltozók?". Megjegyzés: Ez az érték tartalmazhat szóközt vagy más érvénytelen címkekaraktert. Ezekben az esetekben a címke formátuma meghiúsul. |
Igen |
| Build.RequestedForEmail | Lásd: "Hogyan vannak beállítva az identitásváltozók?". | Igen |
| Build.RequestedForId | Lásd: "Hogyan vannak beállítva az identitásváltozók?". | Igen |
| Build.SourceBranch | A buildet aktiváló adattár ága várólistára került. Néhány példa:
/) 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.
|
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.
|
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. Lásd: Artifacts in Azure Pipelines. 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 (2022-Azure DevOps Server)
| 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 (Azure 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 (Azure 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 | A Azure DevOps szervezet vagy gyűjtemény GUID azonosítója. | Igen |
| System.CollectionUri | A 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 fogalmát többnyire eltávolítják a Azure Pipelines. 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ó olyan GitHub lekéréses kérelmeihez van feltöltve, amelyek eltérő lekéréses kérelemazonosító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 Repos. (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: refs/heads/main, ha az adattár Azure Repos és main, amikor az adattár GitHub 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 | A 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 (2022-Azure DevOps Server)
| Változó | Leírás |
|---|---|
| Checks.StageAttempt | Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekményes, amikor a szakasz újrapróbálkozott. Ez a változó csak jóváhagyás vagy környezet ellenőrzése során használható. Használhatja például $(Checks.StageAttempt) egy REST API-ellenőrzés meghívása során.
|
Hogyan vannak beállítva az identitásváltozók?
Az érték attól függ, hogy mi okozta a buildet, és Azure Repos 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 |
Ask Copilot változó értékeken alapuló feltétellel rendelkező szakasz létrehozásához
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.JobStatusSucceededvagySucceededWithIssues.
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
GitHub Copilot mesterséges intelligencián alapuló, így meglepetések és hibák is lehetségesek. Ellenőrizze a létrehozott kódot vagy javaslatokat. A GitHub Copilot általános használatáról, a termékek 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 című témakörben talál.