Linux'ta Azure CLI'yi yükleme

Azure CLI, Linux bilgisayarlara yerel olarak yüklenebilen platformlar arası bir komut satırı aracıdır. Linux üzerinde Azure CLI kullanarak Azure'a bağlanabilir ve Azure kaynaklarında yönetim komutlarını yürütebilirsiniz. Linux üzerinde CLI, etkileşimli komut satırı istemleri veya betik kullanarak terminal aracılığıyla çeşitli komutların yürütülmesine olanak tanır. Azure CLI'yi Linux'a yüklemeye hazır olduğunuzda, Linux dağıtımının paket yöneticisini kullanmanız önerilir. Yukarıdaki seçeneklerden dağıtımınız için uygun paket yöneticisini seçin. Listelenen paket yöneticilerinden birine sahip değilseniz, Betiği yükle seçeneğini belirleyerek Azure CLI'yı Linux'a el ile yükleyebilirsiniz.

Azure CLI'nın geçerli sürümü 2.44.1'dir. 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.

Genel Bakış

RHEL 8/9 veya CentOS Stream 8/9 gibi Linux dağıtımları dnf için Azure CLI için RPM paketleri vardır.

Uyarı

Azure CLI 2.39.0'dan başlayarak (02.08.2022'de yayımlandı), RHEL 7 ve CentOS 7 için rpm paketi yayınlanmayacaktır. Bu sistemlerde Azure CLI'nın geçmiş sürümlerini kullanmaya devam edebilirsiniz, ancak güncelleştirme veya hata düzeltmesi olmayacaktır. En son Azure CLI'yi kullanmak için RHEL veya CentOS'un daha yeni sürümlerine yükseltmeyi göz önünde bulundurun.

Azure CLI'nın geçerli sürümü 2.44.1'dir. 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.

Ö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, sürümünden 2.1.0bu yana Python 2.7 desteğini bıraktı. Yeni sürümlerin artık Python 2.7 ile doğru şekilde çalışması garanti değildir.

Not

Paket yöneticisini desteklemeyen dnf Linux sistemleri kullanıyorsanız paket yöneticisini kullanınyum.

Yükleme

  1. Microsoft depo anahtarını içeri aktarın.

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. RHEL 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.rpm
    

    RHEL 8 veya CentOS Stream 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 veya CentOS 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
    
  3. dnf install komutu ile yükleyin.

    sudo dnf install azure-cli
    

Belirli bir sürümü yükleme

Önce yukarıda gösterildiği gibi depo bilgilerini yapılandırmanız azure-cli gerekir. Kullanılabilir sürümler Azure CLI sürüm notlarında bulunabilir.

  1. Komutuyla kullanılabilir sürümleri görüntülemek için:

    dnf list --showduplicates azure-cli
    
  2. Belirli bir sürümü yüklemek için:

    sudo dnf install azure-cli-<version>-1.el7
    

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 bildirin.

RHEL 7.6 veya Python 3 içermeyen diğer sistemlere yükleme

Yapabilirseniz, lütfen sisteminizi resmi paket desteğine sahip bir sürüme python 3.6+ yükseltin. Aksi takdirde, önce bir python3 paket yüklemeniz ve sonra bağımlılık olmadan Azure CLI'yı yüklemeniz gerekir.

Azure CLI'yi kaynaktan derlenmiş olarak python 3.6 yüklemek için aşağıdaki tek 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 önce python3kaynaktan 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 deposu 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 yüklü değilse aşağıdaki kodu yürütürken komutu bulunamadı hatasıyla 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'ü bazı ek depolar aracılığıyla da yükleyebilirsiniz. Bu şekilde, ayarladıysanız python3 ancak cli'yi çalıştırmaya çalışırken hata python3: command not found almaya devam ediyorsanız, bunu yolunuza eklemeniz gerekir.

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 kullanılacağını öğrenmek için sistem yöneticinize başvurmanız gerekir.

Bu değerler, yükleme işleminde kullanılanlar da dahil olmak üzere birçok Linux programı tarafından kabul edilir. 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.

Bu ara sunucuyu her zaman kullanmak için 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.confemin 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

Microsoft imzalama anahtarını almak ve paketi depomuzdan almak için ara sunucunuzun 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 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üklemenizle ilgili sorunları 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 WSL ile neredeyse kesinlikle 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 sorunun nasıl çözüleceğiyle ilgili öneriler veya sorunun düzeltileceği 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 fazla bilgi eklediğinizden emin olun.

WSL'yi yüklerken veya çalıştırırken sorunlarla karşılaşırsanız Windows için CLI'yı yüklemeyi göz önünde bulundurun.

Güncelleştir

CLI, en son sürüme güncelleştirmek için bir araç içi komut sağlar:

az upgrade

Not

Komut az upgrade 2.11.0 sürümüne eklendi ve 2.11.0 öncesi sürümlerle çalışmaz. Azure CLI'yi yükleme bölümünde açıklandığı gibi eski sürümler yeniden yüklenerek güncelleştirilebilir.

Bu komut, varsayılan olarak tüm yüklü uzantıları da güncelleştirir. az upgrade Diğer seçenekler için lütfen komut başvuru sayfasına bakın.

Azure CLI'yi komutuyla dnf update da güncelleştirebilirsiniz.

sudo dnf update azure-cli

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.

  1. Paketi sisteminizden kaldırın.

    sudo dnf remove azure-cli
    
  2. CLI’yı yeniden yüklemeyi planlamıyorsanız, depo bilgilerini kaldırın.

    sudo rm /etc/yum.repos.d/azure-cli.repo
    
  3. Başka bir Microsoft paketi 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
    

Uyarı

Microsoft tarafından SUSE Linux Enterprise Server (SLES) ve OpenSUSE (Leap) için geliştirilen son Azure CLI paketi 2.39.0 sürümüdür (02.08.2022 tarihinde yayımlandı). Bu sistemlerde Azure CLI'nın geçmiş sürümlerini kullanmaya devam edebilirsiniz, ancak bu sürümler için Microsoft'tan başka güncelleştirme veya hata düzeltmesi olmayacaktır.

Azure CLI ve Linux Yükleme betiği Microsoft tarafından geliştirilmeye ve desteklenmeye devam edecektir. SUSE/OpenSUSE depoları tarafından sağlanan paketler SUSE tarafından korunur ve desteklenir.

Genel Bakış

Azure'da, Azure Market görüntüleri temel alan SUSE ve OpenSUSE sanal makinelerinde (VM) Azure Command-Line Arabirimi (Azure CLI) zaten yüklüdür.

SUSE/OpenSUSE üzerine Azure CLI yüklemek için lütfen aşağıdaki yöntemlerden birini seçin:

  1. SUSE/OpenSUSE depolarında SUSE tarafından sağlanan Kurumsal paketi kullanın.

  2. "Betik yükle (any)" sekmesinde açıklanan yükleme yöntemini kullanın.

Azure CLI'yı yükleme

SUSE veya OpenSUSE depolarından 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ü sonuna (EOL) ulaştığını ve artık güncelleştirme almayacaklarını unutmayın. Azure CLI sürümünden bu yana 2.1.0Python 2.7 desteğini bıraktı. Yeni sürümlerin artık Python 2.7 ile doğru şekilde çalışması garanti değildir.

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 aşağıdaki adımları izleyin.

(Bu paket SLES 15 ve OpenSUSE Leap 15.1 ile test edilmiştir)

  1. curl yükleme:

    sudo zypper install -y curl
    
  2. Microsoft depo anahtarını içeri aktarın:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  3. Yerel azure-cli deposu bilgilerini oluşturun:

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
    
  4. 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 yukarıda gösterildiği gibi depo bilgilerini yapılandırmanız azure-cli gerekir. Kullanılabilir sürümler Azure CLI sürüm notlarında bulunabilir.

  1. Bu komutu kullanarak kullanılabilir sürümleri görüntüleyin:

    zypper search --details --match-exact azure-cli
    
  2. Belirli bir sürümü yüklemek için:

    sudo zypper install --from azure-cli azure-cli=<version>-1.el7
    

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.

OpenSUSE 15 VM'de NotImplementedError

OpenSUSE 15 VM'sinin sürümü 2.0.45'e sahip önceden yüklenmiş bir Azure CLI'sı vardır. Bu, eskidir ve ile az loginilgili sorunları vardır. En son Azure CLI'yi eklemek için Yükleme yönergelerini takip etmeden önce lütfen bu sürümü ve bağımlılıklarını 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 öğesini 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

SLES 12 veya Python 3.6 olmayan 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 komutu kullanabilirsiniz. Betik altında Python 3.8'i /usr/local/azcli yükler ve bir diğer adı olarak ayarlayarak Azure CLI'nin azPATH=/usr/local/azcli/bin:$PATH azbunu kullanmasını sağlar. Ayrıca betiği indirebilir ve gereksinimlerinize 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 kullanılacak konakları ve bağlantı noktası bilgilerini öğrenmek için sistem yöneticinize başvurmanız gerekir.

Bu değerler, yükleme işleminde kullanılanlar da dahil olmak üzere birçok Linux programı tarafından kabul edilir. 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

Bir 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.

Bu ara sunucuyu her zaman kullanmak için açıkça (aracılığıylayast2) da yapılandırmak zypper 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, içindeki bölmeyi Network Services > ProxyYaST Control Centerde 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 proxy'nizin aşağıdaki adreslerle 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 üzerindeki 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 WSL ile neredeyse kesinlikle ilgilidir. Azure'da Linux VM'sini 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 sorunun nasıl çözüleceğiyle ilgili öneriler veya sorunun düzeltileceği bir sürüm hakkında bilgiler olacaktır.
  • Sorununuz için mevcut bir sorun yoksa WSL ile yeni bir sorun oluşturun ve mümkün olduğunca fazla 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 bozuk veya güncelliğini yitirmişse curl'in sunucunun meşruluğunu doğrulayamadığini ve bu nedenle güvenli bir bağlantı kuramadığını belirten bir hata alabilirsiniz. Sorunu düzeltmek için sertifikanızı güncelleştirin.

sudo zypper update-ca-certificates

Güncelleştir

CLI, en son sürüme güncelleştirmek için bir araç içi komut sağlar:

az upgrade

Not

Komut az upgrade 2.11.0 sürümüne eklendi ve 2.11.0 öncesi sürümlerle çalışmaz. Azure CLI'yi yükleme bölümünde açıklandığı gibi eski sürümler yeniden yüklenerek güncelleştirilebilir.

Bu komut, varsayılan olarak tüm yüklü uzantıları da güncelleştirir. az upgrade Diğer seçenekler için lütfen komut başvuru sayfasına bakın.

Paketi komutuyla zypper update da güncelleştirebilirsiniz.

sudo zypper refresh
sudo zypper update azure-cli

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.

  1. Paketi sisteminizden kaldırın.

    sudo zypper remove -y azure-cli
    
  2. CLI’yı yeniden yüklemeyi planlamıyorsanız, depo bilgilerini kaldırın.

    sudo zypper removerepo azure-cli
    
  3. 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
    

Genel Bakış

Paket yöneticisi, apt Azure CLI için aşağıdaki dağıtımlarda test edilmiş bir x86_64 paketi içerir.

Dağıtım Sürüm
Ubuntu 18.04 LTS (Bionic Beaver), 20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish)
Debian 10 (Buster), 11 (Bullseye)

Uyarı

Eski sistemlerde Azure CLI'nın geçmiş sürümlerini kullanmaya devam edebilirsiniz, ancak güncelleştirme veya hata düzeltmesi olmayacaktır. En son Azure CLI'yi kullanmak için Ubuntu veya Debian'ın daha yeni sürümlerine yükseltmeyi göz önünde bulundurun.

Uyarı

Ubuntu 20.04 (Focal Fossa) ve 20.10 (Groovy Gorilla) depo tarafından universe sağlanan sürüme 2.0.81 sahip bir azure-cli paket içerir. Bu paket güncel değil ve önerilmez. Bu paket yüklüyse komutunu çalıştırarak sudo apt remove azure-cli -y && sudo apt autoremove -ydevam etmeden önce paketi kaldırın. Ubuntu paket yönetimine bakın veya hakkında apt removedaha fazla bilgi için ubuntu'dan isteyin.

azure-cli Deb paketi ARM64 mimarisini desteklemiyor.

Yükleme Seçenekleri

Azure CLI'yi sisteminize yüklemek için iki seçenek vardır. İlk olarak, bir yükleme betiği indirecek ve yükleme komutlarını sizin için çalıştıracak tek bir komut yürütebilirsiniz. İsterseniz, yükleme komutlarını adım adım bir işlemde kendiniz yürütebilirsiniz. Her iki yöntem de aşağıda verilmiştir.

1. Seçenek: Tek bir komutla yükleme

Azure CLI ekibi, tüm yükleme komutlarını tek adımda çalıştırmak için bir betik tutar. Bu betik aracılığıyla curl indirilir ve CLI'yi yüklemek için doğrudan bash adresine iletilir.

Yürütmeden önce betiğin içeriğini kendiniz incelemek isterseniz, betiği önce kullanarak curl indirip en sevdiğiniz metin düzenleyicide incelemeniz yeterlidir.

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

Seçenek 2: 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.

  1. Yükleme işlemi için gereken paketleri alın:

    sudo apt-get update
    sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg
    
  2. 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
    
  3. Azure CLI yazılım deposunu ekleyin:
    AZ_REPO=$(lsb_release -cs)
    echo "deb [arch=`dpkg --print-architecture` signed-by=/etc/apt/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" |
        sudo tee /etc/apt/sources.list.d/azure-cli.list
    
  4. 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

Önce yukarıda gösterildiği gibi depo bilgilerini yapılandırmanız azure-cli gerekir. Kullanılabilir sürümler Azure CLI sürüm notlarında bulunabilir.

  1. Komutuyla kullanılabilir sürümleri görüntülemek için:

    apt-cache policy azure-cli
    
  2. Belirli bir sürümü yüklemek için:

    sudo apt-get install azure-cli=<version>-1~bullseye
    

Sorun giderme

apt ile yükleme sırasında görülen yaygın sorunlardan bazıları burada verilmiştir. Açıklaması buraya eklenmemiş olan bir sorun yaşıyorsanız github’da bir sorun oluşturun.

Ubuntu 20.04 (Focal)/WSL'de modül sorunu yok

El ile yükleme yönergelerinin 3. adımında Azure CLI yazılım deposunu eklemeden veya betiğimizi kullanmadan uygulamasını yüklediyseniz azure-cliFocal, 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. Lütfen önce komutunu çalıştırarak sudo apt remove azure-cli -y && sudo apt autoremove -ykaldı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

Linux Mint gibi Ubuntu veya Debian türevi bazı dağıtımlar lsb_release öğesinden 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ıza ilişkin bilgileri arayın.

Dağıtımınız için paket yok

Bazen bir dağıtım kullanıma sunulmadan önce bir Azure CLI paketi kullanıma sunulmadan önce bir süre sonra olabilir. Azure CLI, bağımlılıkların gelecek sürümleriyle ilgili olarak dayanıklı olacak şekilde tasarlanmıştır ve 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.

Bunu yapmak 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 bullseye depoyu kullanın:

AZ_REPO="bullseye"

Ubuntu Bionic ve Debian Buster'dan önce yayımlanan dağıtımlar desteklenmez.

Temel İşletim Sistemi (EOS) Azure CLI'yi yükleyemiyor

EOS, EOS yayın adı olan değerini döndürdüğünden lsb_releaseHERAAzure cli'yi yükleyemiyor. Çözüm, dosyasını /etc/apt/sources.list.d/azure-cli.list düzeltmek ve olarak değiştirmektir hera mainbionic main.

Özgün dosya içeriği:

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ hera main

Değiştirilen dosya içeriği

deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ bionic main

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 kullanılacak konakları ve bağlantı noktası bilgilerini öğrenmek için sistem yöneticinize başvurmanız gerekir.

Bu değerler, yükleme işleminde kullanılanlar da dahil olmak üzere birçok Linux programı tarafından kabul edilir. 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

Bir 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 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ı 40proxiesveya 99localkullanmanı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]@. Proxy 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 ara sunucunuzun 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 yüklenemiyor veya çalıştırılamıyor

Linux için Windows Alt Sistemi (WSL), Windows platformunun üzerindeki 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 WSL ile neredeyse kesinlikle ilgilidir. Azure'da Linux VM'sini 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 sorunun nasıl çözüleceğiyle ilgili öneriler veya sorunun düzeltileceği bir sürüm hakkında bilgiler olacaktır.
  • Sorununuz için mevcut bir sorun yoksa WSL ile yeni bir sorun oluşturun ve mümkün olduğunca fazla 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.

Güncelleştir

CLI, en son sürüme güncelleştirmek için bir araç içi komut sağlar:

az upgrade

Not

Komut az upgrade 2.11.0 sürümüne eklendi ve 2.11.0 öncesi sürümlerle çalışmaz. Azure CLI'yi yükleme bölümünde açıklandığı gibi eski sürümler yeniden yüklenerek güncelleştirilebilir.

Bu komut, varsayılan olarak tüm yüklü uzantıları da güncelleştirir. az upgrade Diğer seçenekler için lütfen komut başvuru sayfasına bakın.

CLI paketini güncelleştirmek için de kullanabilirsiniz apt-get upgrade .

sudo apt-get update && sudo apt-get upgrade

Not

Bu komut, sisteminizde yüklü olup bir bağımlılık değişikliği olmayan tüm paketleri yükseltir. 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

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.

  1. ile apt-get removekaldır:

    sudo apt-get remove -y azure-cli
    
  2. CLI'yi yeniden yüklemeyi planlamıyorsanız Azure CLI depo bilgilerini kaldırın:

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Microsoft'tan başka paket kullanmıyorsanız imzalama anahtarını kaldırın:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.gpg
    
  4. Gereksiz paketleri kaldırın:

    sudo apt autoremove
    

Genel Bakış

RPM'ler CBL-Mariner 2.0 için piyasaya sürülür.

Yükleme

komutuyla tdnf install yükleyin:

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.

Komutuyla 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

Güncelleştir

Azure CLI'yi şu komutla güncelleştirin tdnf update :

sudo tdnf update azure-cli

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

Genel Bakış

Not

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. Kendiniz yüklemeden önce dağıtımınız için bir paket olup olmadığını denetleyin.

CLI için aşağıdaki yazılımlar gerekir:

Önemli

CLI, sürümünden 2.1.0bu yana Python 2.7 desteğini bıraktı. Yeni sürümlerin artık Python 2.7 ile doğru şekilde çalışmasını garanti etmemektedir.

Yükleme veya güncelleştirme

CLI’yı hem yüklemek hem de güncelleştirmek için yükleme betiğini yeniden çalıştırmanız gerekir. curl betiğini çalıştırarak CLI’yı yükleyin.

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.

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 bildirin.

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ı

Yükleme işleminden sonra veya bash ya da zsh kullanarak komutu çalıştıramazsanız, kabuğun komut karması önbelleğini temizleyin. Çalıştır

hash -r

ve sorunun çözülüp çözülmediğini denetleyin.

Yükleme sonrasında kabuğunuzu yeniden başlatmadıysanız bu sorun oluşabilir. az komutunun $PATH içinde bulunduğundan emin olun. az komutunun 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 kullanılacağını öğrenmek için sistem yöneticinize başvurmanız gerekir.

Bu değerler, yükleme işleminde kullanılanlar da dahil olmak üzere birçok Linux programı tarafından kabul edilir. 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 ara sunucunuzun 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üklemenizle ilgili sorunları 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 WSL ile neredeyse kesinlikle 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 sorunun nasıl çözüleceğiyle ilgili öneriler veya sorunun düzeltileceği 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 fazla bilgi eklediğinizden emin olun.

WSL'yi yüklerken veya çalıştırırken sorunlarla karşılaşırsanız Windows için CLI'yı yüklemeyi göz önünde bulundurun.

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: $HOME.

  1. Yüklü CLI dosyalarını kaldırın.

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. $HOME/.bash_profile dosyanızı değiştirerek şu satırı kaldırın:

    <install location>/lib/azure-cli/az.completion
    
  3. bash veya zsh 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

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.