Azure CLI yapılandırması

  • Makale

Azure CLI kullanıcının günlük, veri koleksiyonu ve varsayılan bağımsız değişken değerleri gibi ayarları yapılandırması sağlar. CLI, az configbazı varsayılanları yönetmek için bir kolaylık komutu ve aracılığıyla az initetkileşimli bir seçenek sunar. Diğer değerler, bir yapılandırma dosyasında veya ortam değişkenleriyle ayarlanabilir. Bu makale, bu kullanıcı yapılandırma ayarları ve Azure CLI'nın nasıl yapılandırılıp yapılandırılması hakkında daha fazla bilgi sağlar.

CLI tarafından kullanılan yapılandırma değerleri aşağıdaki öncelik sırasına göre, üsttekiler öncelikli olacak şekilde değerlendirilir.

  1. Komut satırı parametreleri
  2. Ortam değişkenleri
  3. veya ile az config ayarlanan yapılandırma dosyasındaki değerler az init

az init kullanarak ayarları yapılandırma

Azure CLI yapılandırmalarını ayarlamanın en kolay yolu etkileşimli az init komutunu kullanmaktır. "Etkileşim" veya "otomasyon" gibi yaygın bir yapılandırma seçin veya tek tek yapılandırmaları gözden geçirmeyi tercih edin. Bu yaklaşımda özellikle yararlı olan, az init bir yapılandırma seçeneğini diğerine tercih etmek istemenize neden olan nedenleri sağlar.

az init

az config kullanarak ayarları yapılandırma

CLI için varsayılanları az config set komutuyla ayarlayabilirsiniz . Bu komut, bağımsız değişken olarak boşlukla ayrılmış çiftler key=value listesini alır. Sağlanan değerler, gerekli bağımsız değişkenler yerine Azure CLI tarafından kullanılır.

Aşağıdaki tablo, kullanılabilir yapılandırma anahtarlarının listesini içerir.

Veri Akışı Adı Açıklama
defaults.group Tüm komutlar için kullanılacak varsayılan kaynak grubu.
defaults.location Tüm komutlar için kullanılacak varsayılan konum.
defaults.web az webapp komutları için kullanılacak varsayılan uygulama adı.
defaults.vm az vm komutları için kullanılacak varsayılan VM adı.
defaults.vmss Komutlar için az vmss kullanılacak varsayılan sanal makine ölçek kümesi (VMSS) adı.
defaults.acr az acr komutları için kullanılacak varsayılan kapsayıcı kayıt defteri adı.

Aşağıda, örnek olarak tüm gruplar için varsayılan kaynak grubu ve konumun nasıl ayarlanacağı açıklanmıştır.

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

Aşağıdaki komut, Azure CLI komutlarını yürütürken anket bağlantılarını kapatır:

az config set output.show_survey_link=no

CLI yapılandırma dosyası

CLI yapılandırma dosyası, CLI davranışının yönetimi için kullanılan diğer ayarları içerir. Yapılandırma dosyasının kendisi şu konumdadır: $AZURE_CONFIG_DIR/config. Varsayılan AZURE_CONFIG_DIR değeri Linux ve macOS’ta $HOME/.azure, Windows’da %USERPROFILE%\.azure şeklindedir.

Yapılandırma dosyaları INI dosya biçiminde yazılır. Bölüm üst bilgileri, dosya biçimini ve ardından anahtar-değer girdilerinin listesini tanımlar.

  • Bölüm başlıkları [section-name] olarak yazılır. Bölüm adları büyük/küçük harfe duyarlıdır.
  • Girdiler key=value olarak yazılır. Anahtar adları büyük/küçük harfe duyarlı değildir.
  • Açıklamalar, # veya ; ile başlayan tüm satırlardır. Satır içi açıklamalara izin verilmez.

Boole'lar büyük/küçük harfe duyarlı değildir. Aşağıdaki değerler boole değerlerini temsil eder:

  • Doğru: 1, yes, true, on
  • Yanlış: 0, no, false, off

Burada, tüm onay istemlerini devre dışı bırakan ve /var/log/azure dizinine günlük kaydı ayarlayan bir CLI yapılandırma dosyası örneği sağlanmıştır.

[core]
disable_confirm_prompt=Yes

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

Kullanılabilen tüm yapılandırma değerleri ve bunları ne anlama geldiği hakkında ayrıntılı bilgi edinmek için bir sonraki bölüme bakın. INI dosya biçimiyle ilgili tüm ayrıntılar için bkz. INI ile ilgili Python belgeleri.

CLI yapılandırma değerleri ve ortam değişkenleri

Aşağıdaki tablo, bir yapılandırma dosyasına eklenebilecek tüm bölümleri ve seçenek adlarını içerir. Bunlara karşılık gelen ortam değişkenleri, tamamı büyük harf olacak şekilde AZURE_{section}_{name} olarak ayarlanır. Örneğin, output için core varsayılan değeri değişkende AZURE_CORE_OUTPUT ayarlanır, storage_account için batchai varsayılan değeri değişkende AZURE_BATCHAI_STORAGE_ACCOUNT ayarlanır ve varsayılan location değişkende AZURE_DEFAULTS_LOCATION ayarlanır.

Varsayılan bir değer sağladığınızda bu bağımsız değişken artık herhangi bir komut için gerekli olmaz. Bunun yerine varsayılan değer kullanılır.

Bölüm Adı Tür Açıklama
çekirdek çıkış Dize Varsayılan çıkış biçimi. İzin verilen değerler: json (varsayılan), jsonc, yaml, yamlc, table, tsv, none. Daha fazla bilgi için bkz . Azure CLI komutları için çıkış biçimleri.
disable_confirm_prompt boolean Onay istemlerini açın/kapatın.
display_region_identified boolean Azure müşterileri birçok farklı bölgede kaynak dağıtmayı seçebilir. Bazı durumlarda müşteriler aynı hizmetleri sunan yakın bölgeleri seçerek maliyetleri düşürebilir. Yakınlardaki bir bölge tanımlanırsa, gelecekteki dağıtımlar için seçilecek bölge bir ileti görüntülenir. Bu ayar, iletinin görüntülenip görüntülenmediğini denetler.
collect_telemetry boolean Microsoft’un CLI kullanımıyla ilgili anonim veriler toplamasına izin verin. Gizlilik bilgileri için bkz . Azure CLI MIT lisansı.
only_show_errors boolean Yalnızca komut çağırma sırasında hataları göster. Başka bir deyişle, yalnızca hatalar öğesine stderryazılır. Önizleme, kullanım dışı ve deneysel komutlardan gelen uyarıları gizler. Parametresine sahip --only-show-errors tek tek komutlar için de kullanılabilir.
no_color boolean Rengi devre dışı bırakın. Başlangıçta renkli iletiler , INFOWARNING ve ERRORön eklerine eklenirDEBUG. Bu boole değeri, terminalin renginin yeniden yönlendirmeden sonra stdout geri dönememe sorununu atlar.
Istemci show_secrets_warning boolean Hassas bilgi çıkışı için uyarıyı açın/kapatın.
logging enable_log_file boolean Günlük kaydını açın/kapatın.
log_dir Dize Günlüklerin yazılacağı dizin. Varsayılan olarak bu ${AZURE_CONFIG_DIR}/logs* değerine ayarlanır.
Varsayılan group Dize Tüm komutlar için kullanılacak varsayılan kaynak grubu.
konum Dize Tüm komutlar için kullanılacak varsayılan konum.
web Dize az webapp komutları için kullanılacak varsayılan uygulama adı.
vm Dize az vm komutları için kullanılacak varsayılan VM adı.
vmss Dize Komutlar için az vmss kullanılacak varsayılan sanal makine ölçek kümesi (VMSS) adı.
acr Dize az acr komutları için kullanılacak varsayılan kapsayıcı kayıt defteri adı.
storage account Dize Veri düzlemi komutları için kullanılacak varsayılan depolama hesabı adı (örneğin, içindeki mystorageaccounthttps://mystorageaccount.blob.core.windows.net).az storageaz storage container list
anahtar Dize Veri düzlemi komutları için az storage kullanılacak varsayılan erişim anahtarı.
sas_token Dize Veri düzlemi komutları için az storage kullanılacak varsayılan SAS belirteci.
connection_string Dize Veri düzlemi komutları için az storage kullanılacak varsayılan bağlantı dizesi.
batchai storage_account Dize az batchai komutları için kullanılacak varsayılan depolama hesabı.
storage_key Dize az batchai komutları için kullanılacak varsayılan depolama anahtarı.
batch account Dize az batch komutları için kullanılacak varsayılan Azure Batch hesap adı.
access_key Dize az batch komutları için kullanılacak varsayılan erişim anahtarı. Yalnızca aad yetkilendirmesiyle kullanılır.
endpoint Dize az batch komutları için bağlanılacak varsayılan uç nokta.
auth_mode Dize az batch komutları için kullanılacak yetkilendirme modu. İzin verilen değerler: shared_key, aad.
Bulut Adı Dize Tüm az komutlar için varsayılan bulut. İzin verilen değerler: AzureCloud (varsayılan), AzureChinaCloud, AzureUSGovernment. Bulutları değiştirmek için komutunu kullanabilirsiniz az cloud set –name . Örnek için bkz . Azure CLI ile Bulutları Yönetme.
Uzantısı use_dynamic_install Dize Bir komutu çalıştırırken henüz eklenmediyse uzantıyı yükleyin. İzin verilen değerler: no (varsayılan), yes_prompt, yes_without_prompt.
run_after_dynamic_install boolean Bir uzantı için dinamik olarak yüklendiğinde komutunu çalıştırmaya devam edin. Varsayılan False değeridir.
index_url Dize index.json biçiminden sonra özel uzantı dizin dosyasının URL'si. Belirtildikten sonra yürütülürken az extension add --name <extension-name> , eklenecek uzantıyı bulmak için bu dosya kullanılır.

Not

Yapılandırma dosyanızdaki diğer değerleri görebilirsiniz, ancak bunlar az config komutunun da dahil olduğu CLI komutları aracılığıyla doğrudan yönetilir. Daha önce tabloda listelenenler, kendi değiştirmeniz gereken tek değerlerdir.