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önderilmemiş ancak CLI komutları olarak çalıştırılan Python tekerlekleri olarak nitelenir. Uzantılarla deneysel ve yayın öncesi komutlara erişim elde eder ve kendi CLI arabirimlerinizi yazabilirsiniz. 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 index.json biç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, özel uzantı dizininden uzantıyı ada göre 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ü olmayan bir uzantı komutu çalıştırdığınızda, Azure CLI çalıştırdığınız komutu tanıyabilir ve uzantıyı sürümünden 2.10.0başlayarak sizin için otomatik olarak yükleyebilir. Dinamik yükleme olarak adlandırılan bu özellik, özelliğinden itibaren 2.12.0varsayılan olarak etkindir. Ö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

Dinamik yüklemeyi istem olmadan 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 özelliğini noolarak ayarlayarak komutun yeniden çalıştırılmadan çıkış yapmasını run_after_dynamic_install sağlayabilirsiniz.

az config set extension.run_after_dynamic_install=no

Uzantıları güncelleştirme

Uzantıyı ada göre yüklerseniz 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.

Uzantı adını çözümlemek için CLI kullanamıyorsanız, uzantıyı kaldırın ve 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 komutu çalıştırmadan önce CLI bir uyarı oluşturur.

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

Uzantının belgeleri ve sürümü, ön sürümde 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. Uzantıyı kaldırmak diğerlerini 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ştirebiliriz?

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