Udostępnij za pośrednictwem

Konfiguracja interfejsu wiersza polecenia platformy Azure

  • Artykuł

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 core batchai 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 .
enable_broker_on_windows boolean Użyj menedżera kont sieci Web (WAM), aby uwierzytelnić się na platformie Azure za pomocą az login polecenia .
login_experience_v2 boolean az login Włącz/wyłącz selektor subskrypcji.
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.