Azure CLI yapılandırması

  • Makale
  • Okumak için 4 dakika

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, varsayılanların bazılarını yönetmeyi kolaylaştıran bir az config komutunu sağlar. Diğer değerler, bir yapılandırma dosyasında veya ortam değişkenleriyle ayarlanabilir. Bu makalede, bu kullanıcı yapılandırma ayarları ve Azure CLı 'nın nasıl yapılandırılacağı hakkında daha fazla bilgi sağlanmaktadır.

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. Parametresi ile ayarlanmış kalıcı değerler az config param-persist
  3. Ortam değişkenleri
  4. İle yapılandırma dosyası kümesindeki değerler az config

Az config ile CLı yapılandırması

Az config Set komutuyla CLI için varsayılanlar ayarlarsınız. Bu komut key=value bağımsız değişken olarak çiftler için boşlukla ayrılmış bir liste alır. CLI tarafından gerekli bağımsız değişkenler yerine sağlanan değerler kullanılır.

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

Ad Açıklama
Varsayılanlar. Group Tüm komutlar için kullanılacak varsayılan kaynak grubu.
Varsayılanlar. Location Tüm komutlar için kullanılacak varsayılan konum.
Varsayılanlar. Web az webapp komutları için kullanılacak varsayılan uygulama adı.
Varsayılanlar. VM az vm komutları için kullanılacak varsayılan VM adı.
Varsayılanlar. VMSS az vmss komutları için kullanılacak varsayılan sanal makine ölçek kümesi (VMSS) adı.
Varsayılanlar. 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

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. Bu dosya biçimi, bölüm başlıkları ve onları izleyen bir anahtar-değer girdileri listesiyle tanımlanır.

  • 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 değerleri büyük/küçük harfe duyarsızdır ve aşağıdaki değerlerle temsil edilir.

  • 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 varsayılan, core AZURE_CORE_OUTPUT değişkeninde ayarlanır, storage_account için varsayılan değeri batchai AZURE_BATCHAI_STORAGE_ACCOUNT değişkende ayarlanır ve varsayılan olarak location AZURE_DEFAULTS_LOCATION değişkende 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.

Section Ad Tür Description
çekirdeğin çıkış string Varsayılan çıkış biçimi. Şunlardan biri olabilir: json, jsonc, tsv veya table.
disable_confirm_prompt boolean Onay istemlerini açın/kapatın.
collect_telemetry boolean Microsoft’un CLI kullanımıyla ilgili anonim veriler toplamasına izin verin. Gizlilik bilgileri için bkz. Azure CLı MIT Lisansı.
yalnızca _ _ hataları göster boolean Yalnızca komut çağırma sırasında hataları göster. Diğer bir deyişle, yalnızca hatalara yazılacak stderr . Önizleme, kullanım dışı ve deneysel komutlardan gelen uyarıları göstermez. Ayrıca, parametresiyle tek tek komutlar için de kullanılabilir --only-show-errors .
_renk yok boolean Rengi devre dışı bırakın. Başlangıçta renkli iletilerin ön eki DEBUG , ve olur INFO WARNING ERROR . Bu, terminalin renginin yeniden yönlendirmeden sonra geri döndürüleceği bir üçüncü taraf kitaplığı sorununu atlar stdout .
günlüğe kaydetme enable_log_file boolean Günlük kaydını açın/kapatın.
log_dir string Günlüklerin yazılacağı dizin. Varsayılan olarak bu ${AZURE_CONFIG_DIR}/logs* değerine ayarlanır.
varsayılan değerler group string Tüm komutlar için kullanılacak varsayılan kaynak grubu.
location string Tüm komutlar için kullanılacak varsayılan konum.
web string az webapp komutları için kullanılacak varsayılan uygulama adı.
vm string az vm komutları için kullanılacak varsayılan VM adı.
vmss string Komutlar için kullanmak üzere varsayılan sanal makine ölçek kümesi (VMSS) az vmss adı.
acr string az acr komutları için kullanılacak varsayılan kapsayıcı kayıt defteri adı.
Depolama account string Varsayılan depolama hesabı adı (örneğin, veri düzlemi komutları için kullanmak üzere içinde mystorageaccount https://mystorageaccount.blob.core.windows.net) az storage (örneğin, az storage container list ).
anahtar string Veri düzlemi komutları için kullanmak az storage üzere varsayılan erişim anahtarı.
sas_token string Veri düzlemi komutları için kullanmak üzere varsayılan SAS az storage belirteci.
connection_string string Veri düzlemi komutları için kullanmak az storage üzere varsayılan bağlantı dizesi.
batchai storage_account string az batchai komutları için kullanılacak varsayılan depolama hesabı.
storage_key string az batchai komutları için kullanılacak varsayılan depolama anahtarı.
Toplu iş account string az batch komutları için kullanılacak varsayılan Azure Batch hesap adı.
access_key string az batch komutları için kullanılacak varsayılan erişim anahtarı. Yalnızca aad yetkilendirmesiyle kullanılır.
endpoint string az batch komutları için bağlanılacak varsayılan uç nokta.
auth_mode string az batch komutları için kullanılacak yetkilendirme modu. shared_key veya aad olabilir.
Bulut name string Tüm komutlar için varsayılan az bulut. Olası değerler AzureCloud (varsayılan), AzureChinaCloud , , AzureUSGovernment AzureGermanCloud değerleridir. Bulutları değiştirmek için komutunu az cloud set –name kullanabilirsiniz. Örnek için bkz. Azure CLI ile Bulutları Yönetme.
Uzantısı use_dynamic_install string Bir komutu çalıştırarak uzantı henüz eklenmemişse yükleyin. Olası değerler no (varsayılan), yes_prompt , yes_without_prompt değerleridir.
run_after_dynamic_install boolean Bir uzantı için dinamik olarak yüklenirken komutunu çalıştırmaya devam eder. False varsayılan değerdir.

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. Yalnızca üstteki listede yer alan değerleri kendiniz değiştirmelisiniz.

Ayrıca bkz.