AzureCLI@1 – Azure CLI v1-feladat
Futtassa az Azure CLI-parancsokat egy Azure-előfizetésen egy rendszerhéjszkriptben, amikor Linux-ügynökön vagy kötegelt szkripten fut a Windows-ügynökön való futtatáskor.
Azure CLI-parancsokkal futtathat rendszerhéj- vagy batch-szkriptet egy Azure-előfizetésen.
Syntax
# Azure CLI v1
# Run Azure CLI commands against an Azure subscription in a Shell script when running on Linux agent or Batch script when running on Windows agent.
- task: AzureCLI@1
inputs:
azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription.
scriptLocation: 'scriptPath' # 'inlineScript' | 'scriptPath'. Required. Script Location. Default: scriptPath.
scriptPath: # string. Required when scriptLocation = scriptPath. Script Path.
#inlineScript: # string. Required when scriptLocation = inlineScript. Inline Script.
#arguments: # string. Alias: args. Arguments.
# Advanced
#addSpnToEnvironment: false # boolean. Access service principal details in script. Default: false.
#useGlobalConfig: false # boolean. Use global Azure CLI configuration. Default: false.
#workingDirectory: # string. Alias: cwd. Working Directory.
#failOnStandardError: false # boolean. Fail on Standard Error. Default: false.
# Azure CLI v1
# Run a Shell or Batch script with Azure CLI commands against an azure subscription.
- task: AzureCLI@1
inputs:
azureSubscription: # string. Alias: connectedServiceNameARM. Required. Azure subscription.
scriptLocation: 'scriptPath' # 'inlineScript' | 'scriptPath'. Required. Script Location. Default: scriptPath.
scriptPath: # string. Required when scriptLocation = scriptPath. Script Path.
#inlineScript: # string. Required when scriptLocation = inlineScript. Inline Script.
#arguments: # string. Alias: args. Arguments.
# Advanced
#workingDirectory: # string. Alias: cwd. Working Directory.
#failOnStandardError: false # boolean. Fail on Standard Error. Default: false.
Bevitelek
azureSubscription
- Azure-előfizetés
Bemeneti alias: connectedServiceNameARM
. string
. Kötelező.
Kiválaszt egy Azure Resource Manager-előfizetést az üzembe helyezéshez.
scriptLocation
- Szkript helye
string
. Kötelező. Engedélyezett értékek: inlineScript
(beágyazott szkript), scriptPath
(Szkript elérési útja). Alapértelmezett érték: scriptPath
.
Kiválasztja a szkript helyét.
scriptPath
- Szkript elérési útja
string
. Akkor szükséges, ha scriptLocation = scriptPath
.
A szkript teljes elérési útja vagy az alapértelmezett munkakönyvtárhoz viszonyított elérési út.
inlineScript
- Beágyazott szkript
string
. Akkor szükséges, ha scriptLocation = inlineScript
.
A szkripteket ide írhatja. Windows-ügynök használata esetén használjon kötegelt szkriptelést. Linux-alapú ügynökök használatakor használjon rendszerhéjszkriptet. Kötegelt fájlok esetén használja az előtagot call
minden Azure-parancs előtt. Előre definiált és egyéni változókat is átadhat ehhez a szkripthez argumentumok használatával
Lásd az alábbi példákat. Az első egy felületi példa, a második pedig egy kötegelt példa:
azure --version || azure account show
call azure --version || call azure account show
arguments
- Érvek
Bemeneti alias: args
. string
.
A szkriptnek átadott argumentumok.
addSpnToEnvironment
- A szolgáltatásnév részleteinek elérése a szkriptben
boolean
. Alapértelmezett érték: false
.
Hozzáadja a parancsprogram végrehajtási környezetéhez kiválasztott Azure-végpont egyszerű szolgáltatásazonosítóját és kulcsát. A és $servicePrincipalKey
változókat $servicePrincipalId
használhatja a szkriptben.
Ez csak akkor történik meg, ha az Azure-végpont szolgáltatásnév hitelesítési sémával rendelkezik.
useGlobalConfig
- Globális Azure CLI-konfiguráció használata
boolean
. Alapértelmezett érték: false
.
Ha ez hamis, ez a feladat a saját különálló Azure CLI-konfigurációs könyvtárát fogja használni. Ez az Azure CLI-feladatok párhuzamos kiadásokban való futtatására használható.
workingDirectory
- Munkakönyvtár
Bemeneti alias: cwd
. string
.
Aktuális munkakönyvtár, ahol a szkript fut. Ha üresen marad, ez a bemenet az adattár (build) vagy az összetevők (kiadás) gyökere, amely a következő $(System.DefaultWorkingDirectory)
: .
failOnStandardError
- Hiba standard hiba miatt
boolean
. Alapértelmezett érték: false
.
Ha ez a bemenet igaz, ez a feladat sikertelen lesz, ha bármilyen hibát ír a StandardError streambe. Törölje a jelölőnégyzet jelölését, hogy figyelmen kívül hagyja a szokásos hibákat, és ehelyett a kilépési kódokra támaszkodva állapítsa meg az állapotot.
Feladatvezérlési lehetőségek
Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.
Kimeneti változók
Nincsenek.
Megjegyzések
Az 1.0-s verzió újdonságai:
- Támogatja az új Azure CLI 2.0-t, amely Python-alapú
- Platformfüggetlen ügynökökkel (Linux, macOS vagy Windows) működik
- Az Azure CLI 1.0 (node.js-alapú) használatához váltson a 0.0-s feladatverzióra
- Korlátozások: – A klasszikus Azure-előfizetések nem támogatottak. Az Azure CLI 2.0 csak az Azure Resource Manager -előfizetéseket támogatja.
Követelmények
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build, klasszikus kiadás |
Futtatás | Ügynök, DeploymentGroup |
Igények | None |
Képességek | Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
Parancskorlátozások | Bármelyik |
Változók beállítása | Bármelyik |
Ügynök verziója | 2.0.0 vagy újabb |
Feladatkategória | Üzembe helyezés |