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, Azure CLI yüklemenizi güncel tutmanızı kolaylaştırır. Azure CLI paketi için macOS 13 veya üzeri gerekir.

Azure CLI'nın geçerli sürümü 2.81.0'dır. 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, Azure 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 homebrew yoksa devam etmeden önce homebrew uygulamasını 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

Azure CLI'yi Homebrew aracılığıyla yüklerken bir sorunla karşılaşırsanız, bazı yaygın hatalar aşağıdadır. 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 küçük sürüm uyumsuzluğu veya başka bir sorun olabilir. Azure CLI bir Python sanal ortamı 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

Azure CLI sürüm 1.x yüklü

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 kullanacak ş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 CLI ile Azure hizmetlerine 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 gerekir. 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

Azure CLI düzenli olarak hata düzeltmeleri, iyileştirmeler, yeni özellikler ve önizleme işlevleriyle güncelleştirilir. Ayda yaklaşık bir kez yeni bir sürüm 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. Azure CLI'nin 2.11.0 sürümünden önceki sürümleri için, Azure CLI'yi Yükleme bölümünde açıklandığı şekilde yeniden yükleyerek güncelleyin.

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 verirseniz, gittiğinize üzüldük. Kaldırmadan önce az feedback komutunu kullanarak nelerin iyileştirilebileceğini veya düzeltilebileceğini bize bildirin. Hedefimiz Azure CLI'yi hatasız ve kullanıcı dostu hale getirmektir. Bir hata bulduysanız, bir GitHub sorunu açarsanızçok 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öneticisi kullanılması ö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, özelliklere ve yaygın komutlara kısa bir tur atın.

Azure CLI'yı kullanmaya başlama