Konfigurace Azure CLI

  • Článek

Azure CLI umožňuje uživatelské konfigurace různých nastavení, jako je protokolování, shromažďování dat a výchozí hodnoty argumentů. Rozhraní příkazového řádku nabízí příkaz pro usnadnění správy některých výchozích hodnot az configa interaktivní možnost prostřednictvím az init. Další hodnoty se dají nastavit v konfiguračním souboru nebo prostřednictvím proměnných prostředí. Tento článek obsahuje další informace o těchto nastaveních konfigurace uživatele a o tom, jak nakonfigurovat Azure CLI.

Hodnoty konfigurace používané rozhraním příkazového řádku se vyhodnotí v následujícím pořadí. Položky, které jsou na seznamu výš, mají vyšší prioritu.

  1. Parametry příkazového řádku
  2. Proměnné prostředí
  3. Hodnoty v konfiguračním souboru nastaveném az configaz init

Konfigurace nastavení pomocí az init

Nejjednodušší způsob, jak nastavit konfigurace Azure CLI, je použít interaktivní příkaz az init . Zvolte společnou konfiguraci, například "interakce" nebo "automatizace", nebo se rozhodnete projít jednotlivé konfigurace. To, co je zvlášť užitečné při tomto přístupu, je az init důvod, proč byste mohli chtít zvolit jednu možnost konfigurace nad jinou.

az init

Konfigurace nastavení pomocí az config

Výchozí hodnoty pro rozhraní příkazového řádku můžete nastavit pomocí příkazu az config set . Tento příkaz přebírá jako argument seznam dvojic oddělených key=value mezerami. Zadané hodnoty používají Azure CLI místo povinných argumentů.

Následující tabulka obsahuje seznam dostupných konfiguračních klíčů.

Název Popis
defaults.group Výchozí skupina prostředků pro všechny příkazy
defaults.location Výchozí skupina umístění pro všechny příkazy
defaults.web Výchozí název aplikace pro příkazy az webapp
defaults.vm Výchozí název virtuálního počítače pro příkazy az vm
defaults.vmss Výchozí název škálovací sady virtuálních počítačů (VMSS), který se má použít pro az vmss příkazy.
defaults.acr Výchozí název registru kontejneru pro příkazy az acr

Tady je příklad, jak byste mohli nastavit výchozí skupinu prostředků a umístění pro všechny příkazy.

az config set defaults.location=westus2 defaults.group=MyResourceGroup

Následující příkaz vypne odkazy na průzkum při provádění příkazů Azure CLI:

az config set output.show_survey_link=no

Konfigurační soubor CLI

Konfigurační soubor rozhraní příkazového řádku obsahuje další nastavení, která se používají pro správu chování rozhraní příkazového řádku. Samotný konfigurační soubor je umístěný v $AZURE_CONFIG_DIR/config. Výchozí hodnota pro AZURE_CONFIG_DIR je $HOME/.azure v Linuxu a macOS a %USERPROFILE%\.azure ve Windows.

Konfigurační soubory jsou napsané ve formátu souborů INI. Hlavičky oddílu definují formát souboru následovaný seznamem položek klíč-hodnota.

  • Záhlaví oddílu se zapisují jako [section-name]. V názvech oddílů se rozlišují velká a malá písmena.
  • Položky se zapisují jako key=value. V názvech klíčů se nerozlišuje malá a velká písmena.
  • Komentář je každý řádek, který začíná # nebo ;. Vložené komentáře nejsou povolené.

Logické hodnoty nerozlišují malá a velká písmena. Následující hodnoty představují logické hodnoty:

  • True: 1, yes, true, on
  • False: 0, no, false, off

Tady je příklad konfiguračního souboru rozhraní příkazového řádku, který zakazuje zobrazování výzev k potvrzení a nastavuje protokolování do adresáře /var/log/azure.

[core]
disable_confirm_prompt=Yes

[logging]
enable_log_file=yes
log_dir=/var/log/azure

Podrobné informace o všech dostupných konfiguračních hodnotách a jejich významu najdete v následujícím oddílu. Všechny podrobnosti o formátu souborů INI najdete v dokumentaci k Pythonu věnované INI.

Proměnné prostředí a hodnoty konfigurace rozhraní příkazového řádku

Následující tabulka obsahuje názvy všech oddílů a možností, které je možné umístit mohou do konfiguračního souboru. Odpovídající proměnné prostředí jsou nastavené jako AZURE_{section}_{name} (všechna písmena velká). Například output výchozí hodnota core pro je nastavena v AZURE_CORE_OUTPUT proměnné, storage_account výchozí hodnota batchai pro je nastavena v AZURE_BATCHAI_STORAGE_ACCOUNT proměnné a výchozí location je nastavena AZURE_DEFAULTS_LOCATION v proměnné.

Když zadáte výchozí hodnotu, tento argument už žádný příkaz nevyžaduje. Místo něj se použije výchozí hodnota.

Oddíl Name Typ Popis
core output string Výchozí formát výstupu. Povolené hodnoty: json (výchozí), jsonc, yaml, yamlc, table, tsv. none Další informace najdete v tématu Formáty výstupu pro příkazy Azure CLI.
disable_confirm_prompt boolean Umožňuje vypnout nebo zapnout výzvy k potvrzení.
display_region_identified boolean Zákazníci Azure se můžou rozhodnout nasadit prostředky v mnoha různých oblastech. V některých případech můžou zákazníci snížit náklady výběrem blízkých oblastí nabízejících stejné služby. Pokud je identifikovaná okolní oblast, zobrazí se ve zprávě zpráva, která se má vybrat pro budoucí nasazení. Toto nastavení určuje, jestli se zobrazí zpráva.
collect_telemetry boolean Umožňuje Microsoftu shromažďovat anonymní informace o používání rozhraní příkazového řádku. Informace o ochraně osobních údajů najdete v licenci Azure CLI MIT.
only_show_errors boolean Zobrazí se pouze chyby při vyvolání příkazu. Jinými slovy, pouze chyby jsou zapsány do stderr. Potlačí upozornění z náhledu, zastaralého a experimentálního příkazu. Je také k dispozici pro jednotlivé příkazy s parametrem --only-show-errors .
no_color boolean Zakažte barvu. Původně barevné zprávy mají předponu DEBUG, INFOWARNING a ERROR. Tato logická hodnota obchází problém knihovny třetí strany, kde se barva terminálu po přesměrování nemůže vrátit zpět stdout .
Klienty show_secrets_warning boolean Zapněte nebo vypněte upozornění pro výstup citlivých informací.
logging enable_log_file boolean Umožňuje vypnout nebo zapnout protokolování.
log_dir string Adresář, do kterého se zapisují protokoly. Ve výchozím nastavení touto hodnotou je ${AZURE_CONFIG_DIR}/logs*.
Výchozí skupina string Výchozí skupina prostředků pro všechny příkazy
location string Výchozí skupina umístění pro všechny příkazy
web string Výchozí název aplikace pro příkazy az webapp
vm string Výchozí název virtuálního počítače pro příkazy az vm
vmss string Výchozí název škálovací sady virtuálních počítačů (VMSS), který se má použít pro az vmss příkazy.
acr string Výchozí název registru kontejneru pro příkazy az acr
storage account string Výchozí název účtu úložiště (například mystorageaccount in https://mystorageaccount.blob.core.windows.net) pro az storage příkazy roviny dat (například az storage container list).
klíč string Výchozí přístupový klíč, který se má použít pro az storage příkazy roviny dat.
sas_token string Výchozí token SAS, který se má použít pro az storage příkazy roviny dat.
connection_string string Výchozí připojovací řetězec použít pro az storage příkazy roviny dat.
batchai storage_account string Výchozí účet úložiště pro příkazy az batchai
storage_key string Výchozí klíč úložiště pro příkazy az batchai
batch account string Výchozí účet Azure Batch pro příkazy az batch
access_key string Výchozí přístupový klíč pro příkazy az batch. Používá se jenom pro autorizaci aad.
endpoint string Výchozí koncový bod pro připojení pro příkazy az batch
auth_mode string Výchozí režim autorizace pro příkazy az batch. Povolené hodnoty: shared_key, aad.
Cloud name string Výchozí cloud pro všechny az příkazy. Povolené hodnoty: AzureCloud (výchozí), AzureChinaCloud, AzureUSGovernment. Pokud chcete změnit cloudy, můžete použít az cloud set –name tento příkaz. Příklad najdete v tématu Správa cloudů pomocí Azure CLI.
Rozšíření use_dynamic_install string Pokud se rozšíření ještě nepřidá, nainstalujte ho při spuštění příkazu z něj. Povolené hodnoty: no (výchozí), yes_prompt, yes_without_prompt.
run_after_dynamic_install boolean Pokračujte spuštěním příkazu, když je pro něj dynamicky nainstalované rozšíření. Výchozí hodnota je False.
index_url string Adresa URL souboru indexu privátní přípony za formátem v index.json. Po zadání se spuštěním az extension add --name <extension-name> tohoto souboru najde přípona, kterou chcete přidat.

Poznámka:

V konfiguračním souboru se mohou zobrazovat i jiné hodnoty, ale ty se spravují přímo prostřednictvím příkazů rozhraní příkazového řádku, včetně az config. Ty, které jsou uvedené v tabulce dříve, jsou jediné hodnoty, které byste měli změnit sami.