Azure CLI ile uzantıları kullanma ve yönetme

Azure CLI, uzantıları yükleme olanağı sunar. Azure CLI uzantıları, CLI'nın bir parçası olarak gönderilen ancak CLI komutları olarak çalıştır edilen Python tekerlekleri olarak nitelendir edilir. Uzantılar sayesinde deneysel ve yayın öncesi komutlarına erişimle birlikte kendi CLI arabirimlerinizi yazma olanağına da 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

Belgeler sitesinde uzantıların listesini de tutuyoruz.

Uzantıları yükleme

Uzantıları el ile yükleme

Yükleyeceğiniz bir uzantı bulduktan sonra bu uzantıyı almak için az extension add komutunu kullanın. Uzantı, az extension list-available içinde listelenmişse uzantıyı 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. Bu uzantının derlenmiş bir Python tekerlek dosyası olması gerekir.

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

Ayrıca, sürümünden başlayarak Azure CLI tarafından kullanılan uzantı dizini URL'siniindex.jsbiçiminden sonra özel bir uzantı dizini de kurabilirsiniz. 2.20.0 Bundan sonra, uzantıyı özel uzantı dizininden adıyla yükleyebilirsiniz.

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

Bir uzantı yüklendiğinde, $AZURE_EXTENSION_DIR kabuk değişkeni değeri altında bulunur. Bu değişken ayarlanmadıysa, değer varsayılan olarak Linux ve macOS’ta $HOME/.azure/cliextensions, Windows’da %USERPROFILE%\.azure\cliextensions olur.

Uzantıları otomatik olarak yükleme

Yüklü olan bir uzantı komutunu çalıştırarak Azure CLI, çalıştırmış olduğunuz komutu tanıyıp sürümünden başlayarak uzantıyı sizin için otomatik olarak 2.10.0 yükleyebilir. Dinamik yükleme olarak adlandırılan bu özellik, 'den itibaren varsayılan olarak etkindir. 2.12.0 Ö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 extension komutu komut bulunamadı hatası döndürür.

az config set extension.use_dynamic_install=no

Varsayılan olarak, dinamik yükleme isteminde bir uzantı komutu, uzantı yüklendikten sonra çalışmaya devam eder. Varsayılan davranışı değiştirebilir ve özelliğini olarak ayarerek komutu yeniden çalıştırmadan run_after_dynamic_install çıkışa no çıkarabilirsiniz.

az config set extension.run_after_dynamic_install=no

Uzantıları güncelleştirme

Ada göre bir uzantı yüklendiyse, az extension update komutunu kullanarak güncelleştirin.

az extension update --name <extension-name>

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

Bir uzantı adı CLI tarafından çözümlenemezse bu uzantıyı kaldırıp yeniden yüklemeyi deneyin. Uzantı, temel CLI'nın bir parçası haline de gelebilir. CLI’yı Azure CLI'yi yükleme bölümünde açıklandığı gibi güncelleştirmeyi deneyin ve uzantı komutlarının eklenip eklenmediğine bakın.

Uzantıları kaldırma

Bir uzantıya artık ihtiyaç duymuyorsanız, uzantıyı az extension remove komutuyla kaldırın.

az extension remove --name <extension-name>

Ayrıca uzantıyı yüklendiği konumdan silerek el ile kaldırmak da mümkündür. $AZURE_EXTENSION_DIR kabuk değişkeni modüllerin nereye yüklendiğini 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>

SSS

CLI uzantıları hakkında sık sorulan diğer bazı soruların yanıtları aşağıdadır.

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

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

Uzantılar mevcut komutların yerini alabilir mi?

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

Bir uzantının yayın öncesi sürümde olduğunu nereden anlayabilirim?

Uzantının belgeleri ve sürümleri, bunun yayın öncesi olup olmadığını gösterir. Microsoft genellikle önizleme komutlarını CLI uzantıları olarak kullanıma sunar ve bunları daha sonra ana CLI ürününe taşıma seçeneğini sağlar. Komutlar uzantıların dışına taşındığında eski uzantılar kaldırılmalıdır.

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

Hayır. CLI bir yükleme sırası garanti etmediği için bağımlılıklar yerine getirilemeyebilir. Bir uzantının kaldırılması diğer uzantıların hiçbirini etkilemez.

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

Hayır. Uzantıların Uzantıları güncelleştirme bölümünde açıklandığı şekilde ayrı olarak güncelleştirilmesi gerekir.

Kendi uzantımızı nasıl geliştireceğiz?

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