Azure CLI Uzantılarını Yönetme: Yükleme, Güncelleştirme ve Kaldırma

Azure CLI, uzantıları yükleme olanağı sunar. Azure CLI uzantıları, CLI'nin bir parçası olarak gönderilmemiş ancak CLI komutları olarak çalıştırılan Python tekerlekleri olarak nitelendirilir. Uzantılarla, deneysel ve yayın öncesi komutlara ve kendi CLI arabirimlerinizi yazma olanağına sahip olursunuz. Bu makale, uzantıları yönetmeyi kapsar ve kullanımları hakkında sık sorulan soruları yanıtlar.

Uzantıları bulma

Microsoft tarafından sağlanan ve bakımı yapılan Azure CLI uzantılarını görmek için az extension list-available komutunu kullanın.

az extension list-available --output table

Ayrıca belge sitesinde uzantıların listesini de barındırıyoruz.

Uzantıları yükleme

Uzantıları el ile yükleme

Yüklenecek uzantıyı buldukktan sonra, yüklemek için az extension add komutunu kullanın. Uzantı çıktısında az extension list-availablegörünüyorsa, adıyla yükleyebilirsiniz.

az extension add --name <extension-name>

Uzantı bir dış kaynaktan geliyorsa veya uzantıya yönelik doğrudan bağlantınız varsa, kaynak URL’sini veya yerel yolu sağlayın. Uzantı derlenmiş bir Python tekerlek dosyası olmalıdır .

az extension add --source <URL-or-path>

ayrıca ,index.jsonbiçiminden sonra özel bir uzantı dizini oluşturabilir ve ardından Azure CLI tarafından kullanılan uzantı dizini URL'sini sürümünden 2.20.0başlayarak buna ayarlayabilirsiniz. Bundan sonra, uzantıyı özel uzantı dizininden ada göre yükleyebilirsiniz.

az config set extension.index_url=<URL>
az extension add --name <extension-name>

Bir uzantıyı yükledikten sonra, kabuk değişkeninin değerinin $AZURE_EXTENSION_DIR altında görünür. Bu değişken ayarlanmamışsa, varsayılan konum Linux ve macOS'ta ve %USERPROFILE%\.azure\cliextensions Windows'tadır$HOME/.azure/cliextensions.

Uzantıları otomatik olarak yükleme

Yüklü olmayan bir uzantı komutu çalıştırdığınızda, Azure CLI çalıştırdığınız komutu tanıyabilir ve sürümünden 2.10.0başlayarak uzantıyı sizin için otomatik olarak yükleyebilir. Dinamik yükleme olarak bilinen bu özellik, sürümünden 2.12.0itibaren varsayılan olarak etkindir. Ayrıca, önceki desteklenen sürümler için yapılandırma aracılığıyla da etkinleştirebilirsiniz.

az config set extension.use_dynamic_install=yes_prompt

İstem olmadan dinamik yüklemeyi etkinleştirmek için aşağıdaki yapılandırma komutunu kullanın.

az config set extension.use_dynamic_install=yes_without_prompt

Varsayılan davranışa geri dönmek üzere dinamik yükleme özelliğini kapatmak için aşağıdaki yapılandırma komutunu kullanın. Uzantı yüklü değilse uzantı komutu bulunamadı hatası döndürür.

az config set extension.use_dynamic_install=no

Varsayılan olarak, dinamik yükleme isteyen bir uzantı komutu, uzantı yüklendikten sonra çalışmaya devam eder. Varsayılan davranışı değiştirebilir ve komutun yeniden çalıştırılmadan çıkış yapmasını sağlamak için run_after_dynamic_install özelliğini no olarak ayarlayabilirsiniz.

az config set extension.run_after_dynamic_install=no

Uzantıları güncelleştirme

Bir uzantıyı ada göre yüklerseniz, bu uzantıyı güncellemek için az extension update komutunu kullanın.

az extension update --name <extension-name>

Aksi takdirde uzantı yükleme yönergeleri izlenerek bir uzantı kaynaktan güncelleştirilebilir.

Uzantı adını çözümlemek için CLI'yi kullanamıyorsanız uzantıyı kaldırın ve yeniden yüklemeyi deneyin. Uzantı, temel CLI'nin bir parçası da olabilir. CLI'yi Azure CLI'yi yükleme bölümünde açıklandığı gibi güncelleştirin ve uzantı komutlarının kullanılabilir olup olmadığını denetleyin.

Uzantıları kaldırma

Artık bir uzantıya ihtiyacınız yoksa az extension remove ile uzantıyı kaldırın.

az extension remove --name <extension-name>

Ayrıca, uzantıyı yüklendiği konumdan silerek el ile de kaldırabilirsiniz. $AZURE_EXTENSION_DIR Kabuk değişkeni modüllerin yüklendiği yeri tanımlar. Bu değişken ayarlanmadıysa, değer varsayılan olarak Linux ve macOS’ta $HOME/.azure/cliextensions, Windows’da %USERPROFILE%\.azure\cliextensions olur.

rm -rf $AZURE_EXTENSION_DIR/<extension-name>

Sıkça Sorulan Sorular

CLI uzantılarıyla ilgili diğer sık sorulan soruların yanıtlarını burada bulabilirsiniz.

Yükleme için hangi dosya biçimlerine izin verilir?

Şu anda uzantı olarak yalnızca derlenmiş Python tekerlekleri yüklenebilir.

Uzantılar mevcut komutların yerini alabilir mi?

Evet. Uzantılar mevcut komutların yerini alabilir, ancak CLI değiştirilen bir komutu çalıştırmadan önce bir uyarı görüntüler.

Uzantının ön sürümde olup olmadığını nasıl anlayabilirim?

Uzantının belgeleri ve sürüm oluşturma, ön sürümde olup olmadığını gösterir. Microsoft genellikle önizleme komutlarını CLI uzantısı olarak yayınlar ve bunları daha sonra ana CLI ürününe taşıma seçeneği sunulur. Komutlar uzantılardan taşındığında eski uzantı kaldırılmalıdır.

Uzantılar birbirine bağımlı olabilir mi?

Hayır. CLI bir yük sırasını garanti etmediğinden bağımlılıklar karşılanmayabilir. Uzantının kaldırılması diğerlerini etkilemez.

Uzantılar CLI ile birlikte güncelleştirildi mi?

Hayır. Uzantılar, Güncelleştirme uzantıları bölümünde açıklandığı gibi ayrı olarak güncelleştirilmelidir.

Kendi uzantımızı nasıl geliştirebilirsiniz?

Daha fazla yardım için resmi depoya bakın. Azure/azure-cli-extensions