Udostępnij przez

Konfiguracja interfejsu wiersza polecenia platformy Azure

Interfejs wiersza polecenia platformy Azure umożliwia konfigurowanie 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 ze zmiennymi środowiskowymi. 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ą oceniane w następującym pierwszeństwie, a elementy wyższe na liście mają priorytet.

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

Konfigurowanie ustawień używając 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, które dostarcza powodów, dlaczego warto wybrać jedną opcję konfiguracji zamiast innej.

az init

Konfigurowanie ustawień przy użyciu polecenia az config

Domyślne ustawienia dla CLI 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 Opis
domyślne.grupa Domyślna grupa zasobów do użycia dla wszystkich poleceń.
domyślne.miejsce Domyślna lokalizacja do użycia dla wszystkich poleceń.
defaults.web Domyślna nazwa aplikacji do użycia dla az webapp poleceń.
defaults.vm Domyślna nazwa maszyny wirtualnej do użycia dla az vm poleceń.
defaults.vmss Domyślna nazwa zestawu skalowania maszyn wirtualnych (VMSS) do użycia w poleceniach az vmss.
defaults.acr Domyślna nazwa rejestru kontenerów dla poleceń az acr.

Na przykład poniżej przedstawiono 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 dezaktywuje odnośniki do ankiet podczas wykonywania poleceń Azure CLI:

az config set core.survey_message=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 lokalizacji $AZURE_CONFIG_DIR/config. Wartość domyślna AZURE_CONFIG_DIR to $HOME/.azure w systemach Linux i macOS oraz %USERPROFILE%\.azure w systemie Windows.

Pliki konfiguracji są zapisywane w formacie pliku INI. Nagłówki sekcji definiują format pliku, po czym następuje lista wpisów klucz-wartość.

  • Nagłówki sekcji są zapisywane jako [section-name]. W nazwach sekcji jest rozróżniana wielkość liter.
  • Wpisy są zapisywane jako key=value. W nazwach kluczy nie jest uwzględniana wielkość liter.
  • Komentarze to dowolny wiersz rozpoczynający się od # lub ;. Komentarze wbudowane nie są dozwolone.

Wartości logiczne nie są uzależnione od wielkości liter. Następujące wartości to booleany.

  • Prawda: 1, yes, true, on
  • Fałsz: 0, no, false, off

Oto przykład pliku konfiguracji CLI, który wyłącza wszelkie monity o potwierdzenie i konfiguruje rejestrowanie do katalogu /var/log/azure.

[core]
disable_confirm_prompt=Yes

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

Zobacz następną sekcję, aby uzyskać szczegółowe informacje na temat wszystkich dostępnych wartości konfiguracji i ich znaczenia. Aby uzyskać szczegółowe informacje na temat formatu pliku INI, zobacz dokumentację języka Python dotyczącą ini.

Wartości konfiguracji interfejsu wiersza polecenia i zmienne środowiskowe

Poniższa tabela zawiera wszystkie sekcje i nazwy opcji, które można umieścić w pliku konfiguracji. Ich odpowiednie zmienne środowiskowe są ustawiane jako AZURE_{section}_{name}, we wszystkich limitach. Na przykład output wartość domyślna parametru jest ustawiana w zmiennej, core wartość domyślna AZURE_CORE_OUTPUTstorage_account parametru batchai 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 tego jest używana wartość domyślna.

Sekcja Nazwa Typ Opis
rdzeń wynik sznurek 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.
wyłącz potwierdzenie monitu typ logiczny (boolowski) Włącz/wyłącz monity o potwierdzenie.
wyświetl_rozpoznany_region typ logiczny (boolowski) 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.
zbierz_telemetrię typ logiczny (boolowski) Zezwól 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.
tylko_pokaż_błędy typ logiczny (boolowski) 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 .
włącz_broker_na_windows typ logiczny (boolowski) Użyj menedżera kont sieci Web (WAM), aby uwierzytelnić się na platformie Azure za pomocą az login polecenia .
login_experience_v2 - doświadczenie logowania wersja 2 typ logiczny (boolowski) az login Włącz/wyłącz selektor subskrypcji.
bez koloru typ logiczny (boolowski) Wyłącz kolor. Pierwotnie kolorowe wiadomości mają prefiks DEBUG, INFOWARNING i ERROR. Ten bool rozwiązuje problem biblioteki zewnętrznej, w którym kolor w terminalu nie może zostać przywrócony po stdout przekierowaniu.
Klienci pokaż_ostrzeżenie_o_sekretach typ logiczny (boolowski) Włącz/wyłącz ostrzeżenie dotyczące wyświetlania informacji wrażliwych.
rejestrowanie włącz_plik_logu typ logiczny (boolowski) Włącz/wyłącz rejestrowanie.
katalog_logów sznurek Katalog do zapisywania dzienników. Domyślnie ta wartość to ${AZURE_CONFIG_DIR}/logs*.
Ustawienia domyślne grupa sznurek Domyślna grupa zasobów do użycia dla wszystkich poleceń.
lokalizacja sznurek Domyślna lokalizacja do użycia dla wszystkich poleceń.
sieć sznurek Domyślna nazwa aplikacji do użycia dla az webapp poleceń.
Vm sznurek Domyślna nazwa maszyny wirtualnej do użycia dla az vm poleceń.
vmss sznurek Domyślna nazwa zestawu skalowania maszyn wirtualnych (VMSS) do użycia w poleceniach az vmss.
acr sznurek Domyślna nazwa rejestru kontenerów dla poleceń az acr.
przechowywanie konto sznurek Domyślna nazwa konta magazynu (na przykład mystorageaccount w https://mystorageaccount.blob.core.windows.net), do użycia przy poleceniach płaszczyzny danych (na przykład az storage).
klucz sznurek Domyślny klucz dostępu do użycia dla az storage poleceń płaszczyzny danych.
sas_token sznurek Domyślny token SAS do użycia dla az storage poleceń płaszczyzny danych.
ciąg znaków połączenia sznurek Domyślne parametry połączenia używane w komendach związanych z płaszczyzną danych az storage.
batchai konto magazynu sznurek Domyślne konto magazynu do użycia dla az batchai poleceń.
klucz_magazynu sznurek Domyślny klucz magazynu do użycia dla poleceń az batchai.
partia konto sznurek Domyślna nazwa konta Azure Batch do użycia w poleceniach az batch.
klucz dostępu sznurek Domyślny klucz dostępu używany do poleceń az batch. Używane tylko z autoryzacją aad .
punkt końcowy sznurek Domyślny punkt końcowy do nawiązania połączenia dla az batch poleceń.
tryb_autoryzacji sznurek Tryb autoryzacji, który ma być używany dla poleceń az batch. Dozwolone wartości: shared_key, aad.
chmura nazwa sznurek 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 użyj_dynamicznej_instalacji sznurek Zainstaluj rozszerzenie, jeśli nie zostało jeszcze dodane, gdy uruchamiasz polecenie z niego. Dozwolone wartości: no (wartość domyślna), yes_prompt, yes_without_prompt.
uruchom_po_dynamicznej_instalacji typ logiczny (boolowski) Kontynuuj uruchamianie polecenia, gdy rozszerzenie jest instalowane dynamicznie. Wartość domyślna to False.
index_url sznurek Adres URL pliku indeksowego rozszerzenia prywatnego w formacie index.json. Po określeniu, wykonywanie az extension add --name <extension-name> używa tego pliku do zidentyfikowania rozszerzenia, które ma zostać dodane.

Uwaga / Notatka

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

  • Last updated on