Konfiguracja interfejsu wiersza polecenia platformy Azure

Interfejs wiersza polecenia platformy Azure umożliwia wprowadzenie konfiguracji użytkownika dla ustawień, takich jak rejestrowanie, zbieranie danych i domyślne wartości argumentów. Interfejs wiersza polecenia oferuje wygodne polecenie do zarządzania niektórymi wartościami domyślnymi, az configoraz interaktywną opcją za pomocą polecenia az init. Inne wartości można ustawić w pliku konfiguracji lub za pomocą zmiennych środowiskowych. Ten artykuł zawiera dodatkowe informacje na temat tych ustawień konfiguracji użytkownika i sposobu konfigurowania interfejsu wiersza polecenia platformy Azure.

Wartości konfiguracji używane przez interfejs wiersza polecenia są wartościowane w następującej kolejności. Elementy znajdujące się na początku listy mają wyższy priorytet.

1. Parametry wiersza polecenia
2. Zmienne środowiskowe
3. Wartości w pliku konfiguracji ustawionym za pomocą az config polecenia lub az init

Konfigurowanie ustawień przy użyciu polecenia az init

Najprostszym sposobem ustawienia konfiguracji interfejsu wiersza polecenia platformy Azure jest użycie polecenia interactive az init . Wybierz typową konfigurację, np. "interakcję" lub "automatyzację", lub zdecyduj się przejść przez poszczególne konfiguracje. To, co jest szczególnie przydatne w przypadku tego podejścia, to az init powody, dla których warto wybrać jedną opcję konfiguracji.

az init

Konfigurowanie ustawień przy użyciu polecenia az config

Ustawienia domyślne interfejsu wiersza polecenia można ustawić za pomocą polecenia az config set . To polecenie przyjmuje rozdzielaną spacją listę key=value par jako argument. Podane wartości są używane przez interfejs wiersza polecenia platformy Azure zamiast wymaganych argumentów.

Poniższa tabela zawiera listę dostępnych kluczy konfiguracji.

Nazwa/nazwisko	opis
defaults.group	Domyślna grupa zasobów do użycia ze wszystkimi poleceniami.
defaults.location	Domyślna lokalizacja do użycia ze wszystkimi poleceniami.
defaults.web	Domyślna nazwa aplikacji do użycia z poleceniami az webapp.
defaults.vm	Domyślna nazwa maszyny wirtualnej do użycia z poleceniami az vm.
defaults.vmss	Domyślna nazwa zestawu skalowania maszyn wirtualnych (VMSS) do użycia dla az vmss poleceń.
defaults.acr	Domyślna nazwa rejestru kontenerów do użycia z poleceniami az acr.

Jako przykład przedstawiono tu sposób ustawiania domyślnej grupy zasobów i lokalizacji dla wszystkich poleceń.

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

Następujące polecenie wyłącza linki do ankiety podczas wykonywania poleceń interfejsu wiersza polecenia platformy Azure:

az config set output.show_survey_link=no

Plik konfiguracji interfejsu wiersza polecenia

Plik konfiguracji interfejsu wiersza polecenia zawiera inne ustawienia, które są używane do zarządzania zachowaniem interfejsu wiersza polecenia. Sam plik konfiguracji znajduje się w ścieżce $AZURE_CONFIG_DIR/config. Wartość domyślna zmiennej AZURE_CONFIG_DIR to $HOME/.azure w systemie Linux oraz macOS i %USERPROFILE%\.azure w systemie Windows.

Pliki konfiguracji są zapisane w formacie pliku INI. Nagłówki sekcji definiują format pliku, a następnie listę wpisów klucz-wartość.

• Nagłówki sekcji są zapisywane w postaci [section-name]. W przypadku nazw sekcji wielkość liter ma znaczenie.
• Wpisy są zapisywane w postaci key=value. W nazwach kluczy nie jest uwzględniana wielkość liter.
• Za komentarze są uznawane wszystkie wiersze rozpoczynające się od znaku # lub ;. Komentarze wbudowane nie są dozwolone.

Wartości logiczne są bez uwzględniania wielkości liter. Następujące wartości reprezentują wartości logiczne:

• Prawda: 1, , yes, trueon
• Fałsz: 0, , nofalse,off

Poniżej przedstawiono przykładowy plik konfiguracji interfejsu wiersza polecenia, który wyłącza wszelkie monity o potwierdzenie i konfiguruje rejestrowanie w katalogu /var/log/azure.

[core]
disable_confirm_prompt=Yes

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

W następnej sekcji zamieszczono szczegółowe informacje o wszystkich dostępnych wartościach konfiguracji oraz ich znaczenie. Aby uzyskać szczegółowe informacje o formacie pliku INI, zobacz dokumentację języka Python dotyczącą plików INI.

Wartości konfiguracji i zmienne środowiskowe interfejsu wiersza polecenia

Poniższa tabela zawiera wszystkie nazwy sekcji i opcji, które można umieścić w pliku konfiguracji. Odpowiadające im zmienne środowiskowe są ustawiane w formacie AZURE_{section}_{name} (pisane wersalikami). Na przykład output wartość domyślna parametru jest ustawiana w zmiennej, storage_account wartość domyślna corebatchai parametru AZURE_CORE_OUTPUT jest ustawiana w AZURE_BATCHAI_STORAGE_ACCOUNT zmiennej, a wartość domyślna location jest ustawiana w zmiennejAZURE_DEFAULTS_LOCATION.

Po podaniu wartości domyślnej ten argument nie jest już wymagany przez żadne polecenie. Zamiast niego jest używana wartość domyślna.

Sekcja	Nazwisko	Pisz	Opis
core	output	string	Domyślny format danych wyjściowych. Dozwolone wartości: json (wartość domyślna), jsonc, yaml, yamlc, table, tsv, none. Aby uzyskać więcej informacji, zobacz Formaty danych wyjściowych dla poleceń interfejsu wiersza polecenia platformy Azure.
	disable_confirm_prompt	boolean	Włącza lub wyłącza monity o potwierdzenie.
	display_region_identified	boolean	Klienci platformy Azure mogą zdecydować się na wdrożenie zasobów w wielu różnych regionach. W niektórych przypadkach klienci mogą zmniejszyć koszty, wybierając regiony w pobliżu oferujące te same usługi. Jeśli zostanie zidentyfikowany region w pobliżu, zostanie wyświetlony komunikat z regionem do wybrania dla przyszłych wdrożeń. To ustawienie określa, czy jest wyświetlany komunikat.
	collect_telemetry	boolean	Zezwala firmie Microsoft na zbieranie anonimowych danych dotyczących użycia interfejsu wiersza polecenia. Aby uzyskać informacje o ochronie prywatności, zobacz licencję MIT interfejsu wiersza polecenia platformy Azure.
	only_show_errors	boolean	Pokaż tylko błędy podczas wywołania polecenia. Innymi słowy, tylko błędy są zapisywane w pliku stderr. Pomija ostrzeżenia z wersji zapoznawczej, przestarzałych i eksperymentalnych poleceń. Jest również dostępny dla poszczególnych poleceń z parametrem --only-show-errors .
	no_color	boolean	Wyłącz kolor. Pierwotnie kolorowe wiadomości mają prefiks DEBUG, INFOWARNING i ERROR. Ta wartość logiczna pomija problem biblioteki innej firmy, w której kolor terminalu nie może zostać przywrócony po stdout przekierowaniu.
Klientów	show_secrets_warning	boolean	Włącz/wyłącz ostrzeżenie dotyczące danych wyjściowych informacji poufnych.
logging	enable_log_file	boolean	Włącza lub wyłącza rejestrowanie.
	log_dir	string	Katalog, w którym będą zapisywane dzienniki. Domyślna wartość to ${AZURE_CONFIG_DIR}/logs*.
Ustawienia domyślne	grupa	string	Domyślna grupa zasobów do użycia ze wszystkimi poleceniami.
	lokalizacja	string	Domyślna lokalizacja do użycia ze wszystkimi poleceniami.
	web	string	Domyślna nazwa aplikacji do użycia z poleceniami az webapp.
	vm	string	Domyślna nazwa maszyny wirtualnej do użycia z poleceniami az vm.
	vmss	string	Domyślna nazwa zestawu skalowania maszyn wirtualnych (VMSS) do użycia dla az vmss poleceń.
	acr	string	Domyślna nazwa rejestru kontenerów do użycia z poleceniami az acr.
storage	account	string	Domyślna nazwa konta magazynu (na przykład mystorageaccount w https://mystorageaccount.blob.core.windows.netsystemie ) do użycia dla az storage poleceń płaszczyzny danych (na przykład az storage container list).
	klucz	string	Domyślny klucz dostępu do użycia dla az storage poleceń płaszczyzny danych.
	sas_token	string	Domyślny token SAS do użycia dla az storage poleceń płaszczyzny danych.
	connection_string	string	Domyślna parametry połączenia do użycia w az storage poleceniach płaszczyzny danych.
batchai	storage_account	string	Domyślne konto magazynu do użycia z poleceniami az batchai.
	storage_key	string	Domyślny klucz magazynu do użycia z poleceniami az batchai.
batch	account	string	Domyślna nazwa konta usługi Azure Batch do użycia z poleceniami az batch.
	access_key	string	Domyślny klucz dostępu do użycia z poleceniami az batch. Używany tylko na potrzeby autoryzacji aad.
	endpoint	string	Domyślny punkt końcowy do nawiązywania połączeń na potrzeby poleceń az batch.
	auth_mode	string	Tryb autoryzacji do użycia z poleceniami az batch. Dozwolone wartości: shared_key, aad.
Chmurze	nazwa	string	Domyślna chmura dla wszystkich az poleceń. Dozwolone wartości: AzureCloud (wartość domyślna), AzureChinaCloud, AzureUSGovernment. Aby zmienić chmury, możesz użyć az cloud set –name polecenia . Aby zapoznać się z przykładem, zobacz Zarządzanie chmurami za pomocą interfejsu wiersza polecenia platformy Azure.
Rozszerzenie	use_dynamic_install	string	Zainstaluj rozszerzenie, jeśli nie został jeszcze dodany podczas uruchamiania z niego polecenia. Dozwolone wartości: no (wartość domyślna), yes_prompt, yes_without_prompt.
	run_after_dynamic_install	boolean	Kontynuuj uruchamianie polecenia, gdy rozszerzenie jest instalowane dynamicznie. Wartość domyślna to False.
	index_url	string	Adres URL pliku indeksu rozszerzenia prywatnego zgodnie z formatem w index.json. Po określeniu tego pliku wykonywanie az extension add --name <extension-name> używa tego pliku do znalezienia rozszerzenia do dodania.

Uwaga

W konkretnym pliku konfiguracji mogą występować inne wartości, ale są one zarządzane bezpośrednio za pomocą poleceń interfejsu wiersza polecenia, w tym polecenia az config. Wymienione wcześniej w tabeli są jedynymi wartościami, które należy zmienić samodzielnie.