Menginstal Azure CLI di Linux

Azure CLI adalah alat baris perintah lintas platform yang dapat diinstal secara lokal di komputer Linux. Anda dapat menggunakan Azure CLI di Linux untuk terhubung ke Azure dan menjalankan perintah administratif di sumber daya Azure. CLI di Linux memungkinkan eksekusi berbagai perintah melalui terminal menggunakan permintaan baris perintah interaktif atau skrip. Jika sudah siap menginstal Azure CLI di Linux, sebaiknya Anda menggunakan pengelola paket distribusi Linux. Pilih pengelola paket distribusi yang tepat dari opsi di atas. Jika tidak memiliki salah satu pengelola paket yang tercantum, Anda dapat menginstal Azure CLI secara manual di Linux dengan memilih opsi Instal skrip.

Versi Azure CLI saat ini adalah 2.37.0. Untuk informasi tentang rilis terbaru, lihat catatan rilis. Untuk menemukan versi yang terinstal dan melihat apakah Anda perlu memperbarui, jalankan az version.

Gambaran Umum

Manajer paket apt berisi paket x86_64 untuk Azure CLI yang telah diuji pada distribusi berikut.

Distribusi Versi
Ubuntu 18.04 LTS (Bionic Beaver), 20.04 LTS (Focal Fossa), 21.10 (Impish Indri), 22.04 (Jammy Jellyfish)
Debian 10 (Buster), 11 (Bullseye)

Peringatan

Mulai dari Azure CLI 2.37.0, tidak ada paket DEB yang akan dirilis untuk Ubuntu 16.04 (Xenial Xerus) dan Debian 9 (Stretch). Anda dapat terus menggunakan versi historis Azure CLI pada sistem ini, tetapi tidak akan ada pembaruan atau perbaikan bug. Pertimbangkan untuk memutakhirkan ke versi Ubuntu atau Debian yang lebih baru untuk menggunakan Azure CLI terbaru.

Peringatan

Ubuntu 20.04 (Focal Fossa) dan 20.10 (Groovy Gorilla) menyertakan paket azure-cli dengan versi 2.0.81 yang disediakan oleh repositori universe. Paket ini sudah tidak digunakan dan tidak direkomendasikan. Jika paket ini terinstal, hapus paket tersebut sebelum melanjutkan dengan menjalankan perintah sudo apt remove azure-cli -y && sudo apt autoremove -y.

Paket deb azure-cli tidak mendukung arsitektur ARM64.

Opsi Penginstalan

Ada dua opsi untuk menginstal Azure CLI di sistem Anda. Pertama, Anda dapat menjalankan satu perintah yang akan mengunduh skrip instal dan menjalankan perintah instal untuk Anda. Atau jika mau, Anda dapat menjalankan sendiri perintah instal dalam proses langkah demi langkah. Kedua metode disediakan di bawah ini.

Opsi 1: Menginstal dengan satu perintah

Tim Azure CLI mengelola skrip untuk menjalankan semua perintah penginstalan dalam satu langkah. Skrip ini diunduh melalui curl dan disalurkan langsung ke bash untuk menginstal CLI.

Jika Anda ingin memeriksa sendiri isi skrip sebelum menjalankan, cukup unduh skrip terlebih dahulu menggunakan curl dan periksa di editor teks favorit Anda.

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

Opsi 2: Petunjuk penginstalan langkah demi langkah

Jika Anda lebih memilih proses penginstalan langkah demi langkah, selesaikan langkah-langkah berikut untuk menginstal Azure CLI.

  1. Dapatkan paket yang diperlukan untuk proses penginstalan:

    sudo apt-get update
    sudo apt-get install ca-certificates curl apt-transport-https lsb-release gnupg
    
  2. Unduh dan instal kunci penandatanganan Microsoft:

    curl -sL https://packages.microsoft.com/keys/microsoft.asc |
        gpg --dearmor |
        sudo tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null
    
  3. Tambahkan repositori perangkat lunak Azure CLI:
    AZ_REPO=$(lsb_release -cs)
    echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" |
        sudo tee /etc/apt/sources.list.d/azure-cli.list
    
  4. Perbarui informasi repositori dan instal paket azure-cli:

    sudo apt-get update
    sudo apt-get install azure-cli
    

Menginstal versi tertentu

Anda harus terlebih dahulu mengonfigurasi azure-cli informasi repositori seperti yang ditunjukkan di atas. Versi yang tersedia dapat ditemukan di catatan rilis Azure CLI.

  1. Untuk melihat versi yang tersedia dengan perintah:

    apt-cache policy azure-cli
    
  2. Untuk menginstal versi tertentu:

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

Pemecahan Masalah

Berikut adalah beberapa masalah umum yang terlihat saat menginstal dengan apt. Jika Anda mengalami masalah yang tidak tercakup di sini, ajukan masalah di github.

Tidak ada masalah modul pada Ubuntu 20.04 (Focal)/WSL

Jika Anda menginstal azure-cli di Focal tanpa menambahkan repositori perangkat lunak Azure CLI di langkah 3 petunjuk pemasangan manual atau menggunakan skrip kami, Anda mungkin mengalami masalah seperti tidak ada modul bernama 'decorator' atau 'antlr4' karena paket yang Anda instal adalah azure-cli 2.0.81 yang tidak digunakan lagi dari repositori focal/universe. Hapus terlebih dahulu dengan menjalankan sudo apt remove azure-cli -y && sudo apt autoremove -y, lalu ikuti petunjuk di atas untuk menginstal paket azure-cli terbaru.

lsb_release tidak mengembalikan versi distribusi dasar yang benar

Beberapa distribusi turunan Ubuntu atau Debian seperti Linux Mint mungkin tidak mengembalikan nama versi yang benar dari lsb_release. Nilai ini digunakan dalam proses penginstalan untuk menentukan paket yang akan diinstal. Jika Anda mengetahui nama kode versi Ubuntu atau Debian asal distribusi Anda, Anda dapat mengatur nilai AZ_REPO secara manual saat menambahkan repositori. Jika tidak, cari informasi untuk distribusi Anda tentang cara menentukan nama kode distribusi dasar dan atur AZ_REPO ke nilai yang benar.

Tidak ada paket untuk distribusi Anda

Terkadang, mungkin perlu beberapa saat setelah distribusi dirilis sebelum ada paket Azure CLI yang tersedia. Azure CLI dirancang agar kompatibel terhadap versi dependensi yang akan datang dan mengandalkan sesedikit mungkin dependensinya. Jika tidak ada paket yang tersedia untuk distribusi dasar Anda, coba paket untuk distribusi sebelumnya.

Untuk melakukannya, atur nilai AZ_REPO secara manual saat menambahkan repositori. Untuk distribusi Ubuntu gunakan repositori bionic, dan untuk distribusi Debian gunakan stretch. Distribusi yang dirilis sebelum Ubuntu Trusty dan Debian Wheezy tidak didukung.

Elementary OS (EOS) gagal menginstal Azure CLI

EOS gagal menginstal cli Azure karena lsb_release mengembalikan HERA, yang merupakan nama rilis EOS. Solusinya adalah memperbaiki file /etc/apt/sources.list.d/azure-cli.list dan mengubah hera main menjadi bionic main.

Konten file asli:

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

Konten file yang dimodifikasi

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

Koneksi blok proksi

Jika Anda tidak dapat terhubung ke sumber daya eksternal dikarenakan proksi, pastikan Anda telah mengatur variabel HTTP_PROXY dan HTTPS_PROXY dengan benar dalam shell Anda. Anda perlu menghubungi administrator sistem untuk mengetahui host dan port yang akan digunakan untuk proksi ini.

Nilai ini digunakan oleh berbagai program Linux, termasuk nilai yang digunakan dalam proses penginstalan. Untuk mengatur nilai ini:

# 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]

Penting

Jika Anda berada di belakang proksi, variabel shell ini harus diatur untuk terhubung ke layanan Azure dengan CLI. Jika tidak menggunakan autentikasi dasar, sebaiknya Anda mengekspor variabel ini dalam file .bashrc. Selalu ikuti kebijakan keamanan bisnis dan persyaratan administrator sistem Anda.

Sebaiknya Anda juga mengonfigurasi apt secara eksplisit untuk menggunakan proksi ini setiap saat. Pastikan baris berikut muncul dalam file konfigurasi apt di /etc/apt/apt.conf.d/. Sebaiknya gunakan file konfigurasi global yang ada, file konfigurasi proksi yang ada, 40proxies, atau 99local, namun ikuti persyaratan administrasi sistem Anda.

Acquire {
    http::proxy "http://[username]:[password]@[proxy]:[port]";
    https::proxy "https://[username]:[password]@[proxy]:[port]";
}

Jika proksi Anda tidak menggunakan autentikasi dasar, hapus bagian [username]:[password]@ dari URI proksi. Jika Anda memerlukan informasi lebih lanjut untuk konfigurasi proksi, lihat dokumentasi resmi Ubuntu:

Untuk mendapatkan kunci penandatanganan Microsoft dan mendapatkan paket dari repositori kami, proksi Anda harus mengizinkan koneksi HTTPS ke alamat berikut:

  • https://packages.microsoft.com

CLI gagal menginstal atau menjalankan Subsistem Windows untuk Linux

Karena Subsistem Windows untuk Linux (WSL) adalah lapisan terjemahan panggilan sistem di atas platform Windows, Anda mungkin mengalami kesalahan saat mencoba menginstal atau menjalankan Azure CLI. CLI bergantung pada beberapa fitur yang mungkin memiliki bug di WSL. Jika Anda mengalami kesalahan terlepas dari cara menginstal CLI, ada kemungkinan terjadi masalah dengan WSL dan bukan dengan proses penginstalan CLI.

Untuk memecahkan masalah penginstalan WSL Anda dan kemungkinan menyelesaikan masalah:

  • Jika Anda bisa, jalankan proses penginstalan yang sama pada mesin Linux atau VM untuk melihat apakah prosesnya berhasil. Jika berhasil, masalah Anda hampir pasti terkait dengan WSL. Untuk memulai VM Linux di Azure, lihat dokumentasi membuat VM Linux di Portal Azure.
  • Pastikan Anda menjalankan WSL versi terbaru. Untuk mendapatkan versi terbaru, perbarui penginstalan Windows 10 Anda.
  • Periksa apakah ada masalah terbuka dengan WSL yang mungkin mengatasi masalah Anda. Sering kali, akan ada saran tentang cara mengatasi masalah, atau informasi tentang rilis di mana masalah akan diperbaiki.
  • Jika tidak ada masalah untuk masalah Anda, ajukan masalah baru dengan WSL dan pastikan Anda menyertakan informasi sebanyak mungkin.

Jika Anda terus mengalami masalah saat menginstal atau menjalankan WSL, pertimbangkan untuk menginstal CLI untuk Windows.

Pembaruan

CLI menyediakan perintah dalam alat untuk memperbarui ke versi terbaru:

az upgrade

Catatan

Perintah az upgrade ditambahkan dalam versi 2.11.0 dan tidak akan berfungsi dengan versi sebelum 2.11.0. Versi lama dapat diperbarui dengan memasang ulang seperti yang dijelaskan di Memasang Azure CLI.

Perintah ini juga akan memperbarui semua ekstensi yang diinstal secara default. Untuk opsi az upgrade lebih lanjut, lihat halaman referensi perintah.

Anda juga dapat menggunakan apt-get upgrade untuk memperbarui paket CLI.

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

Catatan

Perintah ini memutakhirkan semua paket yang diinstal pada sistem Anda yang tidak mengalami perubahan dependensi. Untuk meningkatkan versi CLI saja, gunakan apt-get install.

sudo apt-get update && sudo apt-get install --only-upgrade -y azure-cli

Hapus instalasi

Jika Anda memutuskan untuk menghapus instalan Azure CLI, kami menyayangkan keputusan Anda. Sebelum Anda menghapus instalan, gunakan perintah az feedback untuk memberi tahu kami area yang dapat ditingkatkan atau diperbaiki. Tujuan kami adalah membuat Azure CLI bebas bug dan mudah digunakan. Jika Anda menemukan bug, kami akan menghargainya jika Anda mengajukan masalah GitHub.

  1. Hapus instalan dengan apt-get remove:

    sudo apt-get remove -y azure-cli
    
  2. Jika Anda tidak berencana untuk menginstal ulang CLI, hapus informasi repositori Azure CLI:

    sudo rm /etc/apt/sources.list.d/azure-cli.list
    
  3. Jika Anda tidak menggunakan paket lain dari Microsoft, hapus kunci penandatanganan:

    sudo rm /etc/apt/trusted.gpg.d/microsoft.gpg
    
  4. Hapus semua paket yang tidak diperlukan:

    sudo apt autoremove
    

Gambaran Umum

Untuk distribusi Linux dengan dnf seperti RHEL, Fedora, atau CentOS, terdapat paket untuk Azure CLI. Paket ini telah diuji dengan RHEL 7.7, RHEL 8, Fedora 24 dan yang lebih tinggi, CentOS 7 dan CentOS Stream 8.

Versi Azure CLI saat ini adalah 2.37.0. Untuk informasi tentang rilis terbaru, lihat catatan rilis. Untuk menemukan versi yang terinstal dan melihat apakah Anda perlu memperbarui, jalankan az version.

Penting

Paket RPM Azure CLI bergantung pada paket python3. Di sistem Anda, ini mungkin versi Python yang mendahului persyaratan Python 3.6.x. Jika hal ini memengaruhi Anda, temukan paket python3 pengganti.

Perlu diketahui bahwa Python 2 sudah dipakai lagi sejak 1 Januari 2020, dan tidak akan menerima pembaruan lagi. Azure CLI telah menghilangkan dukungan untuk Python 2.7 sejak versi 2.1.0. Versi baru tidak lagi menjamin fungsi yang benar dengan Python 2.7.

Catatan

Gunakan pengelola paket yum jika Anda menggunakan sistem Linux yang tidak mendukung pengelola paket dnf.

Instal

  1. Impor kunci repositori Microsoft.

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  2. Untuk RHEL 8 atau CentOS Stream 8, tambahkan packages-microsoft-com-prod repositori:

    sudo dnf install -y https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm
    

    Untuk RHEL 7 atau CentOS 7, tambahkan azure-cli repositori:

    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. Instal dengan perintah dnf install.

    sudo dnf install azure-cli
    

Menginstal versi tertentu

Anda harus terlebih dahulu mengonfigurasi azure-cli informasi repositori seperti yang ditunjukkan di atas. Versi yang tersedia dapat ditemukan di catatan rilis Azure CLI.

  1. Untuk melihat versi yang tersedia dengan perintah:

    dnf list --showduplicates azure-cli
    
  2. Untuk menginstal versi tertentu:

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

Pemecahan Masalah

Berikut beberapa masalah umum yang ditemukan saat menginstal dengan dnf. Jika masalah Anda tidak tercantum di sini, ajukan masalah di GitHub.

Instal di RHEL 7.6 atau sistem lainnya tanpa Python 3

Jika memungkinkan, tingkatkan sistem Anda ke versi dengan dukungan resmi untuk paket python 3.6+. Jika tidak, Anda harus menginstal paket python3 terlebih dahulu, lalu menginstal Azure CLI tanpa dependensi.

Anda dapat menggunakan satu perintah berikut untuk menginstal Azure CLI dengan python 3.6 bawaan dari sumber:

curl -sL https://azurecliprod.blob.core.windows.net/rhel7_6_install.sh | sudo bash

Anda juga dapat melakukannya selangkah demi selangkah:

Pertama, Azure CLI memerlukan SSL 1.1+ dan Anda perlu membangun openssl 1.1 dari sumber sebelum membangun python3:

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

Kemudian, bangun Python 3 dari sumber:

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

Terakhir, ikuti langkah 1 dan 2 dari petunjuk penginstalan untuk menambahkan repositori Azure CLI. Anda kini dapat mengunduh paket dan menginstalnya tanpa dependensi.

Catatan

Jika plugin unduhan dnf tidak diinstal, Anda akan menerima kesalahan perintah tidak ditemukan saat menjalankan kode berikut. Gunakan dnf install 'dnf-command(download)' untuk menginstal plugin unduhan dnf.

sudo dnf download azure-cli
sudo rpm -ivh --nodeps azure-cli-*.rpm

Sebagai alternatif, Anda juga dapat menginstal Python 3 melalui beberapa repositori tambahan. Dengan cara ini, jika Anda telah menyiapkan python3 tetapi masih menerima kesalahan python3: command not found saat mencoba menjalankan cli, Anda perlu menambahkannya ke jalur Anda.

scl enable rh-python36 bash

Koneksi blok proksi

Jika Anda tidak dapat terhubung ke sumber daya eksternal dikarenakan proksi, pastikan Anda telah mengatur variabel HTTP_PROXY dan HTTPS_PROXY dengan benar dalam shell Anda. Anda perlu menghubungi administrator sistem untuk mengetahui host dan port yang akan digunakan untuk proksi ini.

Nilai ini digunakan oleh berbagai program Linux, termasuk nilai yang digunakan dalam proses penginstalan. Untuk mengatur nilai ini:

# 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]

Penting

Jika Anda berada di belakang proksi, variabel shell ini harus diatur untuk terhubung ke layanan Azure dengan CLI. Jika tidak menggunakan autentikasi dasar, sebaiknya Anda mengekspor variabel ini dalam file .bashrc. Selalu ikuti kebijakan keamanan bisnis dan persyaratan administrator sistem Anda.

Sebaiknya Anda juga mengonfigurasi dnf secara eksplisit untuk menggunakan proksi ini setiap saat. Pastikan baris berikut muncul di bawah [main] di bagian /etc/dnf/dnf.conf:

[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

Untuk mendapatkan kunci penandatanganan Microsoft dan memperoleh paket dari repositori kami, proksi Anda perlu mengizinkan koneksi HTTPS ke alamat berikut:

  • https://packages.microsoft.com

CLI gagal menginstal atau menjalankan Subsistem Windows untuk Linux

Karena Subsistem Windows untuk Linux (WSL) adalah lapisan terjemahan panggilan sistem di atas platform Windows, Anda mungkin mengalami kesalahan saat mencoba menginstal atau menjalankan Azure CLI. CLI bergantung pada beberapa fitur yang mungkin memiliki bug di WSL. Jika Anda mengalami kesalahan terlepas dari cara menginstal CLI, ada kemungkinan terjadi masalah dengan WSL dan bukan dengan proses penginstalan CLI.

Untuk memecahkan masalah penginstalan WSL Anda dan kemungkinan menyelesaikan masalah:

  • Jika Anda bisa, jalankan proses penginstalan yang sama pada mesin Linux atau VM untuk melihat apakah prosesnya berhasil. Jika berhasil, masalah Anda hampir pasti terkait dengan WSL. Untuk memulai VM Linux di Azure, lihat dokumentasi membuat VM Linux di Portal Azure.
  • Pastikan Anda menjalankan WSL versi terbaru. Untuk mendapatkan versi terbaru, perbarui penginstalan Windows 10 Anda.
  • Periksa apakah ada masalah terbuka dengan WSL yang mungkin mengatasi masalah Anda. Sering kali, akan ada saran tentang cara mengatasi masalah, atau informasi tentang rilis di mana masalah akan diperbaiki.
  • Jika tidak ada masalah untuk masalah Anda, ajukan masalah baru dengan WSL dan pastikan Anda menyertakan informasi sebanyak mungkin.

Jika Anda terus mengalami masalah saat menginstal atau menjalankan WSL, pertimbangkan untuk menginstal CLI untuk Windows.

Pembaruan

CLI menyediakan perintah dalam alat untuk memperbarui ke versi terbaru:

az upgrade

Catatan

Perintah az upgrade ditambahkan dalam versi 2.11.0 dan tidak akan berfungsi dengan versi sebelum 2.11.0. Versi lama dapat diperbarui dengan memasang ulang seperti yang dijelaskan di Memasang Azure CLI.

Perintah ini juga akan memperbarui semua ekstensi yang diinstal secara default. Untuk opsi az upgrade lebih lanjut, lihat halaman referensi perintah.

Anda juga dapat memperbarui Azure CLI dengan perintah dnf update.

sudo dnf update azure-cli

Hapus instalasi

Jika Anda memutuskan untuk menghapus instalan Azure CLI, kami menyayangkan keputusan Anda. Sebelum Anda menghapus instalan, gunakan perintah az feedback untuk memberi tahu kami area yang dapat ditingkatkan atau diperbaiki. Tujuan kami adalah membuat Azure CLI bebas bug dan mudah digunakan. Jika Anda menemukan bug, kami akan menghargainya jika Anda mengajukan masalah GitHub.

  1. Hapus paket dari sistem Anda.

    sudo dnf remove azure-cli
    
  2. Jika Anda tidak ingin memasang ulang CLI, hapus informasi repositori.

    sudo rm /etc/yum.repos.d/azure-cli.repo
    
  3. Jika Anda tidak menggunakan paket Microsoft lainnya, hapus kunci penandatanganan.

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
    sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
    

Gambaran Umum

RPM dirilis untuk CBL-Mariner 1.0 dan 2.0.

Instal

Instal dengan tdnf install perintah :

sudo tdnf install azure-cli

Menginstal versi tertentu

Versi yang tersedia dapat ditemukan di Catatan rilis Azure CLI.

Untuk melihat versi yang tersedia dengan perintah:

tdnf list azure-cli

Untuk menginstal versi tertentu:

sudo tdnf install azure-cli-<version>-1

Pembaruan

Perbarui Azure CLI dengan tdnf update perintah:

sudo tdnf update azure-cli

Hapus instalasi

Jika Anda memutuskan untuk menghapus instalan Azure CLI, kami menyayangkan keputusan Anda. Sebelum Anda menghapus instalan, gunakan perintah az feedback untuk memberi tahu kami area yang dapat ditingkatkan atau diperbaiki. Tujuan kami adalah membuat Azure CLI bebas bug dan mudah digunakan. Jika Anda menemukan bug, kami akan menghargainya jika Anda mengajukan masalah GitHub.

Hapus paket dari sistem Anda:

sudo tdnf remove azure-cli

Gambaran Umum

Untuk distribusi Linux dengan zypper, seperti openSUSE atau SLES, ada paket yang tersedia untuk Azure CLI. Paket ini telah diuji dengan openSUSE Leap 15.1, dan SLES 15.

Versi Azure CLI saat ini adalah 2.37.0. Untuk informasi tentang rilis terbaru, lihat catatan rilis. Untuk menemukan versi yang terinstal dan melihat apakah Anda perlu memperbarui, jalankan az version.

Penting

Paket RPM Azure CLI bergantung pada paket python3. Di sistem Anda, ini mungkin versi Python yang mendahului persyaratan Python 3.6.x. Jika hal ini memengaruhi Anda, temukan paket python3 pengganti.

Perlu diketahui bahwa Python 2 sudah dipakai lagi sejak 1 Januari 2020, dan tidak akan menerima pembaruan lagi. Azure CLI telah menghilangkan dukungan untuk Python 2.7 sejak versi 2.1.0. Versi baru tidak lagi menjamin fungsi yang benar dengan Python 2.7.

Instal

  1. Instal curl:

    sudo zypper install -y curl
    
  2. Impor kunci repositori Microsoft:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
    
  3. Buat informasi repositori lokal azure-cli:

    sudo zypper addrepo --name 'Azure CLI' --check https://packages.microsoft.com/yumrepos/azure-cli azure-cli
    
  4. Perbarui penginstalan dan indeks paket zypper:

    sudo zypper install --from azure-cli azure-cli
    

    Input 2 untuk tetap memasang dengan mengabaikan beberapa dependensinya.

Menginstal versi tertentu

Anda harus terlebih dahulu mengonfigurasi azure-cli informasi repositori seperti yang ditunjukkan di atas. Versi yang tersedia dapat ditemukan di catatan rilis Azure CLI.

  1. Untuk melihat versi yang tersedia dengan perintah:

    zypper search --details --match-exact azure-cli
    
  2. Untuk menginstal versi tertentu:

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

Pemecahan Masalah

Berikut beberapa masalah umum yang ditemukan saat menginstal dengan zypper. Jika masalah Anda tidak tercantum di sini, ajukan masalah di GitHub.

NotImplementedError di VM OpenSUSE 15

VM OpenSUSE 15 memiliki Azure CLI pra-instal dengan versi 2.0.45, ini sudah usang dan mengalami masalah dengan az login. Hapus beserta dependensinya sebelum mengikuti petunjuk Penginstalan untuk menambahkan Azure CLI terbaru:

sudo zypper rm -y --clean-deps azure-cli

Jika Anda memperbarui Azure CLI tanpa menghapus dependensi versi 2.0.45, dependensi lamanya dapat memengaruhi Azure CLI versi terbaru. Anda perlu menambahkan kembali versi lama untuk ditautkan ke dependensinya, lalu menghapusnya azure-cli bersama dengan dependensinya:

# 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

Instal di SLES 12 atau sistem lain tanpa Python 3.6

Di SLES 12, paket python3 default berupa 3.4 dan tidak didukung oleh Azure CLI. Anda dapat mengikuti langkah 1-3 di petunjuk penginstalan terlebih dahulu untuk menambahkan repositori azure-cli. Kemudian, buat versi python3 yang lebih tinggi dari sumber. Terakhir, Anda dapat mengunduh paket Azure CLI dan menginstalnya tanpa dependensi.

Anda dapat menggunakan satu perintah berikut untuk menginstal atau memperbarui Azure CLI berdasarkan langkah-langkah di atas. Skrip akan menginstal Python 3.8 di bagian /usr/local/azcli dan membuat Azure CLI menggunakannya dengan menetapkan alias az ke PATH=/usr/local/azcli/bin:$PATH az. Anda juga dapat mengunduh skrip dan mengubahnya sesuai kebutuhan Anda. Misalnya, Anda dapat mengubah versi Python atau lokasi penginstalan.

curl -sL https://azurecliprod.blob.core.windows.net/sles12_install_v2.sh | sudo bash

Untuk penginstalan pertama kali, jangan lupa jalankan perintah berikut untuk mengaktifkan alias:

source ~/.bashrc

Koneksi blok proksi

Jika Anda tidak dapat terhubung ke sumber daya eksternal dikarenakan proksi, pastikan Anda telah mengatur variabel HTTP_PROXY dan HTTPS_PROXY dengan benar dalam shell Anda. Anda perlu menghubungi administrator sistem untuk mengetahui host dan port yang akan digunakan untuk proksi ini.

Nilai ini digunakan oleh berbagai program Linux, termasuk nilai yang digunakan dalam proses penginstalan. Untuk mengatur nilai ini:

# 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]

Penting

Jika Anda berada di belakang proksi, variabel shell ini harus diatur untuk terhubung ke layanan Azure dengan CLI. Jika tidak menggunakan autentikasi dasar, sebaiknya Anda mengekspor variabel ini dalam file .bashrc. Selalu ikuti kebijakan keamanan bisnis dan persyaratan administrator sistem Anda.

Sebaiknya Anda juga mengonfigurasi zypper (melalui yast2) secara eksplisit untuk menggunakan proksi ini setiap saat. Untuk melakukannya, jalankan yast2 proxy perintah sebagai superuser, dan isi informasi yang diberikan dalam formulir. Jika memiliki pengelola jendela yang tersedia di sistem, Anda juga dapat menggunakan panel Network Services > Proxy di YaST Control Center.

Untuk mengetahui konfigurasi tingkat lanjutan atau informasi selengkapnya, lihat Dokumentasi Konfigurasi Proksi OpenSUSE

Untuk mendapatkan kunci penandatanganan Microsoft dan mendapatkan paket dari repositori kami, proksi Anda perlu mengizinkan koneksi HTTPS ke alamat berikut:

  • https://packages.microsoft.com
  • https://download.opensuse.org

CLI gagal menginstal atau menjalankan Subsistem Windows untuk Linux

Karena Subsistem Windows untuk Linux (WSL) adalah lapisan terjemahan panggilan sistem di atas platform Windows, Anda mungkin mengalami kesalahan saat mencoba menginstal atau menjalankan Azure CLI. CLI bergantung pada beberapa fitur yang mungkin memiliki bug di WSL. Jika Anda mengalami kesalahan terlepas dari cara menginstal CLI, ada kemungkinan terjadi masalah dengan WSL dan bukan dengan proses penginstalan CLI.

Untuk memecahkan masalah penginstalan WSL Anda dan kemungkinan menyelesaikan masalah:

  • Jika Anda bisa, jalankan proses penginstalan yang sama pada mesin Linux atau VM untuk melihat apakah prosesnya berhasil. Jika berhasil, masalah Anda hampir pasti terkait dengan WSL. Untuk memulai VM Linux di Azure, lihat dokumentasi membuat VM Linux di Portal Azure.
  • Pastikan Anda menjalankan WSL versi terbaru. Untuk mendapatkan versi terbaru, perbarui penginstalan Windows 10 Anda.
  • Periksa apakah ada masalah terbuka dengan WSL yang mungkin mengatasi masalah Anda. Sering kali, akan ada saran tentang cara mengatasi masalah, atau informasi tentang rilis di mana masalah akan diperbaiki.
  • Jika tidak ada masalah untuk masalah Anda, ajukan masalah baru dengan WSL dan pastikan Anda menyertakan informasi sebanyak mungkin.

Jika Anda terus mengalami masalah saat menginstal atau menjalankan WSL, pertimbangkan untuk menginstal CLI untuk Windows.

Masalah sertifikat SSL

Jika sertifikat rusak atau usang pada mesin, Anda mungkin menerima kesalahan yang menunjukkan bahwa curl gagal memverifikasi keabsahan server, sehingga tidak dapat membangun koneksi yang aman. Perbarui sertifikat Anda untuk memperbaiki masalah.

sudo zypper update-ca-certificates

Pembaruan

CLI menyediakan perintah dalam alat untuk memperbarui ke versi terbaru:

az upgrade

Catatan

Perintah az upgrade ditambahkan dalam versi 2.11.0 dan tidak akan berfungsi dengan versi sebelum 2.11.0. Versi lama dapat diperbarui dengan memasang ulang seperti yang dijelaskan di Memasang Azure CLI.

Perintah ini juga akan memperbarui semua ekstensi yang diinstal secara default. Untuk opsi az upgrade lebih lanjut, lihat halaman referensi perintah.

Anda juga dapat memperbarui paket dengan perintah zypper update.

sudo zypper refresh
sudo zypper update azure-cli

Hapus instalasi

Jika Anda memutuskan untuk menghapus instalan Azure CLI, kami menyayangkan keputusan Anda. Sebelum Anda menghapus instalan, gunakan perintah az feedback untuk memberi tahu kami area yang dapat ditingkatkan atau diperbaiki. Tujuan kami adalah membuat Azure CLI bebas bug dan mudah digunakan. Jika Anda menemukan bug, kami akan menghargainya jika Anda mengajukan masalah GitHub.

  1. Hapus paket dari sistem Anda.

    sudo zypper remove -y azure-cli
    
  2. Jika Anda tidak ingin memasang ulang CLI, hapus informasi repositori.

    sudo zypper removerepo azure-cli
    
  3. Jika Anda tidak menggunakan paket Microsoft lainnya, hapus kunci penandatanganan Microsoft.

    MSFT_KEY=`rpm -qa gpg-pubkey /* --qf "%{version}-%{release} %{summary}\n" | grep Microsoft | awk '{print $1}'`
    sudo rpm -e --allmatches gpg-pubkey-$MSFT_KEY
    

Gambaran Umum

Catatan

Sangat disarankan untuk menginstal CLI dengan pengelola paket. Pengelola paket memastikan Anda selalu mendapatkan pembaruan terbaru, dan menjamin stabilitas komponen CLI. Periksa dan pastikan apakah masih ada paket untuk distribusi Anda sebelum menginstal secara manual.

CLI memerlukan perangkat lunak berikut:

Penting

CLI telah menghilangkan dukungan untuk Python 2.7 sejak versi 2.1.0. Versi baru tidak lagi menjamin fungsi yang benar dengan Python 2.7.

Menginstal atau memperbarui

Penginstalan dan pembaruan CLI mengharuskan diwajibkannya eksekusi ulang skrip penginstalan. Instal CLI dengan menjalankan curl.

curl -L https://aka.ms/InstallAzureCli | bash

Skrip juga dapat diunduh dan dijalankan secara lokal. Anda mungkin harus memulai ulang shell agar perubahan diterapkan.

Pemecahan Masalah

Berikut beberapa masalah umum yang terjadi selama penginstalan manual. Jika masalah Anda tidak tercantum di sini, ajukan masalah di GitHub.

Kesalahan curl "Objek yang Dipindahkan"

Jika Anda menerima kesalahan dari curl yang terkait dengan parameter -L, atau pesan kesalahan termasuk teks "Objek Dipindahkan", coba gunakan URL lengkap, bukan pengalihan aka.ms:

curl https://azurecliprod.blob.core.windows.net/install | bash

Perintah az tidak ditemukan

Jika Anda tidak dapat menjalankan perintah setelah penginstalan dan menggunakan bash atau zsh, bersihkan cache hash perintah shell. jalankan

hash -r

dan periksa apakah masalahnya terpecahkan.

Masalah ini juga bisa terjadi jika Anda tidak memulai ulang shell setelah penginstalan. Pastikan lokasi perintah az ada di $PATH Anda. Lokasi perintah az adalah

<install path>/bin

Koneksi blok proksi

Jika Anda tidak dapat terhubung ke sumber daya eksternal dikarenakan proksi, pastikan Anda telah mengatur variabel HTTP_PROXY dan HTTPS_PROXY dengan benar dalam shell Anda. Anda perlu menghubungi administrator sistem untuk mengetahui host dan port yang akan digunakan untuk proksi ini.

Nilai ini digunakan oleh berbagai program Linux, termasuk nilai yang digunakan dalam proses penginstalan. Untuk mengatur nilai ini:

# 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]

Penting

Jika Anda berada di belakang proksi, variabel shell ini harus diatur untuk terhubung ke layanan Azure dengan CLI. Jika tidak menggunakan autentikasi dasar, sebaiknya Anda mengekspor variabel ini dalam file .bashrc. Selalu ikuti kebijakan keamanan bisnis dan persyaratan administrator sistem Anda.

Untuk mendapatkan skrip penginstalan, proksi Anda perlu mengizinkan koneksi HTTPS ke alamat berikut:

  • https://aka.ms/
  • https://azurecliprod.blob.core.windows.net/
  • https://pypi.python.org
  • Titik akhir yang digunakan oleh pengelola paket distribusi Anda (jika ada) untuk paket inti

CLI gagal menginstal atau menjalankan Subsistem Windows untuk Linux

Karena Subsistem Windows untuk Linux (WSL) adalah lapisan terjemahan panggilan sistem di atas platform Windows, Anda mungkin mengalami kesalahan saat mencoba menginstal atau menjalankan Azure CLI. CLI bergantung pada beberapa fitur yang mungkin memiliki bug di WSL. Jika Anda mengalami kesalahan terlepas dari cara menginstal CLI, ada kemungkinan terjadi masalah dengan WSL dan bukan dengan proses penginstalan CLI.

Untuk memecahkan masalah penginstalan WSL Anda dan kemungkinan menyelesaikan masalah:

  • Jika Anda bisa, jalankan proses penginstalan yang sama pada mesin Linux atau VM untuk melihat apakah prosesnya berhasil. Jika berhasil, masalah Anda hampir pasti terkait dengan WSL. Untuk memulai VM Linux di Azure, lihat dokumentasi membuat VM Linux di Portal Azure.
  • Pastikan Anda menjalankan WSL versi terbaru. Untuk mendapatkan versi terbaru, perbarui penginstalan Windows 10 Anda.
  • Periksa apakah ada masalah terbuka dengan WSL yang mungkin mengatasi masalah Anda. Sering kali, akan ada saran tentang cara mengatasi masalah, atau informasi tentang rilis di mana masalah akan diperbaiki.
  • Jika tidak ada masalah untuk masalah Anda, ajukan masalah baru dengan WSL dan pastikan Anda menyertakan informasi sebanyak mungkin.

Jika Anda terus mengalami masalah saat menginstal atau menjalankan WSL, pertimbangkan untuk menginstal CLI untuk Windows.

Hapus instalasi

Jika Anda memutuskan untuk menghapus instalan Azure CLI, kami menyayangkan keputusan Anda. Sebelum Anda menghapus instalan, gunakan perintah az feedback untuk memberi tahu kami area yang dapat ditingkatkan atau diperbaiki. Tujuan kami adalah membuat Azure CLI bebas bug dan mudah digunakan. Jika Anda menemukan bug, kami akan menghargainya jika Anda mengajukan masalah GitHub.

Hapus instalan CLI dengan langsung menghapus file dari lokasi yang dipilih pada saat penginstalan. Lokasi penginstalan default adalah $HOME.

  1. Hapus file CLI yang diinstal.

    rm -r <install location>/lib/azure-cli
    rm <install location>/bin/az
    
  2. Ubah file $HOME/.bash_profile untuk menghapus baris berikut:

    <install location>/lib/azure-cli/az.completion
    
  3. Jika menggunakan bash atau zsh, muat ulang cache perintah shell.

    hash -r
    

Menghapus data

Jika Anda tidak ingin memasang ulang Azure CLI, hapus datanya.

rm -rf ~/.azure

Langkah berikutnya

Setelah menginstal Azure CLI, ikuti tur singkat tentang fiturnya dan perintah umum.