AzureCLI@1 – úloha Azure CLI v1

Článek
07/02/2024

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í

Sdílet prostřednictvím