Előre definiált változók használata
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
A változók segítségével kényelmesen lekérheti a kulcsbiteket a folyamat különböző részeibe. Ez az elérhető előre megadott változók listája. Lehetnek más előre definiált változók is, de ezek többnyire belső használatra készültek.
Ezeket a változókat a rendszer automatikusan beállítja, és írásvédett. (A kivételek a Build.Clean és a System.Debug.)
A YAML-folyamatokban az előre definiált változókra környezeti változóként hivatkozhat. A változó például a változó Build.ArtifactStagingDirectory
BUILD_ARTIFACTSTAGINGDIRECTORY
lesz.
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.AccessToken
haszná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.Debug
true
.
variables:
system.debug: 'true'
Ha System.Debug
be van állítva true
, a rendszer egy további névvel ellátott Agent.Diagnostic
változót true
állít be. Ha Agent.Diagnostic
igen true
, az ügynök további naplókat gyűjt, amelyek a saját üzemeltetésű ügynökök hálózati problémáinak elhárítására használhatók. További információért lásd: Helyi ügynökök hálózati diagnosztikája.
Feljegyzés
A Agent.Diagnostic
változó a 2.200.0-s és újabb ügynökkel érhető el.
További információ: Naplók áttekintése a folyamatproblémák diagnosztizálásához.
Ügynökváltozók (DevOps Services)
Feljegyzés
Az ügynökváltozókat környezeti változókként használhatja a szkriptekben és paraméterekként a buildelési feladatokban. Nem használhatja őket a buildszám testreszabására, illetve verziókövetési címke vagy címke alkalmazására.
Változó | Leírás |
---|---|
Agent.BuildDirectory | Az ügynök helyi elérési útja, ahol egy adott buildfolyamat összes mappája létrejön. Ez a változó ugyanazzal az értékkel rendelkezik, mint a Pipeline.Workspace . Például: /home/vsts/work/1 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_JOBSTATUS a következőként kell hivatkozni: . A régebbi agent.jobstatus verzió a visszamenőleges kompatibilitás érdekében érhető el. |
Agent.MachineName | Annak a gépnek a neve, amelyre az ügynök telepítve van. |
Agent.Name | A készletben regisztrált ügynök neve. Ha saját üzemeltetésű ügynököt használ, adja meg a nevet. Ügynökök megtekintése. |
Agent.OS | Az ügynök gazdagépének operációs rendszere. Az érvényes értékek a következők:
|
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 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.
|
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):
|
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.
|
Nem |
Build.Repository.Tfvc.Workspace | Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. A buildügynök által használt TFVC-munkaterület neve. Ha például az Agent.BuildDirectory az c:\agent_work\12 , és a Agent.Id, 8 a munkaterület neve a következő lehet: ws_12_8 Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.Repository.Uri | Az eseményindító adattár URL-címe. Példa: 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:
/ ) 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 A saját üzemeltetésű ügynökök esetében az új buildelési folyamatok csak a módosított fájlokat frissítik. Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. Fontos megjegyzés: Ha csak egy Git-adattárat tekint meg, ez az elérési út a kód pontos elérési útja. Ha több adattárat is kivesz, az visszaáll az alapértelmezett értékre, vagyis $(Pipeline.Workspace)/s még akkor is, ha az önkiszolgáló (elsődleges) adattárat a rendszer a több kivételes alapértelmezett elérési úttól $(Pipeline.Workspace)/s/<RepoName> eltérő egyéni elérési útra irányítja (ebben a tekintetben a változó eltér a Build.Repository.LocalPath változó viselkedésétől).Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.SourceVersion | A buildben található triggerelő adattár legújabb verziókövetési módosítása.
|
Igen |
Build.SourceVersionMessage | Az eseményindító adattár véglegesítésének vagy változáskészletének megjegyzése. Az üzenetet az első sorra vagy 200 karakterre csonkítjuk, attól függően, hogy melyik rövidebb. A Build.SourceVersionMessage véglegesítéskor Build.SourceVersion megjelenő üzenetnek felel meg. A Build.SourceVersion pr-buildek véglegesítése az egyesítési véglegesítés (nem a forráság véglegesítése).Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Emellett ez a változó csak a lépés szintjén érhető el, és nem érhető el a feladat- vagy szakaszszinteken. Vagyis az üzenet nem lesz kinyerve, amíg a feladat el nem indul, és a kód ki van véve. Megjegyzés: A Build.SourceVersionMessage változó nem működik a Bitbucket-adattárak klasszikus buildelési folyamataival, ha Batch-módosításokat végez, miközben a buildelés folyamatban van, engedélyezve van. |
Nem |
Build.StagingDirectory | Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: c:\agent_work\1\a Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Tekintse meg az Azure Pipelines összetevőit. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.Repository.Git.SubmoduleCheckout | A Kivétel almodulok kiválasztott érték az adattár lapján. Ha több adattárat is kivett, ez az érték nyomon követi az eseményindító adattár beállításait. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.SourceTfvcShelveset | Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. Ha kapus buildelési vagy polckészlet-összeállításifuttat, ez a változó az éppen létrehozott polckészlet nevére van állítva. Megjegyzés: Ez a változó olyan értéket ad, amely a buildszámformátumban való buildhasználathoz érvénytelen. |
Nem |
Build.TriggerBy.BuildId | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build BuildID azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot resources aktivál, használja inkább az erőforrásváltozókat . |
Nem |
Build.TriggerBy.DefinitionId | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build DefinitionID azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot resources aktivál, használja inkább az erőforrásváltozókat . |
Nem |
Build.TriggerBy.DefinitionName | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító buildfolyamat nevére van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot resources aktivál, használja inkább az erőforrásváltozókat . |
Nem |
Build.TriggerBy.BuildNumber | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build számára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot resources aktivál, használja inkább az erőforrásváltozókat . |
Nem |
Build.TriggerBy.ProjectID | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító buildet tartalmazó projekt azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot resources aktivál, használja inkább az erőforrásváltozókat . |
Nem |
Common.TestResultsDirectory | Annak az ügynöknek a helyi elérési útja, ahol a teszteredmények létrejönnek. Például: c:\agent_work\1\TestResults Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Folyamatváltozók
Változó | Leírás |
---|---|
Pipeline.Workspace | Egy adott folyamat munkaterületi címtára. Ez a változó ugyanazzal az értékkel rendelkezik, mint a Agent.BuildDirectory . Például: /home/vsts/work/1 . Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. |
Tipp.
Ha klasszikus kiadási folyamatokat használ, klasszikus kiadások és összetevők változói az adatok tárolására és elérésére a folyamat teljes területén.
Üzembehelyezési feladat változói
Ezek a változók egy adott üzembehelyezési feladatra vonatkoznak, és csak a feladat végrehajtásakor oldódnak fel.
Változó | Leírás |
---|---|
Environment.Name | Az üzembe helyezési feladatban megcélzott környezet neve az üzembe helyezési lépések futtatásához és az üzembe helyezési előzmények rögzítéséhez. Például: smarthotel-dev . |
Environment.Id | Az üzembe helyezési feladatban megcélzott környezet azonosítója. Például: 10 . |
Environment.ResourceName | Az üzembe helyezési lépések futtatásához és az üzembe helyezési előzmények rögzítéséhez az üzembe helyezési feladatban megcélzott környezetben lévő adott erőforrás neve. Például bookings , amely egy Kubernetes-névtér, amely erőforrásként van hozzáadva a környezethez smarthotel-dev . |
Environment.ResourceId | Az üzembe helyezési lépések futtatásához az üzembe helyezési feladatban megcélzott környezetben lévő adott erőforrás azonosítója. Például: 4 . |
Strategy.Name | Az üzembehelyezési stratégia neve: canary , runOnce vagy rolling . |
Strategy.CycleName | Az üzemelő példány aktuális ciklusneve. A beállítások a következők PreIteration : , Iteration vagy PostIteration . |
Rendszerváltozók
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 True van állítva: .Ellenkező esetben a következőre False van állítva: . |
Igen |
System.PullRequest.PullRequestId | A buildet okozó lekéréses kérelem azonosítója. Például: 17 (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). |
Nem |
System.PullRequest.PullRequestNumber | A buildet okozó lekéréses kérelem száma. Ez a változó a GitHubról érkező lekéréses kérelmekhez van feltöltve, amelyek eltérő lekéréses kérelmek azonosítójával és lekéréses kérelmek számmal rendelkeznek. Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre. | Nem |
System.PullRequest.targetBranchName | A lekéréses kérelem célágának neve. Ez a változó egy folyamatban a lekéréses kérelem célága alapján feltételesen hajthat végre feladatokat vagy lépéseket. Előfordulhat például, hogy a módosításokat egyesítő ágtól függően más teszteket vagy kódelemzési eszközöket szeretne aktiválni. | Nem |
System.PullRequest.SourceBranch | A lekéréses kérelemben áttekintett ág. Például: refs/heads/users/raisa/new-feature Azure-adattárak esetén. (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre. |
Nem |
System.PullRequest.SourceCommitId | A lekéréses kérelemben áttekintett véglegesítés. (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre. | |
System.PullRequest.SourceRepositoryURI | A lekéréses kérelmet tartalmazó adattár URL-címe. Például: https://dev.azure.com/ouraccount/_git/OurProject |
Nem |
System.PullRequest.TargetBranch | A lekéréses kérelem céljaként megadott ág. Például ha refs/heads/main az adattár az Azure-adattárban van, és main amikor az adattár a GitHubon található. Ez a változó csak akkor inicializálódik, ha a build egy ágszabályzat által érintett Git PR miatt futott. Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre. |
Nem |
System.StageAttempt | Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekményes, amikor a szakasz újrapróbálkozott. | Nem |
System.StageDisplayName | Az ember által olvasható név, amit egy szakasznak adtak. | Nem |
System.StageName | Egy szakasz sztringalapú azonosítója, amely általában függőségek kifejezésére és kimeneti változók elérésére szolgál. | Nem |
System.TeamFoundationCollectionUri | Az Azure DevOps-szervezet vagy -gyűjtemény URI-ja. Például: https://dev.azure.com/fabrikamfiber/ Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Igen |
System.TeamProject | A buildet tartalmazó projekt neve. | Igen |
System.TeamProjectId | Annak a projektnek az azonosítója, amelyhez ez a build tartozik. | Igen |
System.TimelineId | Sztringalapú azonosító egyetlen folyamatfuttatás végrehajtási részleteihez és naplóihoz. | Nem |
TF_BUILD | Állítsa True , ha egy buildelési feladat futtatja a szkriptet.Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Változók ellenőrzése (DevOps Services)
Változó | Leírás |
---|---|
Checks.StageAttempt | Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekményes, amikor a szakasz újrapróbálkozott. Ez a változó csak jóváhagyás vagy környezet ellenőrzése során használható. Használhatja például $(Checks.StageAttempt) egy REST API-ellenőrzés meghívása során.![]() |
Ügynökváltozók (DevOps Server 2022)
Feljegyzés
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_JOBSTATUS a következőként kell hivatkozni: . A régebbi agent.jobstatus verzió a visszamenőleges kompatibilitás érdekében érhető el. |
Agent.MachineName | Annak a gépnek a neve, amelyre az ügynök telepítve van. |
Agent.Name | A készletben regisztrált ügynök neve. Ha saját üzemeltetésű ügynököt használ, akkor ez az érték a megadott név. Ügynökök megtekintése. |
Agent.OS | Az ügynök gazdagépének operációs rendszere. Az érvényes értékek a következők:
|
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 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.
|
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. 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.
|
Nem |
Build.Repository.Tfvc.Workspace | Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. A buildügynök által használt TFVC-munkaterület neve. Ha például az Agent.BuildDirectory az c:\agent_work\12 , és a Agent.Id, 8 akkor a munkaterület neve a következő lehet: ws_12_8 .Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.Repository.Uri | Az eseményindító adattár URL-címe. Példa: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:
/ ) 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)/s még akkor is, ha az önkiszolgáló (elsődleges) adattárat a rendszer a több kivételes alapértelmezett elérési úttól $(Pipeline.Workspace)/s/<RepoName> eltérő egyéni elérési útra irányítja (ebben a tekintetben a változó eltér a Build.Repository.LocalPath változó viselkedésétől).Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.SourceVersion | A buildben található triggerelő adattár legújabb verziókövetési módosítása.
|
Igen |
Build.SourceVersionMessage | Az eseményindító adattár véglegesítésének vagy változáskészletének megjegyzése. Az üzenetet az első sorra vagy 200 karakterre csonkítjuk, attól függően, hogy melyik rövidebb. A Build.SourceVersionMessage véglegesítéskor Build.SourceVersion megjelenő üzenetnek felel meg. A Build.SourceVersion pr-buildek véglegesítése az egyesítési véglegesítés (nem a forráság véglegesítése). Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Emellett ez a változó csak a lépés szintjén érhető el. A feladat- vagy szakaszszintek nem érhetők el. Vagyis az üzenet nem lesz kinyerve, amíg a feladat el nem indul, és a kód ki van véve. >Megjegyzés: A Build.SourceVersionMessage változó nem működik a Bitbucket-adattárak klasszikus buildelési folyamataival, ha Batch-módosításokat végez, miközben a buildelés folyamatban van, engedélyezve van. |
Nem |
Build.StagingDirectory | Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: c:\agent_work\1\a Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Tekintse meg az Azure Pipelines összetevőit. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.Repository.Git.SubmoduleCheckout | A Kivétel almodulok a adattár lapján. Ha több adattárat is kivett, ez az érték nyomon követi az eseményindító adattár beállításait. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.SourceTfvcShelveset | Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. Ha kapus buildelési vagy polckészlet-összeállításifuttat, ez a változó az éppen létrehozott polckészlet nevére van állítva. Megjegyzés: Ez a változó olyan értéket ad, amely a buildszámformátumban való buildhasználathoz érvénytelen. |
Nem |
Build.TriggerBy.BuildId | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build BuildID azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot resources aktivál, használja inkább az erőforrásváltozókat . |
Nem |
Build.TriggerBy.DefinitionId | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build DefinitionID azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot resources aktivál, használja inkább az erőforrásváltozókat . |
Nem |
Build.TriggerBy.DefinitionName | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító buildfolyamat nevére van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot resources aktivál, használja inkább az erőforrásváltozókat . |
Nem |
Build.TriggerBy.BuildNumber | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build számára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot resources aktivál, használja inkább az erőforrásváltozókat . |
Nem |
Build.TriggerBy.ProjectID | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító buildet tartalmazó projekt azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Ha YAML-folyamatot resources aktivál, használja inkább az erőforrásváltozókat . |
Nem |
Common.TestResultsDirectory | Annak az ügynöknek a helyi elérési útja, ahol a teszteredmények létrejönnek. Például: c:\agent_work\1\TestResults Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Folyamatváltozók (DevOps Server 2022)
Változó | Leírás |
---|---|
Pipeline.Workspace | Egy adott folyamat munkaterületi címtára. Ez a változó ugyanazzal az értékkel rendelkezik, mint a Agent.BuildDirectory . Például: /home/vsts/work/1 . Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. |
Tipp.
Ha klasszikus kiadási folyamatokat használ, klasszikus kiadások és összetevők változói az adatok tárolására és elérésére a folyamat teljes területén.
Üzembehelyezési feladat változói (DevOps Server 2022)
Ezek a változók egy adott üzembehelyezési feladatra vonatkoznak, és csak a feladat végrehajtásakor oldódnak fel.
Változó | Leírás |
---|---|
Environment.Name | Az üzembe helyezési feladatban megcélzott környezet neve az üzembe helyezési lépések futtatásához és az üzembe helyezési előzmények rögzítéséhez. Például: smarthotel-dev . |
Environment.Id | Az üzembe helyezési feladatban megcélzott környezet azonosítója. Például: 10 . |
Environment.ResourceName | Az üzembe helyezési lépések futtatásához és az üzembe helyezési előzmények rögzítéséhez az üzembe helyezési feladatban megcélzott környezetben lévő adott erőforrás neve. Például bookings , amely egy Kubernetes-névtér, amely erőforrásként van hozzáadva a környezethez smarthotel-dev . |
Environment.ResourceId | Az üzembe helyezési lépések futtatásához az üzembe helyezési feladatban megcélzott környezetben lévő adott erőforrás azonosítója. Például: 4 . |
Strategy.Name | Az üzembehelyezési stratégia neve: canary , runOnce vagy rolling . |
Strategy.CycleName | Az üzemelő példány aktuális ciklusneve. A beállítások a következők PreIteration : , Iteration vagy PostIteration . |
Rendszerváltozók (DevOps Server 2022)
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 True van állítva: . Ellenkező esetben a következőre False van állítva: . |
Igen |
System.PullRequest.PullRequestId | A buildet okozó lekéréses kérelem azonosítója. Például: 17 (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). |
Nem |
System.PullRequest.PullRequestNumber | A buildet okozó lekéréses kérelem száma. Ez a változó a GitHubról érkező lekéréses kérelmekhez van feltöltve, amelyek eltérő lekéréses kérelmek azonosítójával és lekéréses kérelmek számmal rendelkeznek. Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre. | Nem |
System.PullRequest.targetBranchName | A lekéréses kérelem célágának neve. Ez a változó egy folyamatban a lekéréses kérelem célága alapján feltételesen hajthat végre feladatokat vagy lépéseket. Előfordulhat például, hogy a módosításokat egyesítő ágtól függően más teszteket vagy kódelemzési eszközöket szeretne aktiválni. | Nem |
System.PullRequest.SourceBranch | A lekéréses kérelemben áttekintett ág. Például: refs/heads/users/raisa/new-feature Azure-adattárak esetén. (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre. |
Nem |
System.PullRequest.SourceRepositoryURI | A lekéréses kérelmet tartalmazó adattár URL-címe. Például: https://dev.azure.com/ouraccount/_git/OurProject |
Nem |
System.PullRequest.TargetBranch | A lekéréses kérelem céljaként megadott ág. Például ha refs/heads/main az adattár az Azure-adattárban van, és main amikor az adattár a GitHubon található. Ez a változó csak akkor inicializálódik, ha a build egy ágszabályzat által érintett Git PR miatt futott. Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre. |
Nem |
System.StageAttempt | Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekményes, amikor a szakasz újrapróbálkozott. | Nem |
System.StageDisplayName | Az ember által olvasható név, amit egy szakasznak adtak. | Nem |
System.StageName | Egy szakasz sztringalapú azonosítója, amely általában függőségek kifejezésére és kimeneti változók elérésére szolgál. | Nem |
System.TeamFoundationCollectionUri | Az Azure DevOps-szervezet vagy -gyűjtemény URI-ja. Például: https://dev.azure.com/fabrikamfiber/ Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Igen |
System.TeamProject | A buildet tartalmazó projekt neve. | Igen |
System.TeamProjectId | Annak a projektnek az azonosítója, amelyhez ez a build tartozik. | Igen |
System.TimelineId | Sztringalapú azonosító egyetlen folyamatfuttatás végrehajtási részleteihez és naplóihoz. | Nem |
TF_BUILD | Állítsa True , ha egy buildelési feladat futtatja a szkriptet. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Változók ellenőrzése (DevOps Server 2022)
Változó | Leírás |
---|---|
Checks.StageAttempt | Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekményes, amikor a szakasz újrapróbálkozott. Ez a változó csak jóváhagyás vagy környezet ellenőrzése során használható. Használhatja például $(Checks.StageAttempt) egy REST API-ellenőrzés meghívása során. ![]() |
Ügynökváltozók (DevOps Server 2020)
Feljegyzés
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.
AGENT_JOBSTATUS a következőként kell hivatkozni: . A régebbi agent.jobstatus verzió a visszamenőleges kompatibilitás érdekében érhető el. |
Agent.MachineName | Annak a gépnek a neve, amelyre az ügynök telepítve van. |
Agent.Name | A készletben regisztrált ügynök neve. Ha saját üzemeltetésű ügynököt használ, akkor ezt a nevet Ön állítja be. Ügynökök megtekintése. |
Agent.OS | Az ügynök gazdagépének operációs rendszere. Az érvényes értékek a következők:
|
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 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.
|
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):
|
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.
|
Nem |
Build.Repository.Tfvc.Workspace | Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. A buildügynök által használt TFVC-munkaterület neve. Ha például az Agent.BuildDirectory az c:\agent_work\12 , és a Agent.Id, 8 akkor a munkaterület neve a következő lehet: ws_12_8 . Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.Repository.Uri | Az eseményindító adattár URL-címe. Példa: 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:
/ ) 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)/s még akkor is, ha az önkiszolgáló (elsődleges) adattárat a rendszer a több kivételes alapértelmezett elérési úttól $(Pipeline.Workspace)/s/<RepoName> eltérő egyéni elérési útra irányítja (ebben a tekintetben a változó eltér a Build.Repository.LocalPath változó viselkedésétől). Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.SourceVersion | A buildben található triggerelő adattár legújabb verziókövetési módosítása.
|
Igen |
Build.SourceVersionMessage | Az eseményindító adattár véglegesítésének vagy változáskészletének megjegyzése. Az üzenetet az első sorra vagy 200 karakterre csonkítjuk, attól függően, hogy melyik rövidebb. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. Emellett ez a változó csak a lépés szintjén érhető el. A feladat- vagy szakaszszintek nem érhetők el. Vagyis az üzenet nem lesz kinyerve, amíg a feladat el nem indul, és ki nem veszi a kódot. Megjegyzés: A Build.SourceVersionMessage változó nem működik a Bitbucket-adattárak klasszikus buildelési folyamataival, ha Batch-módosításokat végez, miközben a buildelés folyamatban van, engedélyezve van. |
Nem |
Build.StagingDirectory | Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: c:\agent_work\1\a A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Tekintse meg az Azure Pipelines összetevőit. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.Repository.Git.SubmoduleCheckout | A Kivétel almodulok a adattár lapján. Ha több adattárat is kivett, ez az érték nyomon követi az eseményindító adattár beállításait. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.SourceTfvcShelveset | Akkor van definiálva, ha a adattár a Team Foundation verziókövetése (TFVC). Ha kapus buildelési vagy polckészlet-összeállításifuttat, ez a változó az éppen létrehozott polckészlet nevére van állítva. Megjegyzés: Ez a változó olyan értéket ad, amely a buildszámformátumban való buildhasználathoz érvénytelen. |
Nem |
Build.TriggerBy.BuildId | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build BuildID azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.TriggerBy.DefinitionId | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build DefinitionID azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.TriggerBy.DefinitionName | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító buildfolyamat nevére van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.TriggerBy.BuildNumber | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító build számára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Build.TriggerBy.ProjectID | Ha egy másik buildindító a buildet, akkor ez a változó az eseményindító buildet tartalmazó projekt azonosítójára van állítva. A klasszikus folyamatokban a buildkiegészítési eseményindító aktiválja ezt a változót. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Common.TestResultsDirectory | Annak az ügynöknek a helyi elérési útja, ahol a teszteredmények létrejönnek. Például: c:\agent_work\1\TestResults Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál.Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Folyamatváltozók (DevOps Server 2020)
Változó | Leírás |
---|---|
Pipeline.Workspace | Egy adott folyamat munkaterületi címtára. Ez a változó ugyanazzal az értékkel rendelkezik, mint a Agent.BuildDirectory . Például: /home/vsts/work/1 . Az ügynökkönyvtár struktúrájáról további információt ügynökkönyvtár-struktúracímű témakörben talál. |
Üzembehelyezési feladat változói (DevOps Server 2020)
Ezek a változók egy adott üzembehelyezési feladatra vonatkoznak, és csak a feladat végrehajtásakor oldódnak fel.
Változó | Leírás |
---|---|
Environment.Name | Az üzembe helyezési feladatban megcélzott környezet neve az üzembe helyezési lépések futtatásához és az üzembe helyezési előzmények rögzítéséhez. Például: smarthotel-dev . |
Environment.Id | Az üzembe helyezési feladatban megcélzott környezet azonosítója. Például: 10 . |
Environment.ResourceName | Az üzembe helyezési lépések futtatásához és az üzembe helyezési előzmények rögzítéséhez az üzembe helyezési feladatban megcélzott környezetben lévő adott erőforrás neve. Például bookings , amely egy Kubernetes-névtér, amely erőforrásként van hozzáadva a környezethez smarthotel-dev . |
Environment.ResourceId | Az üzembe helyezési lépések futtatásához az üzembe helyezési feladatban megcélzott környezetben lévő adott erőforrás azonosítója. Például: 4 . |
Rendszerváltozók (DevOps Server 2020)
Ha olyan változót használ sablonban, amely nem szerepel a sablonokban elérhetőként megjelölve. A változó nem jelenik meg, mert értéke nem érhető el a sablon hatókörén belül.
Változó | Leírás | Elérhető sablonokban? |
---|---|---|
System.AccessToken |
Az OAuth-jogkivonat használatával érheti el a REST API-t. Használja a System.AccessTokent YAML-szkriptekből. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Igen |
System.CollectionId | A TFS-gyűjtemény vagy az Azure DevOps-szervezet GUID azonosítója | Igen |
System.CollectionUri | Egy sztring Team Foundation-kiszolgáló gyűjteményének URI-ja. | Igen |
System.DefaultWorkingDirectory | Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: c:\agent_work\1\s Az ügynökkönyvtár struktúrájáról további információt Ügynökkönyvtár-struktúracímű témakörben talál.A saját üzemeltetésű ügynökök esetében az új buildfolyamatok alapértelmezés szerint csak a módosított fájlokat frissítik. Az Adattár lapon módosíthatja a fájlok letöltési módját. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
System.DefinitionId | A buildelési folyamat azonosítója. | Igen |
System.HostType | Állítsa be, hogy build a folyamat build-e. Egy kiadás esetében az értékek deployment egy üzembehelyezési csoport feladatához, gates a kapuk kiértékelése során, valamint release más (ügynök- és ügynök nélküli) feladatokhoz tartoznak. |
Igen |
System.JobAttempt | Állítsa 1 értékre a feladat első kísérletekor, és minden alkalommal növekszik, amikor a feladat újrapróbálkozott. | Nem |
System.JobDisplayName | Az ember által olvasható név, amit egy feladatnak adtak. | Nem |
System.JobId | Egyetlen feladat egyetlen kísérletének egyedi azonosítója. Az érték egyedi az aktuális folyamathoz. | Nem |
System.JobName | A feladat neve, amely általában a függőségek kifejezésére és a kimeneti változók elérésére szolgál. | Nem |
System.PhaseAttempt | Állítsa 1 értékre a fázis első kísérletekor, és minden alkalommal növekszik, amikor a feladat újrapróbálkozott. Megjegyzés: fázis egy többnyire redundáns fogalom, amely egy feladat tervezési idejét jelöli (míg a feladat egy fázis futtatókörnyezeti verziója volt). A fázis fogalma többnyire el van távolítva az Azure Pipelinesból. A mátrix- és többkonfigurációs feladatok az egyetlen olyan hely, ahol a fázisok továbbra is eltérnek a feladatoktól. Egy fázis több feladatot is képes létrehozni, amelyek csak a bemeneteikben különböznek. |
Nem |
System.PhaseDisplayName | Az ember által olvasható név, amelyet egy fázisnak adnak. | Nem |
System.PhaseName | Egy feladat sztringalapú azonosítója, amely általában függőségek kifejezésére és kimeneti változók elérésére szolgál. | Nem |
System.StageAttempt | Állítsa 1 értékre a szakasz első kísérletekor, és minden alkalommal növekszik, amikor a feladat újrapróbálkozott. | Nem |
System.StageDisplayName | Az ember által olvasható név, amit egy szakasznak adtak. | Nem |
System.StageName | Egy szakasz sztringalapú azonosítója, amely általában függőségek kifejezésére és kimeneti változók elérésére szolgál. | Igen |
System.PullRequest.IsFork | Ha a lekéréses kérelem az adattár egy elágazásából származik, ez a változó a következőre True van állítva: . Ellenkező esetben az értéke False . |
Igen |
System.PullRequest.PullRequestId | A buildet okozó lekéréses kérelem azonosítója. Például: 17 (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). |
Nem |
System.PullRequest.PullRequestNumber | A buildet okozó lekéréses kérelem száma. Ez a változó a GitHubról érkező lekéréses kérelmekhez van feltöltve, amelyek eltérő lekéréses kérelmek azonosítójával és lekéréses kérelmek számmal rendelkeznek. Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre. | Nem |
System.PullRequest.targetBranchName | A lekéréses kérelem célágának neve. Ez a változó egy folyamatban a lekéréses kérelem célága alapján feltételesen hajthat végre feladatokat vagy lépéseket. Előfordulhat például, hogy a módosításokat egyesítő ágtól függően más teszteket vagy kódelemzési eszközöket szeretne aktiválni. | Nem |
System.PullRequest.SourceBranch | A lekéréses kérelemben áttekintett ág. Például: refs/heads/users/raisa/new-feature (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre. |
Nem |
System.PullRequest.SourceCommitId | A lekéréses kérelemben áttekintett véglegesítés. (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR). Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre. | |
System.PullRequest.SourceRepositoryURI | A lekéréses kérelmet tartalmazó adattár URL-címe. Például: https://dev.azure.com/ouraccount/_git/OurProject |
Nem |
System.PullRequest.TargetBranch | A lekéréses kérelem céljaként megadott ág. Például ha refs/heads/main az adattár az Azure-adattárban van, és main amikor az adattár a GitHubon található. Ez a változó csak akkor inicializálódik, ha a build egy ágszabályzat által érintett Git PR miatt futott. Ez a változó csak akkor érhető el YAML-folyamatban, ha egy ágszabályzat hatással van a lekéréses kérelemre. |
Nem |
System.TeamFoundationCollectionUri | A csapatalapítási gyűjtemény URI-ja. Például: https://dev.azure.com/fabrikamfiber/ Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Igen |
System.TeamProject | A buildet tartalmazó projekt neve. | Igen |
System.TeamProjectId | Annak a projektnek az azonosítója, amelyhez ez a build tartozik. | Igen |
TF_BUILD | Állítsa True , ha egy buildelési feladat futtatja a szkriptet. Ez a változó ügynök hatókörű, és környezeti változóként használható szkriptekben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
Nem |
Ügynökváltozók (DevOps Server 2019)
Feljegyzés
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.
AGENT_JOBSTATUS a következőként kell hivatkozni: . A régebbi agent.jobstatus verzió a visszamenőleges kompatibilitás érdekében érhető el. |
Agent.MachineName | Annak a gépnek a neve, amelyre az ügynök telepítve van. |
Agent.Name | A készletben regisztrált ügynök neve. Ha saját üzemeltetésű ügynököt használ, akkor ezt a nevet ön állítja be. Ügynökök megtekintése. |
Agent.OS | Az ügynök gazdagépének operációs rendszere. Az érvényes értékek a következők:
|
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 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.
|
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.
|
Build.Repository.Tfvc.Workspace | Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. A buildügynök által használt TFVC-munkaterület neve. Ha például az Agent.BuildDirectory az c:\agent_work\12 , és a Agent.Id, 8 akkor a munkaterület neve a következő lehet: ws_12_8 . Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. |
Build.Repository.Uri | Az adattár URL-címe. Példa: 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:
/ ) 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.
|
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.
|
Build.SourceVersionMessage | A véglegesítés vagy a módosításkészlet megjegyzése. Az üzenetet az első sorra vagy 200 karakterre csonkítjuk, attól függően, hogy melyik rövidebb. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. Megjegyzés: Ez a változó a TFS 2015.4-ben érhető el. Megjegyzés: A Build.SourceVersionMessage változó nem működik a Bitbucket-adattárak klasszikus buildfolyamataival, amikor a Batch megváltozik, miközben a build engedélyezve van . |
Build.StagingDirectory | Annak az ügynöknek a helyi elérési útja, ahová a rendszer átmásolja az összetevőket a célhelyre való leküldés előtt. Például: c:\agent_work\1\a A mappa használatának tipikus módja a buildösszetevők közzététele a Fájlok másolása és a Buildösszetevők közzététele feladatokkal. Megjegyzés: A Build.ArtifactStagingDirectory és a Build.StagingDirectory felcserélhető. Ez a könyvtár minden új build előtt törlődik, így nem kell saját maga megtisztítania. Tekintse meg az Azure Pipelines összetevőit. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. |
Build.Repository.Git.SubmoduleCheckout | A Pénztár almodulokhoz kiválasztott érték az adattár lapon. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. |
Build.SourceTfvcShelveset | Akkor van definiálva, ha az adattár a Team Foundation verziókövetése. Ha egy zárt vagy egy polckészlet-buildet futtat, akkor ez az építendő polckészlet nevére van állítva. Megjegyzés: Ez a változó olyan értéket ad, amely a buildszámformátumban való buildhasználathoz érvénytelen. |
Build.TriggerBy.BuildId | Ha a buildet egy másik build aktiválta, akkor ez a változó az eseményindító build BuildID azonosítójára van állítva. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. |
Build.TriggerBy.DefinitionId | Ha a buildet egy másik build aktiválta, akkor ez a változó az eseményindító build DefinitionID azonosítójára van állítva. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. |
Build.TriggerBy.DefinitionName | Ha a buildet egy másik build aktiválta, akkor ez a változó az eseményindító buildelési folyamat nevére van állítva. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. |
Build.TriggerBy.BuildNumber | Ha a buildet egy másik build aktiválta, akkor ez a változó az eseményindító build számára van állítva. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. |
Build.TriggerBy.ProjectID | Ha a buildet egy másik build aktiválta, akkor ez a változó az eseményindító buildet tartalmazó projekt azonosítójára van állítva. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. |
Common.TestResultsDirectory | Annak az ügynöknek a helyi elérési útja, ahol a teszteredmények létrejönnek. Például: c:\agent_work\1\TestResults Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. |
Rendszerváltozók (DevOps Server 2019)
Példa PowerShell-szkriptre: hozzáférés a REST API-hoz
Változó | Leírás |
---|---|
System.AccessToken |
Az OAuth-jogkivonat használatával érheti el a REST API-t. Használja a System.AccessTokent YAML-szkriptekből. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. |
System.CollectionId | A TFS-gyűjtemény vagy az Azure DevOps-szervezet GUID azonosítója |
System.DefaultWorkingDirectory | Annak az ügynöknek a helyi elérési útja, ahol a forráskódfájlok letöltődnek. Például: c:\agent_work\1\s Az ügynökkönyvtár struktúrájáról további információt Ügynökkönyvtár-struktúracímű témakörben talál.A saját üzemeltetésű ügynökök esetében az új buildfolyamatok alapértelmezés szerint csak a módosított fájlokat frissítik. Az Adattár lapon módosíthatja a fájlok letöltési módját. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban. Nem használható a buildszám részeként vagy verziókövetési címkeként. |
System.DefinitionId | A buildelési folyamat azonosítója. |
System.HostType | Állítsa be, hogy build a folyamat build-e. Kiadás esetén az értékek deployment egy üzembe helyezési csoportfeladat és release egy ügynökfeladat értékei. |
System.PullRequest.IsFork | Ha a lekéréses kérelem az adattár egy elágazásából származik, ez a változó a következőre True van állítva: . Ellenkező esetben a beállítás értéke .False |
System.PullRequest.PullRequestId | A buildet okozó lekéréses kérelem azonosítója. Például: 17 (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR.) |
System.PullRequest.PullRequestNumber | A buildet okozó lekéréses kérelem száma. Ez a változó a GitHubról érkező lekéréses kérelmekhez van feltöltve, amelyek eltérő lekéréses kérelmek azonosítójával és lekéréses kérelmek számmal rendelkeznek. |
System.PullRequest.SourceBranch | A lekéréses kérelemben áttekintett ág. Például: refs/heads/users/raisa/new-feature (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR.) |
System.PullRequest.SourceCommitId | A lekéréses kérelemben áttekintett véglegesítés. (Ez a változó csak akkor inicializálódik, ha a build egy Ágszabályzat által érintett Git PR.) |
System.PullRequest.SourceRepositoryURI | A lekéréses kérelmet tartalmazó adattár URL-címe. Például: https://dev.azure.com/ouraccount/_git/OurProject (Ez a változó csak akkor inicializálódik, ha a build egy Egy ágszabályzat által érintett Azure Repos Git PR. Nem inicializálva a GitHub PRS-ekhez.) |
System.PullRequest.TargetBranch | A lekéréses kérelem céljaként megadott ág. Például: refs/heads/main Ez a változó csak akkor inicializálódik, ha a build egy ágszabályzat által érintett Git PR miatt futott. |
System.TeamFoundationCollectionUri | A csapatalapítási gyűjtemény URI-ja. Például: https://dev.azure.com/fabrikamfiber/ Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. |
System.TeamProject | A buildet tartalmazó projekt neve. |
System.TeamProjectId | Annak a projektnek az azonosítója, amelyhez ez a build tartozik. |
TF_BUILD | Állítsa be, True hogy a szkriptet buildelési feladat futtatja-e. Ez a változó ügynök hatókörű. Használható környezeti változóként egy szkriptben és paraméterként egy buildelési feladatban, de nem a buildszám részeként vagy verziókövetési címkeként. |
Hogyan vannak beállítva az identitásváltozók?
Az érték attól függ, hogy mi okozta a buildet, és az Azure-adattárakra jellemző.
Ha a build aktiválódik... | Ezután a Build.QueuedBy és a Build.QueuedById értékek... | Ezután a Build.RequestedFor és a Build.RequestedForId értékek... |
---|---|---|
A Gitben vagy a folyamatos integrációs (CI) eseményindítókon | A rendszer identitása, például: [DefaultCollection]\Project Collection Service Accounts |
Az a személy, aki leküldte vagy beadta a módosításokat. |
Gitben vagy ágszabályzat-buildben. | A rendszer identitása, például: [DefaultCollection]\Project Collection Service Accounts |
Az a személy, aki bejelentkezett a módosításokba. |
TFVC-ben egy kapus bejelentkezési eseményindítóval | Az a személy, aki bejelentkezett a módosításokba. | Az a személy, aki bejelentkezett a módosításokba. |
Gitben vagy TFVC-ben az ütemezett eseményindítók | A rendszer identitása, például: [DefaultCollection]\Project Collection Service Accounts |
A rendszer identitása, például: [DefaultCollection]\Project Collection Service Accounts |
Mert a Várólista összeállítása gombra kattintott | Ön | Ön |
Kérje meg a Copilot, hogy hozzon létre egy változó értékeken alapuló feltételt tartalmazó szakaszt
A Copilot használatával hozzon létre egy szakaszt egy változó értéke által meghatározott feltétellel.
Ez a példakérés egy olyan szakaszt határoz meg, amely akkor fut, amikor Agent.JobStatus
azt jelzi, hogy az előző szakasz sikeresen futott:
Hozzon létre egy új Azure DevOps-szakaszt, amely csak akkor fut, ha
Agent.JobStatus
Succeeded
vagySucceededWithIssues
.
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 .