Konfigurace Azure CLI

Azure CLI umožňuje uživatelské konfigurace různých nastavení, jako je protokolování, shromažďování dat a výchozí hodnoty argumentů. Toto rozhraní nabízí pohodlný příkaz pro správu některých výchozích hodnot, az config. 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. Trvalé hodnoty parametrů nastavené pomocí az config param-persist
  3. Proměnné prostředí
  4. Hodnoty v konfiguračním souboru nastaveném pomocí az config

Konfigurace rozhraní příkazového řádku pomocí příkazu az config

Výchozí hodnoty pro rozhraní příkazového řádku nastavíte pomocí příkazu az config set. Tento příkaz jako argument přebírá seznam párů key=value oddělených mezerami. Rozhraní příkazového řádku používá tyto zadané hodnoty místo požadovaných argumentů.

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

Název Description
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 Název škálovací sady virtuálních počítačů (VMSS) pro příkazy az vmss
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

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. Tento formát definují záhlaví oddílů, za kterými následuje seznam 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šují malá a velká písmena.
  • Komentář je každý řádek, který začíná # nebo ;. Vložené komentáře se nepovolují.

U logických hodnot se nerozlišují velká a malá písmena. Reprezentují je následující 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 výchozí hodnota pro je nastavená v proměnné , výchozí hodnota pro je nastavená v proměnné a výchozí hodnota je output core AZURE_CORE_OUTPUT storage_account batchai AZURE_BATCHAI_STORAGE_ACCOUNT location nastavená v AZURE_DEFAULTS_LOCATION 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.

Sekce Název Typ Description
Core output řetězec Výchozí formát výstupu. Může to být jedna z hodnot json, jsonc, tsv nebo table.
disable_confirm_prompt boolean Umožňuje vypnout nebo zapnout výzvy k potvrzení.
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.
pouze _ zobrazovat _ chyby boolean Zobrazí se pouze chyby během volání příkazu. Jinými slovy, do se zapisou jenom stderr chyby. Potlačí upozornění z příkazů ve verzi Preview, zastaralých a experimentálních příkazů. Je také k dispozici pro jednotlivé příkazy s --only-show-errors parametrem .
bez _ barvy boolean Zakažte barvu. Původně barevné zprávy budou mít předponu DEBUG , INFO a WARNING ERROR . Tím se obchází problém knihovny třetí strany, kdy se barva terminálu po přesměrování nemůže stdout vrátit zpět.
protokolování enable_log_file boolean Umožňuje vypnout nebo zapnout protokolování.
log_dir řetězec Adresář, do kterého se zapisují protokoly. Ve výchozím nastavení touto hodnotou je ${AZURE_CONFIG_DIR}/logs*.
výchozí hodnoty group řetězec Výchozí skupina prostředků pro všechny příkazy
location řetězec Výchozí skupina umístění pro všechny příkazy
web řetězec Výchozí název aplikace pro příkazy az webapp
vm řetězec Výchozí název virtuálního počítače pro příkazy az vm
vmss řetězec Výchozí název VMSS (Virtual Machine Scale set), který se má použít pro az vmss příkazy
acr řetězec Výchozí název registru kontejneru pro příkazy az acr
pamì account řetězec Výchozí název účtu úložiště (například mystorageaccount , https://mystorageaccount.blob.core.windows.net) který se má použít pro az storage příkazy datové roviny (např. az storage container list ).
key řetězec Výchozí přístupový klíč, který se má použít pro az storage příkazy datové roviny.
sas_token řetězec Výchozí token SAS, který se má použít pro az storage příkazy datové roviny.
connection_string řetězec Výchozí připojovací řetězec, který se má použít pro az storage příkazy datové roviny.
batchai storage_account řetězec Výchozí účet úložiště pro příkazy az batchai
storage_key řetězec Výchozí klíč úložiště pro příkazy az batchai
partie account řetězec Výchozí účet Azure Batch pro příkazy az batch
access_key řetězec Výchozí přístupový klíč pro příkazy az batch. Používá se jenom pro autorizaci aad.
endpoint řetězec Výchozí koncový bod pro připojení pro příkazy az batch
auth_mode řetězec Výchozí režim autorizace pro příkazy az batch. Může být shared_key nebo aad.
cloudu name řetězec Výchozí Cloud pro všechny az příkazy. Možné hodnoty jsou AzureCloud (výchozí), AzureChinaCloud , AzureUSGovernment , AzureGermanCloud . Chcete-li změnit cloudy, můžete použít az cloud set –name příkaz. Příklad najdete v tématu Správa cloudů pomocí Azure CLI.
klapk use_dynamic_install řetězec Nainstalujte rozšíření, pokud se ještě nepřidalo při spuštění příkazu z něho. Možné hodnoty jsou no (výchozí), yes_prompt , yes_without_prompt .
run_after_dynamic_install boolean Pokračovat ve spuštění příkazu, když je pro něj dynamicky nainstalovaná přípona. Výchozí je False.

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. Hodnoty uvedené v této tabulce jsou jediné hodnoty, které byste měli měnit sami.

Viz také