Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Bu makalede, Azure CLI'nin Linux'a nasıl yükleneceği açıklanmaktadır. Sayfanın üst kısmındaki seçeneklerden dağıtımınız için uygun paket yöneticisini seçin. Linux dağıtımının paket yöneticisini kullanmanız önerilir. Ancak, Betiği yükle seçeneğini belirleyerek Azure CLI'yi Linux'a el ile yükleyebilirsiniz.
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.
Başlamadan önce
Azure CLI 2.38.2 (21 Haziran 2024’te yayımlandı), RHEL 7 ve CentOS 7 için desteklenen son sürümdür. Microsoft artık bu dağıtımlar için güncelleştirmeler veya hata düzeltmeleri sağlamaz.
Microsoft, Azure CLI ve Linux Yükleme betiğini geliştirmeye ve desteklemeye devam ediyor.
Linux sistemi kullanıyorsanız ve
yumpaket yöneticisini desteklemiyorsadnfpaket yöneticisini kullanın.
Azure CLI'yı yükleme
Azure CLI'yı yüklemek için şu adımları izleyin:
Microsoft depo anahtarını içeri aktarın. RHEL 10 ve CentOS Stream 10 için,
sudo rpm --import https://packages.microsoft.com/keys/microsoft-2025.ascAlt sürümler için aşağıdaki komutu kullanın:
sudo rpm --import https://packages.microsoft.com/keys/microsoft.ascRHEL 10 için depo ekleyin
packages-microsoft-com-prod:sudo dnf install -y https://packages.microsoft.com/config/rhel/10/packages-microsoft-prod.rpmCentOS Stream 10 için depo ekleyin
packages-microsoft-com-prod:sudo dnf install -y https://packages.microsoft.com/config/centos/10/packages-microsoft-prod.rpmRHEL 9 veya CentOS Stream 9 için depo ekleyin
packages-microsoft-com-prod:sudo dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpmRHEL 8 için
packages-microsoft-com-proddeposunu ekleyin:sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpmRHEL 7 için
azure-clideposunu ekleyin:echo -e "[azure-cli] name=Azure CLI baseurl=https://packages.microsoft.com/yumrepos/azure-cli enabled=1 gpgcheck=1 gpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/azure-cli.repoDikkat
CentOS 7 Kullanım Ömrü Sonu (EOL) 30 Haziran 2024'tür. Azure CLI tarafından desteklenen ortamlar hakkında bilgi için Azure CLI destek yaşam döngüsüne bakınız.
dnf installkomutu ile yükleyin.sudo dnf install azure-cli
Belirli bir sürümü yükleme
Önce, azure-cli depo bilgilerini daha önce gösterildiği gibi yapılandırmanız gerekir. Kullanılabilir sürümler Azure CLI sürüm notlarında bulunabilir.
Komutla kullanılabilir sürümleri görüntülemek için:
dnf list --showduplicates azure-cliBelirli bir sürümü yüklemek için:
sudo dnf install azure-cli-<version>-1.el7
Azure CLI'sini güncelleştirme
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.
Azure CLI'yi dnf update komutunu kullanarak da güncelleyebilirsiniz.
sudo dnf update azure-cli
Azure CLI'yi kaldırma
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.
Paketi sisteminizden kaldırın.
sudo dnf remove azure-cliCLI’yı yeniden yüklemeyi planlamıyorsanız, depo bilgilerini kaldırın.
sudo rm /etc/yum.repos.d/azure-cli.repoBaşka Microsoft paketleri kullanmıyorsanız imzalama anahtarını kaldırın.
MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'` sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
Verileri kaldırma
Azure CLI'yı yeniden yüklemeyi planlamıyorsanız verilerini kaldırın.
rm -rf ~/.azure
Sorun giderme
dnf ile yükleme sırasında görülen yaygın sorunlar şunlardır. Burada ele alınmayan bir sorunla karşılaşırsanız GitHub'da bir sorun oluşturun.
RHEL 7.6'ya veya Python 3 içermeyen diğer sistemlere yükleme
Yapabiliyorsanız, sisteminizi python 3.6+ paketi için resmi desteğe sahip bir sürüme yükseltin.
Aksi takdirde, önce bir python3 paketi yüklemeniz, ardından bağımlılıklar olmadan Azure CLI'yi yüklemeniz gerekir.
Kaynak koddan derlenen python 3.6 ile Azure CLI kurulum betiğini indirmek ve yüklemek için aşağıdaki komutu kullanabilirsiniz:
curl -sL https://azurecliprod.blob.core.windows.net/rhel7_6_install.sh | sudo bash
Bunu adım adım da yapabilirsiniz:
İlk olarak, Azure CLI SSL 1.1+ gerektirir ve openssl 1.1'i kaynaktan derlemeniz, ardından python3'yi derlemeniz gerekir.
sudo dnf install gcc gcc-c++ make ncurses patch wget tar zlib zlib-devel -y
# build openssl from source
cd ~
wget https://www.openssl.org/source/openssl-1.1.1d.tar.gz
tar -xzf openssl-1.1.1d.tar.gz
cd openssl-1.1.1d
./config --prefix=/usr/local/ssl --openssldir=/usr/local/ssl
make
sudo make install
# configure shared object lookup directory so that libssl.so.1.1 can be found
echo "/usr/local/ssl/lib" | sudo tee /etc/ld.so.conf.d/openssl-1.1.1d.conf
# reload config
sudo ldconfig -v
Ardından python 3'i kaynaktan derleyin:
PYTHON_VERSION="3.6.9"
PYTHON_SRC_DIR=$(mktemp -d)
wget -qO- https://www.python.org/ftp/python/$PYTHON_VERSION/Python-$PYTHON_VERSION.tgz | tar -xz -C "$PYTHON_SRC_DIR"
cd $PYTHON_SRC_DIR/Python-$PYTHON_VERSION
./configure --prefix=/usr --with-openssl=/usr/local/ssl
make
sudo make install
Son olarak, Azure CLI deposunu eklemek için yükleme talimatlarının 1. ve 2. adımlarını izleyin. Artık paketi indirebilir ve bağımlılık olmadan yükleyebilirsiniz.
Uyarı
dnf indirme eklentisi henüz yüklü değilse, aşağıdaki kodu yürütürken bir command not found hatasıyla karşılaşırsınız.
dnf install 'dnf-command(download)' kullanarak dnf indirme eklentisini yükleyin.
sudo dnf download azure-cli
sudo rpm -ivh --nodeps azure-cli-*.rpm
Alternatif olarak, Python 3'ü başka bir depo kullanarak da yükleyebilirsiniz. Eğer python3 ayarladıysanız, ancak hala python3: command not found hatası alıyorsanız, bu yöntemi kullanın. Yol ayarlarınıza eklendiğinden emin olun.
scl enable rh-python36 bash
Proxy bağlantıyı engelliyor
Proxy nedeniyle dış kaynağa bağlanamıyorsanız, kabuğunuzda HTTP_PROXY ve HTTPS_PROXY değişkenlerini doğru ayarladığınızdan emin olun. Bu proxy'ler için hangi konakların ve bağlantı noktalarının kullanılacağını öğrenmek için sistem yöneticinize başvurmanız gerekir.
Bu değişkenlerdeki değerler birçok Linux programı tarafından ve yükleme işlemi sırasında kullanılır. Bu değerleri ayarlamak için:
# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]
# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]
Önemli
Proxy sunucusu arkasındaysanız, bu kabuk değişkenleri CLI ile Azure hizmetlerine bağlanmak için 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.
Ayrıca, her zaman bu proxy'yi kullanacak şekilde dnf yapılandırmak isteyebilirsiniz.
[main] bölümünün altında /etc/dnf/dnf.conf kısmının içinde aşağıdaki satırların göründüğünden emin olun:
[main]
# ...
proxy=http://[proxy]:[port] # If your proxy requires https, change http->https
proxy_username=[username] # Only required for basic auth
proxy_password=[password] # Only required for basic auth
Depomuzdan Microsoft imzalama anahtarını ve paketini almak için proxy'nizin aşağıdaki adrese HTTPS bağlantılarına izin vermesi gerekir:
https://packages.microsoft.com
CLI, Linux için Windows Alt Sistemi'ne yüklenemiyor veya çalıştırılamıyor.
Linux için Windows Alt Sistemi (WSL), Windows platformunun üzerinde bir sistem çağrısı çeviri katmanı olduğundan, Azure CLI'yı yüklemeye veya çalıştırmaya çalışırken bir hatayla karşılaşabilirsiniz. CLI, WSL'de hata olabilecek bazı özelliklere dayanır. CLI'yı nasıl yüklerseniz yükleyin hatayla karşılaşırsanız, BUNUN CLI yükleme işlemiyle değil WSL ile ilgili bir sorun olma olasılığı yüksektir.
WSL yüklemenizi gidermek ve olası sorunları çözmek için:
- Bunu yapabilirseniz, başarılı olup olmadığını görmek için Linux makinesinde veya VM'de aynı yükleme işlemini çalıştırın. Varsa, sorununuz büyük olasılıkla WSL ile ilgilidir. Linux sanal makinesi (VM) oluşturmak için Azure portalında bulunan belgeleri inceleyerek Azure'da bir Linux VM başlatabilirsiniz.
- WSL'nin en son sürümünü çalıştırdığınızdan emin olun. En son sürümü almak için Windows 10 yüklemenizi güncelleyin.
- WSL ile ilgili sorununuzu giderebilecek açık sorunlar olup olmadığını kontrol edin. Genellikle soruna geçici çözüm önerileri veya sorunun düzeltildiği bir sürüm hakkında bilgiler bulunur.
- Sorununuz için mevcut bir sorun yoksa WSL ile yeni bir sorun oluşturun ve mümkün olduğunca çok bilgi eklediğinizden emin olun.
WSL'yi yüklerken veya çalıştırırken sorun yaşamaya devam ederseniz Windows için CLI yüklemeyi düşünebilirsiniz.
Başlamadan önce
Azure CLI 2.38.2 (21 Haziran 2024'te yayımlandı), SUSE Linux Enterprise Server (SLES) ve OpenSUSE (Leap) üzerinde desteklenen en son sürümdür. Microsoft artık bu dağıtımlar için güncelleştirmeler veya hata düzeltmeleri sağlamaz.
Microsoft, Azure CLI ve Linux komut dosyasını geliştirmeye ve desteklemeye devam etmektedir. SUSE, SUSE/OpenSUSE depoları tarafından sağlanan paketleri korur ve destekler.
Azure'da, Azure Market görüntülerine dayanan SUSE ve OpenSUSE sanal makinelerinde Azure CLI zaten yüklüdür.
Azure CLI'yı yükleme
SUSE/OpenSUSE üzerine Azure CLI yüklemek için aşağıdaki yöntemlerden birini seçin:
SUSE/OpenSUSE depolarında SUSE tarafından sağlanan Kurumsal paketi kullanın.
"Betiği yükle (herhangi bir)" sekmesinde açıklanan yükleme yöntemini kullanın.
Microsoft depolarından yükle
SUSE veya OpenSUSE depolarından yükleme
Azure CLI'nin RPM paketi python3 paketine bağlıdır.
sudo zypper install -y azure-cli
Yükleme betiğiyle kurulum yapın
"Install script" seçeneğini kullanarak Azure CLI'yi Linux'un herhangi bir sürümüne el ile yükleyebilirsiniz.
Bu yöntemi kullanarak en son sürüme güncelleştiriyorsanız, önce önceki sürümü ve bu sürüm için eklemiş olabileceğiniz depoları kaldırdığınızdan emin olun.
Microsoft depolarından yükleme
Microsoft depolarını kullanarak Azure CLI'nın en son geçmiş sürümünü yüklemek için şu adımları izleyin.
(Bu paket SLES 15 ve OpenSUSE Leap 15.1 ile test edilmiştir.)
curlyükleyin:sudo zypper install -y curlMicrosoft depo anahtarını içeri aktarın:
sudo rpm --import https://packages.microsoft.com/keys/microsoft.ascYerel
azure-clideposu bilgilerini oluşturun.sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cliPaketi
zypperdizinini güncelle ve şunu yükle:sudo zypper install --from azure-cli azure-cliBazı bağımlılıklarını yoksayarak yüklemeye devam etmek için giriş 2.
Belirli bir sürümü yükleme
Önce, azure-cli depo bilgilerini daha önce gösterildiği gibi yapılandırmanız gerekir. Kullanılabilir sürümler Azure CLI sürüm notlarında bulunabilir.
Şu komutu kullanarak kullanılabilir sürümleri görüntüleyin:
zypper search --details --match-exact azure-cliBelirli bir sürümü yüklemek için:
sudo zypper install --from azure-cli azure-cli=<version>-1.el7
Azure CLI'sini güncelleştirme
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.
Paketi zypper update komutuyla da güncelleyebilirsiniz.
sudo zypper refresh
sudo zypper update azure-cli
Azure CLI'yi kaldırma
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.
Paketi sisteminizden kaldırın.
sudo zypper remove -y azure-cliCLI’yı yeniden yüklemeyi planlamıyorsanız, depo bilgilerini kaldırın.
sudo zypper removerepo azure-cliDiğer Microsoft paketlerini kullanmıyorsanız Microsoft imzalama anahtarını kaldırın.
MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'` sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
Verileri kaldırma
Azure CLI'yı yeniden yüklemeyi planlamıyorsanız verilerini kaldırın.
rm -rf ~/.azure
Sorun giderme
zypper ile yükleme sırasında görülen yaygın sorunlar şunlardır. Burada ele alınmayan bir sorunla karşılaşırsanız GitHub'da bir sorun oluşturun.
Python 3 olmadan yükleme
Önemli
Azure CLI'nin RPM paketi python3 paketine bağlıdır. Sisteminizde bu, Python 3.6.x gereksiniminden önce gelen bir Python sürümü olabilir. Eğer bu sizi etkiliyorsa, python3 paketine bir yedek bulun.
Python 2'nin 1 Ocak 2020'de kullanım ömrünün sonuna (EOL) ulaştığını ve artık güncelleştirme almayacaklarını unutmayın. Azure CLI, 2.1.0 sürümünden itibaren Python 2.7 desteğini bıraktı. CLI'nın daha yeni sürümleri Python 2.7 kullanılarak düzgün çalışmayabilir.
OpenSUSE 15 VM'de NotImplementedError
OpenSUSE 15 VM'sinde eski sürüm 2.0.45 olan Azure CLI önceden yüklü olarak gelir ve az login ile ilgili bazı sorunları vardır. En son Azure CLI'yi eklemek için Install yönergesini takip etmeden önce bu sürümü bağımlılıklarıyla birlikte kaldırın.
sudo zypper rm -y --clean-deps azure-cli
Azure CLI'yı sürüm 2.0.45'in bağımlılıklarını kaldırmadan güncelleştirdiyseniz, eski bağımlılıkları Azure CLI'nın en son sürümünü etkileyebilir. Eski sürümü bağımlılıklarına bağlamak için geri eklemeniz ve ardından azure-cli işaretini bağımlılıklarıyla birlikte kaldırmanız gerekir.
# The package name may vary on different system version, run 'zypper --no-refresh info azure-cli' to check the source package format
sudo zypper install --oldpackage azure-cli-2.0.45-4.22.noarch
sudo zypper rm -y --clean-deps azure-cli
Python 3.6 içermeyen SLES 12 veya diğer sistemlere yükleme
SLES 12'de varsayılan python3 paketi 3.4'tür ve Azure CLI tarafından desteklenmez. Depoyu eklemek için önce yükleme talimatındaki 1-3. adımları takip edebilirsiniz. Ardından kaynaktan daha yüksek bir python3 sürümü oluşturun. Son olarak, Azure CLI paketini indirebilir ve bağımlılık olmadan yükleyebilirsiniz.
Yukarıdaki adımlara göre Azure CLI'yi yüklemek veya güncelleştirmek için aşağıdaki tek komutu kullanabilirsiniz. Betik, /usr/local/azcli altında Python 3.8'i yükler ve az diğer adını PATH=/usr/local/azcli/bin:$PATH az olarak ayarlayarak Azure CLI'nin bunu kullanmasını sağlar. Ayrıca betiği indirebilir ve ihtiyaçlarınıza göre değiştirebilirsiniz. Örneğin, Python sürümünü değiştirebilir veya konumu yükleyebilirsiniz.
curl -sL https://azurecliprod.blob.core.windows.net/sles12_install_v2.sh | sudo bash
İlk yükleme için, diğer adı etkinleştirmek için aşağıdaki komutu çalıştırmayı unutmayın.
source ~/.bashrc
Proxy bağlantıyı engelliyor
Proxy nedeniyle dış kaynağa bağlanamıyorsanız, kabuğunuzda HTTP_PROXY ve HTTPS_PROXY değişkenlerini doğru ayarladığınızdan emin olun. Bu proxy'ler için hangi konakların ve bağlantı noktalarının kullanılacağını öğrenmek için sistem yöneticinize başvurmanız gerekir.
Bu değişkenlerdeki değerler birçok Linux programı tarafından ve yükleme işlemi sırasında kullanılır. Bu değerleri ayarlamak için:
# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]
# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]
Önemli
Proxy sunucusu arkasındaysanız, bu kabuk değişkenleri CLI ile Azure hizmetlerine bağlanmak için 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.
Ayrıca, zypper'ü (yast2 aracılığıyla) her zaman bu proxy'yi kullanacak şekilde açıkça yapılandırmak isteyebilirsiniz. Bunu yapmak için yast2 proxy komutunu süper kullanıcı olarak çalıştırın ve formda sunulan bilgileri doldurun. Sisteminizde kullanılabilir bir pencere yöneticisi varsa, Network Services > Proxy bölmesini YaST Control Center içinde de kullanabilirsiniz.
Gelişmiş yapılandırma veya daha fazla bilgi için OpenSUSE Proxy yapılandırma belgelerine bakın
Microsoft imzalama anahtarını almak ve paketi depomuzdan almak için ara sunucunuzun aşağıdaki adreslere HTTPS bağlantılarına izin vermesi gerekir:
https://packages.microsoft.comhttps://download.opensuse.org
CLI, Linux için Windows Alt Sistemi'ne yüklenemiyor veya çalıştırılamıyor.
Linux için Windows Alt Sistemi (WSL), Windows platformunun üzerinde bir sistem çağrısı çeviri katmanı olduğundan, Azure CLI'yı yüklemeye veya çalıştırmaya çalışırken bir hatayla karşılaşabilirsiniz. CLI, WSL'de hata olabilecek bazı özelliklere dayanır. CLI'yı nasıl yüklerseniz yükleyin hatayla karşılaşırsanız, BUNUN CLI yükleme işlemiyle değil WSL ile ilgili bir sorun olma olasılığı yüksektir.
WSL yüklemenizi gidermek ve olası sorunları çözmek için:
- Bunu yapabilirseniz, başarılı olup olmadığını görmek için Linux makinesinde veya VM'de aynı yükleme işlemini çalıştırın. Varsa, sorununuz büyük olasılıkla WSL ile ilgilidir. Linux sanal makinesi (VM) oluşturmak için Azure portalında bulunan belgeleri inceleyerek Azure'da bir Linux VM başlatabilirsiniz.
- WSL'nin en son sürümünü çalıştırdığınızdan emin olun. En son sürümü almak için Windows 10 yüklemenizi güncelleyin.
- WSL ile ilgili sorununuzu giderebilecek açık sorunlar olup olmadığını kontrol edin. Genellikle soruna geçici çözüm önerileri veya sorunun düzeltildiği bir sürüm hakkında bilgiler bulunur.
- Sorununuz için mevcut bir sorun yoksa WSL ile yeni bir sorun oluşturun ve mümkün olduğunca çok bilgi eklediğinizden emin olun.
WSL'yi yüklerken veya çalıştırırken sorun yaşamaya devam ederseniz Windows için CLI yüklemeyi düşünebilirsiniz.
SSL sertifikası sorunu
Bir makinede sertifika bozulduğunda veya eski olduğunda curl'in sunucunun meşruluğunu doğrulayamadıdığını ve bu nedenle güvenli bir bağlantı kuralamadığını belirten bir hata alabilirsiniz. Sorunu düzeltmek için sertifikanızı güncelleştirin.
sudo zypper update-ca-certificates
Başlamadan önce
Paket yöneticisi,
aptAzure CLI için aşağıdaki dağıtımlarda test edilmiş x86_64 ve ARM64 paketlerini içerir.Dağıtım Sürüm Debian 11 (Bullseye), 12 (Kitap kurdu) Ubuntu 22.04 (Jammy Jellyfish), 24.04 (Noble Numbat)
Azure CLI'yı yükleme
Azure CLI'yi sisteminize yüklemek için iki seçenek vardır. Yükleme komutlarını çalıştıran bir yükleme betiğini indirebilir veya yükleme komutlarını adım adım bir işlemde kendiniz yürütebilirsiniz. Her iki yöntem de burada sağlanır:
1. Seçenek: Tek bir komutla yükleme
Azure CLI'yi yüklemenin en kolay yolu, Azure CLI ekibi tarafından tutulan bir betik kullanmaktır. Bu betik tüm yükleme komutlarını tek adımda çalıştırır. Bu betik, curl aracılığıyla indirilir ve doğrudan bash kullanılarak CLI'nin yüklenmesi için yönlendirilir.
Yürütmeden önce betiğin içeriğini kendiniz incelemek istiyorsanız, önce curl kullanarak betiği indirin ve en sevdiğiniz metin düzenleyicide inceleyin.
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash
2. Seçenek: Adım adım yükleme yönergeleri
Adım adım yükleme işlemini tercih ediyorsanız Azure CLI'yı yüklemek için aşağıdaki adımları tamamlayın.
Yükleme işlemi için gereken paketleri alın:
sudo apt-get update sudo apt-get install apt-transport-https ca-certificates curl gnupg lsb-releaseMicrosoft imzalama anahtarını indirin ve yükleyin:
sudo mkdir -p /etc/apt/keyrings curl -sLS https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/microsoft.gpg > /dev/null sudo chmod go+r /etc/apt/keyrings/microsoft.gpg-
Azure CLI yazılım deposunu ekleyin:
AZ_DIST=$(lsb_release -cs) echo "Types: deb URIs: https://packages.microsoft.com/repos/azure-cli/ Suites: ${AZ_DIST} Components: main Architectures: $(dpkg --print-architecture) Signed-by: /etc/apt/keyrings/microsoft.gpg" | sudo tee /etc/apt/sources.list.d/azure-cli.sources Depo bilgilerini güncelleyin ve
azure-clipaketini yükleyin.sudo apt-get update sudo apt-get install azure-cli
Belirli bir sürümü yükleme
azure-cli depo bilgilerini daha önce gösterildiği gibi yapılandırın. Kullanılabilir sürümler Azure CLI sürüm notlarında bulunabilir.
Azure CLI'nın kullanılabilir sürümlerini görüntüleyin.
apt-cache policy azure-cliBelirli bir sürümü yükleyin.
# Obtain the currently installed distribution AZ_DIST=$(lsb_release -cs) # Store an Azure CLI version of choice AZ_VER=2.51.0 # Install a specific version sudo apt-get install azure-cli=${AZ_VER}-1~${AZ_DIST}Değişkenler olmadan belirli bir sürümü yüklemek için Azure CLI sürümünü ve gösterilen Linux dağıtım adını değiştirin:
sudo apt-get install azure-cli=2.51.0-1~bullseye
Hata mesajı Unable to locate package azure-cli alırsanız, azure-cli depo bilgileri yapılandırılmamış.
2. Seçenek: Adım adım yükleme yönergeleri bölümünde verilen adımları izleyin.
Azure-cli için Sürüm x.xx.x-1~distributionName bulunamadı hata mesajını alırsanız, çalıştırdığınız dağıtımı bulmak için lsb_release -cs kullanın.
Azure CLI'sini güncelleştirme
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.
CLI paketini güncelleştirmek için apt-get upgrade de kullanabilirsiniz. Bu komut, sisteminizde bağımlılık değişikliği olmayan tüm yüklü paketleri yükselter.
sudo apt-get update && sudo apt-get upgrade
Yalnızca CLI'yı yükseltmek için apt-get install kullanın.
sudo apt-get update && sudo apt-get install --only-upgrade -y azure-cli
Azure CLI'yi kaldırma
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.
apt-get removeile kaldır:sudo apt-get remove -y azure-cliCLI'yı yeniden yüklemeyi planlamıyorsanız Azure CLI depo bilgilerini kaldırın:
sudo rm /etc/apt/sources.list.d/azure-cli.sourcesMicrosoft'tan başka paketler kullanmıyorsanız imzalama anahtarını kaldırın:
sudo rm /etc/apt/keyrings/microsoft.gpgGereksiz paketleri kaldırın:
sudo apt autoremove
Verileri kaldırma
Azure CLI'yı yeniden yüklemeyi planlamıyorsanız verilerini kaldırın.
rm -rf ~/.azure
Sorun giderme
apt ile yükleme sırasında görülen yaygın sorunlar şunlardır. Burada ele alınmayan bir sorunla karşılaşırsanız GitHub'da bir sorun oluşturun.
Paket, CLI sürümü azure-cli itibarıyla ARM64 mimarisini destekler.
lsb_release doğru temel dağıtım sürümünü döndürmüyor
Bazı Ubuntu veya Debian tabanlı diğer dağıtımlar (Linux Mint gibi) lsb_release komutundan doğru sürüm adını döndürmeyebilir. Bu değer, yükleme işleminde yüklenecek paketin belirlenmesi için kullanılır. Ubuntu veya Debian sürümünüzün türetildiği dağıtımın kod adını biliyorsanız, depoyu eklerken AZ_REPO değerini manuel olarak ayarlayabilirsiniz. Aksi takdirde, temel dağıtım kodu adını nasıl belirleyip AZ_REPO'yi doğru değere nasıl ayarlayacağınız hakkında dağıtımınız için bilgi arayın.
Dağıtımınız için paket yok
Bazen, güncelleştirilmiş bir Azure CLI paketi dağıtım sürümü sürümünden sonra hemen kullanılamaz. Azure CLI, bağımlılıkların gelecekteki sürümlerine dayanıklı olacak şekilde tasarlanmıştır ve bunlardan mümkün olduğunca azını temel alır. Temel dağıtımınız için kullanılabilir paket yoksa, önceki bir dağıtım için bir paket deneyin.
Önceki bir dağıtıma yönelik bir paketi denemek için, depoyu eklerken AZ_REPO değerini elle ayarlayın. Ubuntu dağıtımları için en son jammy deposunu kullanın:
AZ_REPO="jammy"
Debian dağıtımları için en son bookworm deposunu kullanın.
AZ_REPO="bookworm"
Önemli
Ubuntu Bionic ve Debian Buster öncesinde yayınlanan dağıtımlar desteklenmez.
Temel işletim sistemi (EOS) Azure CLI'yi yükleyemiyor
EOS, lsb_releaseHERA (EOS sürüm adı) döndürdüğü için Azure CLI'yi yükleyemiyor. Çözüm, /etc/apt/sources.list.d/azure-cli.sources dosyasını düzeltmek ve Suites: hera olarak Suites: bionic değiştirmektir.
Özgün dosya içeriği:
Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg
Değiştirilen dosya içeriği
Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg
Proxy bağlantıyı engelliyor
Proxy nedeniyle dış kaynağa bağlanamıyorsanız, kabuğunuzda HTTP_PROXY ve HTTPS_PROXY değişkenlerini doğru ayarladığınızdan emin olun. Bu proxy'ler için hangi konakların ve bağlantı noktalarının kullanılacağını öğrenmek için sistem yöneticinize başvurmanız gerekir.
Bu değişkenlerdeki değerler birçok Linux programı tarafından ve yükleme işlemi sırasında kullanılır. Bu değerleri ayarlamak için:
# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]
# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]
Önemli
Proxy sunucusu arkasındaysanız, bu kabuk değişkenleri CLI ile Azure hizmetlerine bağlanmak için 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.
Ayrıca, her zaman bu proxy'yi kullanacak şekilde apt yapılandırmak isteyebilirsiniz. Aşağıdaki satırların apt içindeki bir /etc/apt/apt.conf.d/ yapılandırma dosyasında göründüğünden emin olun. Mevcut genel yapılandırma dosyanızı, var olan bir proxy yapılandırma dosyasını, 40proxies veya 99local kullanmanızı, ancak sistem yönetimi gereksinimlerinizi takip etmenizi öneririz.
Acquire {
http::proxy "http://[username]:[password]@[proxy]:[port]";
https::proxy "https://[username]:[password]@[proxy]:[port]";
}
Proxy'niz temel kimlik doğrulaması kullanmıyorsa proxy URI'sinin ilgili bölümünü kaldırın. Ara sunucu yapılandırması için daha fazla bilgiye ihtiyacınız varsa resmi Ubuntu belgelerine bakın:
Microsoft imzalama anahtarını almak ve paketi depomuzdan almak için proxy'nizin aşağıdaki adrese yönelik HTTPS bağlantılarına izin vermesi gerekir: `https://packages.microsoft.com.`
CLI, Linux için Windows Alt Sistemi'ne yüklenemiyor veya çalıştırılamıyor.
Linux için Windows Alt Sistemi (WSL), Windows platformunun üzerinde bir sistem çağrısı çeviri katmanı olduğundan, Azure CLI'yı yüklemeye veya çalıştırmaya çalışırken bir hatayla karşılaşabilirsiniz. CLI, WSL'de hata olabilecek bazı özelliklere dayanır. CLI'yı nasıl yüklerseniz yükleyin hatayla karşılaşırsanız, BUNUN CLI yükleme işlemiyle değil WSL ile ilgili bir sorun olma olasılığı yüksektir.
WSL yüklemenizi gidermek ve olası sorunları çözmek için:
- Bunu yapabilirseniz, başarılı olup olmadığını görmek için Linux makinesinde veya VM'de aynı yükleme işlemini çalıştırın. Varsa, sorununuz büyük olasılıkla WSL ile ilgilidir. Linux sanal makinesi (VM) oluşturmak için Azure portalında bulunan belgeleri inceleyerek Azure'da bir Linux VM başlatabilirsiniz.
- WSL'nin en son sürümünü çalıştırdığınızdan emin olun. En son sürümü almak için Windows 10 yüklemenizi güncelleyin.
- WSL ile ilgili sorununuzu giderebilecek açık sorunlar olup olmadığını kontrol edin. Genellikle soruna geçici çözüm önerileri veya sorunun düzeltildiği bir sürüm hakkında bilgiler bulunur.
- Sorununuz için mevcut bir sorun yoksa WSL ile yeni bir sorun oluşturun ve mümkün olduğunca çok bilgi eklediğinizden emin olun.
WSL'yi yüklerken veya çalıştırırken sorun yaşamaya devam ederseniz Windows için CLI yüklemeyi düşünebilirsiniz.
Azure CLI'yı yükleme
RPM'ler CBL-Mariner aracılığıyla Azure Linux için yayınlanmaktadır. Paket, CLI sürümü azure-cli itibarıyla ARM64 mimarisini destekler.
Azure CLI'yı yüklemek için şu adımları izleyin:
Microsoft tarafından seçilmiş resmi güvenilen kök sertifika kümesini yükleyin:
sudo tdnf install ca-certificatesAzure CLI'yi yükleme:
sudo tdnf install azure-cli
Belirli bir sürümü yükleme
Kullanılabilir sürümler Azure CLI sürüm notlarında bulunabilir.
Komutla kullanılabilir sürümleri görüntülemek için:
tdnf list azure-cli
Belirli bir sürümü yüklemek için:
sudo tdnf install azure-cli-<version>-1
Azure CLI'sini güncelleştirme
Azure CLI'yi tdnf update komutuyla güncelleyin:
sudo tdnf update azure-cli
Azure CLI'yi kaldırma
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.
Paketi sisteminizden kaldırın:
sudo tdnf remove azure-cli
Verileri kaldırma
Azure CLI'yı yeniden yüklemeyi planlamıyorsanız verilerini kaldırın.
rm -rf ~/.azure
Başlamadan önce
CLI’yı paket yöneticisiyle yüklemeniz kesinlikle önerilir. Paket yöneticisi her zaman en son güncelleştirmeleri aldığınızdan emin olmanızı sağlar ve CLI bileşenlerinin kararlılığını garanti eder. Elle yüklemeden önce dağıtımınız için bir paket olup olmadığını kontrol edin veya bakın.
Azure CLI için yükleme betiği aşağıdaki yazılımları gerektirir:
- Python 3.8.x, 3.9.x, 3.10.x - Daha fazla bilgi için Destek yaşam döngüsü - Python bağımlılığı bölümünü inceleyin.
- libffi
- OpenSSL 1.0.2
Azure CLI'yi yükleme veya güncelleştirme
Önemli
Yükleme betiği yalnızca Python 3.8.x, 3.9.x veya 3.10.x üzerinde çalışır. Bu yükleme betiği Python 3.11.x veya sonraki sürümlerde çalışmaz.
Azure CLI'yi hem yüklemek hem de güncelleştirmek için yükleme betiğinin yeniden çalıştırılması gerekir:
curl -L https://aka.ms/InstallAzureCli | bash
Betik ayrıca indirilip yerel olarak çalıştırılabilir. Değişikliklerin etkili olması için komut satırınızı yeniden başlatmanız gerekebilir.
Azure CLI'yi kaldırma
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.
Yükleme sırasında seçilen konumdan dosyaları doğrudan silerek CLI’yı kaldırın. Varsayılan yükleme konumu kullanıcının giriş dizinidir ($HOME).
Yüklü CLI dosyalarını kaldırın.
rm -r <install location>/lib/azure-cli rm <install location>/bin/az$HOME/.bash_profiledosyanızı değiştirerek şu satırı kaldırın:<install location>/lib/azure-cli/az.completionbashveyazshkullanıyorsanız, kabuğunuzun komut önbelleğini yeniden yükleyin.hash -r
Verileri kaldırma
Azure CLI'yı yeniden yüklemeyi planlamıyorsanız verilerini kaldırın.
rm -rf ~/.azure
Sorun giderme
El ile yükleme sırasında karşılaşılan bazı yaygın sorunlar aşağıdadır. Burada ele alınmayan bir sorunla karşılaşırsanız GitHub'da bir sorun oluşturun.
Python 3 olmadan yükleme
Azure CLI, 2.1.0 sürümünden itibaren Python 2.7 desteğini bıraktı. Sisteminizde Python 3.6.x gereksiniminden önce gelen bir Python sürümü olabilir. Yeni bir python3 paketi bulun.
curl "Nesne Taşındı" hatası
curl ile ilgili bir hata veya "Nesne Taşındı" ifadesini içeren bir hata mesajı alırsanız, -L yönlendirmesi yerine tam URL’yi kullanmayı deneyin:
curl https://azurecliprod.blob.core.windows.net/install | bash
az komutu bulunamadı
Kurulumdan sonra komutu `bash` veya `zsh` kullanarak çalıştıramıyorsanız, kabuğunuzun komut karması önbelleğini temizlemeyi deneyin ve sorunun çözülüp çözülmediğini kontrol edin.
hash -r
Yüklemeden sonra kabuğunuzu yeniden başlatmadıysanız da sorun oluşabilir.
az komutunun $PATH'da bulunduğundan emin olun. Komutun az konumu ...
<install path>/bin
Proxy bağlantıyı engelliyor
Proxy nedeniyle dış kaynağa bağlanamıyorsanız, kabuğunuzda HTTP_PROXY ve HTTPS_PROXY değişkenlerini doğru ayarladığınızdan emin olun. Bu proxy'ler için hangi konakların ve bağlantı noktalarının kullanılacağını öğrenmek için sistem yöneticinize başvurmanız gerekir.
Bu değişkenlerdeki değerler birçok Linux programı tarafından ve yükleme işlemi sırasında kullanılır. Bu değerleri ayarlamak için:
# No auth
export HTTP_PROXY=http://[proxy]:[port]
export HTTPS_PROXY=https://[proxy]:[port]
# Basic auth
export HTTP_PROXY=http://[username]:[password]@[proxy]:[port]
export HTTPS_PROXY=https://[username]:[password]@[proxy]:[port]
Önemli
Proxy sunucusu arkasındaysanız, bu kabuk değişkenleri CLI ile Azure hizmetlerine bağlanmak için 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.
Yükleme betiklerini almak için proxy'nizin aşağıdaki adreslere HTTPS bağlantılarına izin vermesi gerekir:
https://aka.ms/https://azurecliprod.blob.core.windows.net/https://pypi.python.org- Dağıtımınızın paket yöneticisi (varsa) tarafından çekirdek paketler için kullanılan uç noktalar
CLI, Linux için Windows Alt Sistemi'ne yüklenemiyor veya çalıştırılamıyor.
Linux için Windows Alt Sistemi (WSL), Windows platformunun üzerinde bir sistem çağrısı çeviri katmanı olduğundan, Azure CLI'yı yüklemeye veya çalıştırmaya çalışırken bir hatayla karşılaşabilirsiniz. CLI, WSL'de hata olabilecek bazı özelliklere dayanır. CLI'yı nasıl yüklerseniz yükleyin hatayla karşılaşırsanız, BUNUN CLI yükleme işlemiyle değil WSL ile ilgili bir sorun olma olasılığı yüksektir.
WSL yüklemenizi gidermek ve olası sorunları çözmek için:
- Bunu yapabilirseniz, başarılı olup olmadığını görmek için Linux makinesinde veya VM'de aynı yükleme işlemini çalıştırın. Varsa, sorununuz büyük olasılıkla WSL ile ilgilidir. Linux sanal makinesi (VM) oluşturmak için Azure portalında bulunan belgeleri inceleyerek Azure'da bir Linux VM başlatabilirsiniz.
- WSL'nin en son sürümünü çalıştırdığınızdan emin olun. En son sürümü almak için Windows 10 yüklemenizi güncelleyin.
- WSL ile ilgili sorununuzu giderebilecek açık sorunlar olup olmadığını kontrol edin. Genellikle soruna geçici çözüm önerileri veya sorunun düzeltildiği bir sürüm hakkında bilgiler bulunur.
- Sorununuz için mevcut bir sorun yoksa WSL ile yeni bir sorun oluşturun ve mümkün olduğunca çok bilgi eklediğinizden emin olun.
WSL'yi yüklerken veya çalıştırırken sorun yaşamaya devam ederseniz Windows için CLI yüklemeyi düşünebilirsiniz.
Sonraki Adımlar
Azure CLI'yi yüklediğinize göre özelliklerine ve yaygın komutlara kısa bir göz atın.