Aracılığıyla paylaş


macOS’ta Azure CLI'yi yükleme

Azure Command-Line Arabirimi (CLI), macOS bilgisayarlara yerel olarak yüklenebilen platformlar arası bir komut satırı aracıdır. Azure'a bağlanmak ve etkileşimli komut satırı istemleri veya betik kullanarak Azure kaynaklarında yönetim komutları yürütmek için Azure CLI'yi kullanabilirsiniz.

macOS platformu içinhomebrew paket yöneticisi ile Azure CLI'yı yükleyin. Homebrew, CLI yüklemenizin güncel tutulmasını kolaylaştırır. CLI paketi, macOS 10.9 ve üzeri sürümlerinde test edilmiştir.

Azure CLI'nın geçerli sürümü 2.70.0. En son sürüm hakkında bilgi edinmek için sürüm notlarına bakın. Yüklü sürümünüzü bulmak ve güncelleştirmeniz gerekip gerekmediğini görmek için az version komutunu çalıştırın.

Homebrew ile yükleme

Homebrew, CLI yüklemenizi yönetmenin en kolay yoludur. Yüklemek, güncelleştirmek ve kaldırmak için kullanışlı yöntemler sağlar. Sisteminizde kullanılabilir homebrew yoksa devam etmeden önce homebrew yükleyin.

Brew depo bilgilerinizi güncelleyerek ve ardından install komutunu çalıştırarak macOS kullanarak Azure CLI'yı yükleyebilirsiniz.

brew update && brew install azure-cli

Sorun giderme

Homebrew aracılığıyla CLI’yı yüklerken bir sorunla karşılaşırsanız, bazı yaygın hatalar burada verilmiştir. Burada ele alınmayan bir sorunla karşılaşırsanız GitHub'da bir sorun oluşturun.

Tamamlama çalışmıyor

Azure CLI'nın Homebrew formülü, Homebrew tarafından yönetilen tamamlamalar dizininde adlı az bir tamamlama dosyası yükler (varsayılan konumdur /usr/local/etc/bash_completion.d/). İşlemin tamamlanmasını etkinleştirmek için Homebrew'un buradaki yönergelerini izleyin.

Zsh için dosyanızın .zshrc en altına aşağıdaki iki satırı ekleyin, ardından Zsh profilinizi kaydedin ve yeniden yükleyin.

autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az

Python veya yüklü paketler bulunamıyor

Homebrew yüklemesi sırasında ikincil sürüm uyuşmazlığıyla veya başka sorunlarla karşılaşabilirsiniz. CLI, Python sanal ortamını kullanmaz. Bu nedenle yüklü Python sürümünü bulmaya dayanır. Olası bir düzeltme, Homebrew'dan python@3.10 bağımlılığını yüklemek ve yeniden bağlamaktır.

brew update && brew install python@3.10 && brew upgrade python@3.10
brew link --overwrite python@3.10

CLI 1.x sürümü yükleniyor

Güncel olmayan bir sürüm yükleniyorsa bu, eski bir homebrew önbelleğinden kaynaklanıyor olabilir. Güncelleştirme yönergelerini izleyin.

Proxy bağlantıyı engelliyor

Proxy'nizi kullanmak üzere doğru şekilde yapılandırmadığınız sürece Homebrew'dan kaynak alamayabilirsiniz. Homebrew proxy yapılandırma yönergelerini izleyin.

Önemli

Bir proxy sunucunun arkasındaysanız, Azure hizmetlerine CLI ile bağlanmak için HTTP_PROXY ve HTTPS_PROXY ayarlanmalıdır. Temel kimlik doğrulaması kullanmıyorsanız, bu değişkenleri dosyanızda dışarı aktarmanız .bashrc önerilir. her zaman işletmenizin güvenlik ilkelerini ve sistem yöneticinizin gereksinimlerini izleyin.

Homebrew'dan şişe kaynaklarını almak için proxy'nizin aşağıdaki adreslere HTTPS bağlantılarına izin vermesi gerekir:

  • https://formulae.brew.sh
  • https://homebrew.bintray.com

Güncelleştir

CLI hata düzeltmeleri, geliştirmeler, yeni özellikler ve önizleme işlevleriyle düzenli olarak güncelleştirilir. Yeni bir sürüm yaklaşık olarak üç haftada bir kullanılabilir.

2.11.0 sürümünden itibaren Azure CLI, en son sürüme güncelleştirmek için araç içi bir komut sağlar.

az upgrade

Bu komut ayrıca tüm yüklü uzantıları varsayılan olarak güncelleştirir. az upgrade Diğer seçenekler için komut başvuru sayfasına bakın. 2.11.0 öncesi Azure CLI sürümleri için, Azure CLI'yi yükleme bölümünde açıklandığı gibi yeniden yükleyerek güncelleştirin.

Ayrıca yerel Homebrew depo bilgilerinizi güncelleştirebilir ve paketi yükseltebilirsiniz azure-cli .

brew update && brew upgrade azure-cli

Kaldır

Azure CLI’yı kaldırmaya karar verdiyseniz, ayrıldığınız için üzgünüz. Kaldırmadan önce, az feedback komutunu kullanarak nelerin geliştirilebileceğini veya düzeltilebileceğini bize bildirin. Amacımız, Azure CLI’yı hatasız ve kullanımı kolay hale getirmektir. Hata bulduysanız bir GitHub sorunu oluşturarak bize bildirirseniz seviniriz.

azure-cli paketini kaldırmak için homebrew kullanın.

brew uninstall azure-cli

Verileri kaldırma

Azure CLI'yı yeniden yüklemeyi planlamıyorsanız verilerini kaldırın.

rm -rf ~/.azure

Diğer yükleme yöntemleri

Ortamınıza Azure CLI yüklemek için homebrew kullanamıyorsanız, Linux için el ile yönergeleri kullanabilirsiniz. Bu işlem resmi olarak macOS ile uyumlu olacak şekilde korunmaz. Homebrew gibi bir paket yöneticisinin kullanılması her zaman önerilir. El ile yükleme yöntemini yalnızca başka bir seçeneğiniz yoksa kullanın.

El ile yükleme yönergeleri için bkz . Linux'ta Azure CLI'yi el ile yükleme.

Sonraki Adımlar

Azure CLI'yi macOS'a yüklediğinize göre özellikleri ve yaygın komutları için kısa bir tur yapın.