Linux'ta Azure CLI'yi yükleme
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.63.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'de 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 eder.
Paket yöneticisini
yum
desteklemeyen bir Linux sistemi kullanıyorsanız paket yöneticisinidnf
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.
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
RHEL 9 veya CentOS Stream için depo ekleyin
packages-microsoft-com-prod
:sudo dnf install -y https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm
RHEL 8 için depo ekleyin
packages-microsoft-com-prod
:sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm
RHEL 7 için depo ekleyin
azure-cli
: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.repo
Dikkat
CentOS 7 Kullanım Ömrü Sonu (EOL) 30 Haziran 2024'tür. Azure CLI tarafından desteklenen ortamlar hakkında bilgi için bkz. Azure CLI destek yaşam döngüsü
dnf install
komutu ile yükleyin.sudo dnf install azure-cli
Belirli bir sürümü yükleme
Önce depo bilgilerini daha önce gösterildiği gibi yapılandırmanız azure-cli
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-cli
Belirli 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. 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.
Azure CLI'yi komutuyla dnf update
da güncelleştirebilirsiniz.
sudo dnf update azure-cli
Azure CLI'yi kaldırma
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.
Paketi sisteminizden kaldırın.
sudo dnf remove azure-cli
CLI’yı yeniden yüklemeyi planlamıyorsanız, depo bilgilerini kaldırın.
sudo rm /etc/yum.repos.d/azure-cli.repo
Baş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 sorunlardan bazıları burada verilmiştir. 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 resmi paket desteğine python 3.6+
sahip bir sürüme yükseltin. Aksi takdirde, önce bir python3
paket yüklemeniz, ardından bağımlılık olmadan Azure CLI'yi yüklemeniz gerekir.
Kaynaktan derlenen Azure CLI yükleme betiğini python 3.6
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 gerektirir SSL 1.1+
ve derlemeden python3
önce kaynaktan derlemeniz openssl 1.1
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 yönergesinin 1. ve 2. adımlarını izleyin. Artık paketi indirebilir ve bağımlılık olmadan yükleyebilirsiniz.
Not
dnf indirme eklentisi henüz yüklü değilse aşağıdaki kodu yürütürken bir command not found
hatayla karşılaşırsınız. dnf indirme eklentisini yüklemek için kullanın dnf install 'dnf-command(download)'
.
sudo dnf download azure-cli
sudo rpm -ivh --nodeps azure-cli-*.rpm
Alternatif olarak Python 3'ü başka bir depo kullanarak da yükleyebilirsiniz. Ayarladıysanız python3
ancak hatasını python3: command not found
almaya devam ediyorsanız bu yöntemi kullanın. Yolunuza eklendiğinden emin olun.
scl enable rh-python36 bash
Ara sunucu blokları bağlantısı
Ara sunucu nedeniyle dış kaynağa bağlanamıyorsanız kabuğunuzda ve HTTPS_PROXY
değişkenlerini doğru ayarladığınızdan HTTP_PROXY
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
Ara sunucu arkasındaysanız, bu kabuk değişkenleri CLI ile Azure hizmetlerine bağlanacak şekilde 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, bu ara sunucuyu her zaman kullanacak şekilde açıkça yapılandırmak dnf
da isteyebilirsiniz. bölümünün altında aşağıdaki satırların göründüğünden [main]
/etc/dnf/dnf.conf
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 yüklenemiyor veya çalıştırılamıyor
Linux için Windows Alt Sistemi (WSL) Windows platformunun en üstündeki 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. Azure'da Linux VM'yi başlatmak için Azure portalı belgelerinde Linux VM oluşturma bölümüne bakın.
- WSL'nin en son sürümünü çalıştırdığınızdan emin olun. En son sürümü edinmek için Windows 10 yüklemenizi güncelleştirin.
- WSL ile ilgili sorununuzu giderebilecek açık sorunları denetleyin. 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 sorunlarla karşılaşırsanız Windows için CLI'yi yüklemeyi göz önünde bulundurun.
Başlamadan önce
Azure CLI 2.38.2 (21 Haziran 2024'te yayımlandı), SUSE Linux Enterprise Server (SLES) ve OpenSUSE (Artık) ü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 Yükleme betiğini geliştirmeye ve desteklemeye devam eder. SUSE, SUSE/OpenSUSE depoları tarafından sağlanan paketleri korur ve destekler.
Azure'da SUSE ve OpenSUSE sanal makinelerinde (VM) Azure Market görüntüleri temel alan 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.
SUSE veya OpenSUSE depolarından yükleme
Azure CLI'nın RPM paketi pakete python3
bağlıdır.
sudo zypper install -y azure-cli
Yükleme betiğiyle yükleme
Betik yükle 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 ile test edilmiştirSLES 15 ve OpenSUSE Artık 15.1)
curl
yükleme:sudo zypper install -y curl
Microsoft depo anahtarını içeri aktarın:
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
Yerel
azure-cli
deposu bilgilerini oluşturun:sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
zypper
paket dizinini güncelleştirin ve şunu yükleyin:sudo zypper install --from azure-cli azure-cli
Bazı bağımlılıklarını yoksayarak yüklemeye devam etmek için giriş 2.
Belirli bir sürümü yükleme
Önce depo bilgilerini daha önce gösterildiği gibi yapılandırmanız azure-cli
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-cli
Belirli 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. 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.
Paketi komutuyla zypper update
da güncelleştirebilirsiniz.
sudo zypper refresh
sudo zypper update azure-cli
Azure CLI'yi kaldırma
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.
Paketi sisteminizden kaldırın.
sudo zypper remove -y azure-cli
CLI’yı yeniden yüklemeyi planlamıyorsanız, depo bilgilerini kaldırın.
sudo zypper removerepo azure-cli
Diğ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 sorunlardan bazıları burada verilmiştir. Burada ele alınmayan bir sorunla karşılaşırsanız GitHub'da bir sorun oluşturun.
Python 3 olmadan yükleme
Önemli
Azure CLI'nın RPM paketi pakete python3
bağlıdır. Sisteminizde bu, Python 3.6.x gereksiniminden önce gelen bir Python sürümü olabilir. Bu sizi etkiliyorsa, yeni python3
bir paket 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 bu yana 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 ile önceden yüklenmiş bir Azure CLI'sı vardır ve ile az login
ilgili sorunları vardır. En son Azure CLI'yi eklemek için Yükleme 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. Bağımlılıklarına bağlanmak için eski sürümü geri eklemeniz ve ardından bağımlılıklarıyla birlikte kaldırmanız azure-cli
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
paket 3.4'dür ve Azure CLI tarafından desteklenmez. Depoyu eklemek için önce yükleme yönergesinin 1-3 arası adımlarını azure-cli
izleyebilirsiniz. Ardından kaynaktan daha yüksek bir sürüm python3
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 altında /usr/local/azcli
Python 3.8'i yükler ve azure CLI'nin az
PATH=/usr/local/azcli/bin:$PATH az
diğer adını olarak ayarlayarak 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 kez yüklemek için, diğer adı etkinleştirmek için aşağıdaki komutu çalıştırmayı unutmayın:
source ~/.bashrc
Ara sunucu blokları bağlantısı
Ara sunucu nedeniyle dış kaynağa bağlanamıyorsanız kabuğunuzda ve HTTPS_PROXY
değişkenlerini doğru ayarladığınızdan HTTP_PROXY
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
Ara sunucu arkasındaysanız, bu kabuk değişkenleri CLI ile Azure hizmetlerine bağlanacak şekilde 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, bu ara sunucuyu her zaman kullanmak için açıkça (aracılığıylayast2
) yapılandırmak zypper
da isteyebilirsiniz. Bunu yapmak için komutunu süper kullanıcı olarak çalıştırın yast2 proxy
ve formda sunulan bilgileri doldurun. Sisteminizde kullanılabilir bir pencere yöneticisi varsa, bölmesindeki Network Services > Proxy
YaST Control Center
bölmesini 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.com
https://download.opensuse.org
CLI Linux için Windows Alt Sistemi yüklenemiyor veya çalıştırılamıyor
Linux için Windows Alt Sistemi (WSL) Windows platformunun en üstündeki 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. Azure'da Linux VM'yi başlatmak için Azure portalı belgelerinde Linux VM oluşturma bölümüne bakın.
- WSL'nin en son sürümünü çalıştırdığınızdan emin olun. En son sürümü edinmek için Windows 10 yüklemenizi güncelleştirin.
- WSL ile ilgili sorununuzu giderebilecek açık sorunları denetleyin. 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 sorunlarla karşılaşırsanız Windows için CLI'yi yüklemeyi göz önünde bulundurun.
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,
apt
Azure CLI için aşağıdaki dağıtımlarda test edilmiş x86_64 ve ARM64 paketlerini içerir.Dağıtım Sürüm Ubuntu 20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish), 24.04 (Noble Numbat) Debian 10 (Buster), 11 (Bullseye), 12 (Bookworm) Ubuntu 20.04 (Focal Fossa) ve 20.10 (Groovy Gorilla), depo tarafından
universe
sağlanan sürüme2.0.81
sahip birazure-cli
paket içerir. Bu paket güncel değil ve önerilmez. Bu paket yüklüyse komutunusudo apt remove azure-cli -y && sudo apt autoremove -y
çalıştırarak devam etmeden önce paketi kaldırın. hakkındaapt remove
daha fazla bilgi için Ubuntu paket yönetimine bakın veya ubuntu'ya sorun.
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 aracılığıyla curl
indirilir ve CLI'yi yüklemek için bash
doğrudan adresine yöneltilir.
Yürütmeden önce betiğin içeriğini kendiniz incelemek istiyorsanız, önce kullanarak betiği curl
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-release
Microsoft 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üncelleştirin
azure-cli
ve paketi 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-cli
Belirli 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
Azure-cli paketi bulunamıyor hata iletisi alırsanız, azure-cli
depo bilgileri yapılandırılmaz. 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 iletisini alırsanız, çalıştırdığınız dağıtımı bulmak için kullanınlsb_release -cs
.
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. 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.
CLI paketini güncelleştirmek için de kullanabilirsiniz apt-get upgrade
. 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 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.
ile
apt-get remove
kaldır:sudo apt-get remove -y azure-cli
CLI'yı yeniden yüklemeyi planlamıyorsanız Azure CLI depo bilgilerini kaldırın:
sudo rm /etc/apt/sources.list.d/azure-cli.sources
Microsoft'tan başka paketler kullanmıyorsanız imzalama anahtarını kaldırın:
sudo rm /etc/apt/keyrings/microsoft.gpg
Gereksiz 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 sorunlardan bazıları burada verilmiştir. Burada ele alınmayan bir sorunla karşılaşırsanız GitHub'da bir sorun oluşturun.
Paket, azure-cli
CLI sürüm 2.46.0'dan ARM64 mimarisini destekler.
Ubuntu 20.04 (Focal)/WSL'de modül sorunu yok
Azure CLI yazılım deposunu el ile yükleme yönergelerinin 3. adımına eklemeden veya betiğimizi kullanmadan yüklediyseniz azure-cli
Focal
, yüklediğiniz paket depodan focal/universe
eski azure-cli 2.0.81
olduğundan 'dekoratör' veya 'antlr4' adlı modül olmaması gibi sorunlarla karşılaşabilirsiniz. önce komutunu çalıştırarak sudo apt remove azure-cli -y && sudo apt autoremove -y
kaldırın, ardından en son azure-cli
paketi yüklemek için yukarıdaki yönergeleri izleyin.
lsb_release doğru temel dağıtım sürümünü döndürmüyor
Bazı Ubuntu veya diğer Debian türetilmiş dağıtımları (Linux Mint gibi) sürümünden lsb_release
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. Dağıtımınızın türetilmiş olduğu Ubuntu veya Debian sürümünün kod adını biliyorsanız, depoyu eklerken değeri el ile ayarlayabilirsinizAZ_REPO
. Aksi takdirde, temel dağıtım kodu adını belirleme ve doğru değere ayarlama AZ_REPO
hakkında dağıtımınızla ilgili bilgileri 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 değerini AZ_REPO
el ile ayarlayın. Ubuntu dağıtımları için en son jammy
depoyu kullanın:
AZ_REPO="jammy"
Debian dağıtımları için en son bookworm
depoyu 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, EOS yayın adı olan değerini döndürdüğünden lsb_release
HERA
Azure CLI'yi yükleyemiyor. Çözüm, dosyayı /etc/apt/sources.list.d/azure-cli.sources
düzeltmek ve olarak değiştirmektir Suites: hera
Suites: bionic
.
Ö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
Ara sunucu blokları bağlantısı
Ara sunucu nedeniyle dış kaynağa bağlanamıyorsanız kabuğunuzda ve HTTPS_PROXY
değişkenlerini doğru ayarladığınızdan HTTP_PROXY
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
Ara sunucu arkasındaysanız, bu kabuk değişkenleri CLI ile Azure hizmetlerine bağlanacak şekilde 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, bu ara sunucuyu her zaman kullanacak şekilde açıkça yapılandırmak apt
da isteyebilirsiniz. Aşağıdaki satırların içindeki /etc/apt/apt.conf.d/
bir apt
yapılandırma dosyasında göründüğünden emin olun. Mevcut genel yapılandırma dosyanızı, var olan bir ara sunucu yapılandırma dosyanızı 40proxies
veya 99local
kullanmanızı, ancak sistem yönetimi gereksinimlerinizi izlemenizi öneririz.
Acquire {
http::proxy "http://[username]:[password]@[proxy]:[port]";
https::proxy "https://[username]:[password]@[proxy]:[port]";
}
Proxy'niz temel kimlik doğrulaması kullanmıyorsa ara sunucu URI'sinin bölümünü kaldırın[username]:[password]@
. 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 şu adrese yönelik HTTPS bağlantılarına izin vermesi gerekir: 'https://packages.microsoft.com.
CLI Linux için Windows Alt Sistemi yüklenemiyor veya çalıştırılamıyor
Linux için Windows Alt Sistemi (WSL) Windows platformunun en üstündeki 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. Azure'da Linux VM'yi başlatmak için Azure portalı belgelerinde Linux VM oluşturma bölümüne bakın.
- WSL'nin en son sürümünü çalıştırdığınızdan emin olun. En son sürümü edinmek için Windows 10 yüklemenizi güncelleştirin.
- WSL ile ilgili sorununuzu giderebilecek açık sorunları denetleyin. 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 sorunlarla karşılaşırsanız Windows için CLI'yi yüklemeyi göz önünde bulundurun.
Azure CLI'yı yükleme
RPC'ler CBL-Mariner aracılığıyla Azure Linux için yayınlanmaktadır. Paket, azure-cli
CLI sürüm 2.46.0'dan 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-certificates
Azure 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 şu komutla güncelleştirin tdnf update
:
sudo tdnf update azure-cli
Azure CLI'yi kaldırma
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.
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. El ile yüklemeden önce dağıtımınız için bir paket olup olmadığını denetleyin ve denetleyin.
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 bkz . Destek yaşam döngüsü - Python bağımlılığı.
- 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 indirilip yerel olarak da çalıştırılabilir. Değişikliklerin etkili olması için kabuğunuzu yeniden başlatmanız gerekebilir.
Azure CLI'yi kaldırma
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.
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_profile
dosyanızı değiştirerek şu satırı kaldırın:<install location>/lib/azure-cli/az.completion
bash
veyazsh
kullanı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 görülen bazı yaygın sorunlar aşağıda verilmiştir. 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 bu yana Python 2.7 desteğini bıraktı.
Sisteminizde Python 3.6.x gereksiniminden önce gelen bir Python sürümü olabilir.
Yeni python3
bir paket bulun.
curl "Nesne Taşındı" hatası
curl
komutundan -L
parametresiyle ilgili bir hata veya "Nesne Taşındı" ifadesini içeren bir hata iletisi alıyorsanız, aka.ms
yeniden yönlendirmesi yerine tam URL’yi kullanmayı deneyin:
curl https://azurecliprod.blob.core.windows.net/install | bash
az
komutu bulunamadı
veya zsh
kullanarak bash
yüklemeden sonra komutu çalıştıramıyorsanız, kabuğunuzun komut karması önbelleğini temizlemeyi deneyin ve sorunun çözülmüş olup olmadığını denetleyin.
hash -r
Yükleme sonrasında kabuğunuzu yeniden başlatmadıysanız bu sorun oluşabilir. az
komutunun $PATH
içinde bulunduğundan emin olun. Komutun az
konumu ...
<install path>/bin
Ara sunucu blokları bağlantısı
Ara sunucu nedeniyle dış kaynağa bağlanamıyorsanız kabuğunuzda ve HTTPS_PROXY
değişkenlerini doğru ayarladığınızdan HTTP_PROXY
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
Ara sunucu arkasındaysanız, bu kabuk değişkenleri CLI ile Azure hizmetlerine bağlanacak şekilde 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 yüklenemiyor veya çalıştırılamıyor
Linux için Windows Alt Sistemi (WSL) Windows platformunun en üstündeki 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. Azure'da Linux VM'yi başlatmak için Azure portalı belgelerinde Linux VM oluşturma bölümüne bakın.
- WSL'nin en son sürümünü çalıştırdığınızdan emin olun. En son sürümü edinmek için Windows 10 yüklemenizi güncelleştirin.
- WSL ile ilgili sorununuzu giderebilecek açık sorunları denetleyin. 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 sorunlarla karşılaşırsanız Windows için CLI'yi yüklemeyi göz önünde bulundurun.
Sonraki Adımlar
Artık Azure CLI'yı yüklediğinize göre, özelliklerinde ve sık kullanılan komutlarında kısa bir gezinti yapın.