AzureCLI@1 – úloha Azure CLI v1
Spouštění příkazů Azure CLI pro předplatné Azure ve skriptu prostředí při spuštění v agentu pro Linux nebo dávkového skriptu při spuštění v agentu pro Windows.
Spuštění shellu nebo dávkového skriptu s příkazy Azure CLI pro předplatné Azure.
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.
Vstupy
azureSubscription
- Předplatné Azure
Vstupní alias: connectedServiceNameARM
. string
. Povinná hodnota.
Vybere předplatné Azure Resource Manager pro nasazení.
scriptLocation
- Umístění skriptu
string
. Povinná hodnota. Povolené hodnoty: inlineScript
(Vložený skript), scriptPath
(Cesta ke skriptu). Výchozí hodnota: scriptPath
.
Vybere umístění skriptu.
scriptPath
- Cesta ke skriptu
string
. Vyžaduje se, když scriptLocation = scriptPath
.
Plně kvalifikovaná cesta skriptu nebo cesta vzhledem k výchozímu pracovnímu adresáři.
inlineScript
- Vložený skript
string
. Vyžaduje se, když scriptLocation = inlineScript
.
Skripty můžete napsat přímo tady. Při použití agenta systému Windows použijte dávkové skriptování. Při použití agentů založených na Linuxu používejte skriptování prostředí. U dávkových souborů použijte před každým příkazem Azure předponu call
. Pomocí argumentů můžete tomuto skriptu předat také předdefinované a vlastní proměnné.
Podívejte se na tyto příklady: První je příklad prostředí a druhý je dávkový příklad:
azure --version || azure account show
call azure --version || call azure account show
arguments
- Argumenty
Vstupní alias: args
. string
.
Argumenty předané do skriptu.
addSpnToEnvironment
- Přístup k podrobnostem instančního objektu ve skriptu
boolean
. Výchozí hodnota: false
.
Přidá ID instančního objektu a klíč koncového bodu Azure, který jste zvolili, do spouštěcího prostředí skriptu. Ve skriptu můžete použít $servicePrincipalId
proměnné a $servicePrincipalKey
.
To platí jenom v případě, že má koncový bod Azure schéma ověřování instančního objektu.
useGlobalConfig
- Použití globální konfigurace Azure CLI
boolean
. Výchozí hodnota: false
.
Pokud je tato hodnota nepravdivá, bude tato úloha používat vlastní samostatný adresář konfigurace Azure CLI. Dá se použít ke spouštění úloh Azure CLI v paralelních verzích.
workingDirectory
- Pracovní adresář
Vstupní alias: cwd
. string
.
Aktuální pracovní adresář, ve kterém je skript spuštěn. Pokud je tento vstup prázdný, jedná se o kořen úložiště (sestavení) nebo artefakty (vydané verze), což je $(System.DefaultWorkingDirectory)
.
failOnStandardError
- Selhání při standardní chybě
boolean
. Výchozí hodnota: false
.
Pokud je tento vstup pravdivý, úloha selže při zápisu chyb do datového proudu StandardError. Zrušte zaškrtnutí políčka, pokud chcete ignorovat standardní chyby a místo toho se při určování stavu spoléhat na ukončovací kódy.
Možnosti ovládání úloh
Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.
Výstupní proměnné
Žádné
Poznámky
Novinky ve verzi 1.0:
- Podporuje nové Azure CLI 2.0, které je založené na Pythonu.
- Funguje s agenty pro různé platformy (Linux, macOS nebo Windows)
- Pokud chcete pracovat s Azure CLI 1.0 (založeným na node.js), přepněte na úlohu verze 0.0.
- Omezení: – Žádná podpora předplatných Azure Classic Azure CLI 2.0 podporuje jenom předplatná Azure Resource Manager (ARM).
Požadavky
Požadavek | Popis |
---|---|
Typy kanálů | YAML, classic build, verze Classic |
Spustí se | Agent, DeploymentGroup |
Požadavky | Žádné |
Možnosti | Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze. |
Omezení příkazů | Všechny |
Nastavitelné proměnné | Všechny |
Verze agenta | 2.0.0 nebo vyšší |
Kategorie úloh | Nasazení |