Menginstal Azure CLI di Linux

Artikel ini menjelaskan cara menginstal Azure CLI di Linux. Pilih manajer paket yang sesuai untuk distribusi Anda dari opsi di bagian atas halaman. Sebaiknya gunakan manajer paket distribusi Linux. Namun, Anda dapat menginstal Azure CLI secara manual di Linux dengan memilih opsi Instal skrip .

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

Sebelum Anda mulai

• Azure CLI 2.38.2 (dirilis pada 21 Juni 2024) adalah versi terakhir yang didukung pada RHEL 7 dan Centos 7. Microsoft tidak lagi menyediakan pembaruan atau perbaikan bug untuk distribusi ini.

• Microsoft terus mengembangkan dan mendukung Azure CLI dan skrip Penginstalan Linux.

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

Menginstal Azure CLI

Untuk menginstal Azure CLI, ikuti langkah-langkah berikut:

1. Impor kunci repositori Microsoft. Untuk RHEL 10 dan CentOS Stream 10,

   sudo rpm --import https://packages.microsoft.com/keys/microsoft-2025.asc
   

   Untuk versi yang lebih rendah, gunakan perintah berikut:

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
   

2. Untuk RHEL 10, tambahkan packages-microsoft-com-prod repositori:

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

   Untuk CentOS Stream 10, tambahkan packages-microsoft-com-prod repositori:

   sudo dnf install -y https://packages.microsoft.com/config/centos/10/packages-microsoft-prod.rpm
   

   Untuk RHEL 9 atau CentOS Stream 9, tambahkan packages-microsoft-com-prod repositori:

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

   Untuk RHEL 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, 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
   

   Perhatian

   CentOS 7 End of Life (EOL) adalah 30 Juni 2024. Untuk informasi tentang lingkungan yang didukung Azure CLI, lihat Siklus hidup dukungan Azure CLI

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 sebelumnya. 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 memasang versi tertentu:

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

Memperbarui Azure CLI

Dimulai dengan versi 2.11.0, Azure CLI menyediakan perintah dalam alat untuk memperbarui ke versi terbaru.

az upgrade

Perintah ini juga memperbarui semua ekstensi yang diinstal secara default. Untuk opsi lainnya az upgrade , lihat halaman referensi perintah. Untuk versi Azure CLI sebelum 2.11.0, perbarui dengan menginstal ulang seperti yang dijelaskan dalam Menginstal Azure CLI.

Anda juga dapat memperbarui Azure CLI dengan perintah dnf update.

sudo dnf update azure-cli

Menghapus pemasangan Azure CLI

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
   

Menghapus data

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

rm -rf ~/.azure

Penyelesaian 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 Anda dapat, tingkatkan sistem Anda ke versi dengan dukungan resmi untuk python 3.6+ paket. Jika tidak, Anda harus terlebih dahulu menginstal python3 paket, lalu menginstal Azure CLI tanpa dependensi.

Anda dapat menggunakan perintah berikut untuk mengunduh dan menginstal skrip penginstalan Azure CLI dengan python 3.6 sumber bawaan:

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 instruksi penginstalan untuk menambahkan repositori Azure CLI. Anda kini dapat mengunduh paket dan menginstalnya tanpa dependensi.

Nota

Jika plugin unduhan dnf belum diinstal, Anda akan mengalami command not found kesalahan 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 menggunakan repositori lain. Gunakan metode ini, jika Anda telah menyiapkan python3 tetapi masih mengalami kesalahan python3: command not found. Pastikan itu telah disertakan dalam jalur Anda.

scl enable rh-python36 bash

Koneksi diblokir oleh 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 Anda untuk mengetahui host dan port apa yang akan digunakan untuk proksi ini.

Nilai dalam variabel ini digunakan oleh banyak program Linux, dan selama 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 disetel 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.

Anda mungkin juga ingin mengonfigurasi dnf secara eksplisit untuk selalu menggunakan proksi ini. 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 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 pada penginstalan WSL Anda dan mungkin menyelesaikan kendala yang ada:

• Jika Anda bisa, jalankan proses penginstalan yang sama pada mesin Linux atau VM untuk melihat apakah prosesnya berhasil. Jika ya, masalah Anda kemungkinan terkait dengan WSL. Untuk memulai VM Linux di Azure, lihat membuat VM Linux dalam dokumentasi portal Azure.
• Pastikan Anda menjalankan WSL versi terbaru. Untuk mendapatkan versi terbaru, perbarui penginstalan Windows 10 Anda.
• Periksa isu terbuka dengan WSL yang mungkin terkait dengan permasalahan Anda. Seringkali ada saran tentang cara mengatasi masalah, atau informasi tentang rilis tempat masalah 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.

Sebelum Anda mulai

• Azure CLI 2.38.2 (dirilis pada 21 Juni 2024) adalah versi terbaru yang didukung di SUSE Linux Enterprise Server (SLES) dan OpenSUSE (Leap). Microsoft tidak lagi menyediakan pembaruan atau perbaikan bug untuk distribusi ini.

• Microsoft terus mengembangkan dan mendukung Azure CLI dan skrip Penginstalan Linux. SUSE memelihara dan mendukung paket yang disediakan oleh repositori SUSE/OpenSUSE.

• Di Azure, komputer virtual (VM) SUSE dan OpenSUSE berdasarkan gambar Marketplace Azure sudah menginstal Azure CLI.

Menginstal Azure CLI

Untuk menginstal Azure CLI di SUSE/OpenSUSE, pilih salah satu metode berikut:

1. Gunakan paket Enterprise yang disediakan oleh SUSE di repositori SUSE/OpenSUSE.

2. Gunakan metode penginstalan yang dijelaskan di tab "Instal skrip (apa pun)".

3. Menginstal dari repositori Microsoft

Menginstal dari repositori SUSE atau OpenSUSE

Paket RPM Azure CLI bergantung pada paket python3.

sudo zypper install -y azure-cli

Menginstal dengan skrip penginstalan

Anda dapat menginstal Azure CLI secara manual di versi Linux apa pun dengan menggunakan opsi Instal skrip .

Jika Anda memperbarui ke versi terbaru menggunakan metode ini, pastikan untuk menghapus instalan versi sebelumnya terlebih dahulu, dan repositori apa pun yang mungkin telah Anda tambahkan untuk versi tersebut.

Menginstal dari repositori Microsoft

Untuk menginstal versi historis terbaru Azure CLI menggunakan repositori Microsoft, ikuti langkah-langkah berikut.

(Paket ini telah diuji dengan SLES 15 dan OpenSUSE Leap 15.1)

1. Instalasi 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 indeks paket zypper dan instal:

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

   Masukkan 2 untuk melanjutkan instalasi dengan mengabaikan beberapa dependensi.

Menginstal versi tertentu

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

1. Lihat versi yang tersedia menggunakan perintah ini:

   zypper search --details --match-exact azure-cli
   

2. Untuk memasang versi tertentu:

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

Memperbarui Azure CLI

Dimulai dengan versi 2.11.0, Azure CLI menyediakan perintah dalam alat untuk memperbarui ke versi terbaru.

az upgrade

Perintah ini juga memperbarui semua ekstensi yang diinstal secara default. Untuk opsi lainnya az upgrade , lihat halaman referensi perintah. Untuk versi Azure CLI sebelum 2.11.0, perbarui dengan menginstal ulang seperti yang dijelaskan dalam Menginstal Azure CLI.

Anda juga dapat memperbarui paket dengan perintah zypper update.

sudo zypper refresh
sudo zypper update azure-cli

Menghapus pemasangan Azure CLI

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
   

Menghapus data

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

rm -rf ~/.azure

Penyelesaian Masalah

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

Instal tanpa Python 3

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.

Ketahuilah bahwa Python 2 telah mencapai akhir masa pakai (EOL) pada 1 Januari 2020, dan tidak akan lagi menerima pembaruan. Azure CLI telah menghilangkan dukungan untuk Python 2.7 sejak versi 2.1.0. Versi CLI yang lebih baru mungkin tidak berjalan dengan benar menggunakan Python 2.7.

Kesalahan NotImplementedError pada VM OpenSUSE 15

OpenSUSE 15 VM memiliki Azure CLI yang telah diinstal sebelumnya dengan versi 2.0.45, yang kedaluarsa dan memiliki masalah dengan az login. Hapus versi ini bersama dengan dependensinya sebelum mengikuti instruksi Instal 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 versi terbaru Azure CLI. 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

Pada SLES 12, paket default python3 adalah 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 menginstal Python 3.8 di bawah /usr/local/azcli dan membuat Azure CLI menggunakannya dengan mengatur alias ke azPATH=/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 diblokir oleh 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 Anda untuk mengetahui host dan port apa yang akan digunakan untuk proksi ini.

Nilai dalam variabel ini digunakan oleh banyak program Linux, dan selama 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 disetel 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.

Anda mungkin juga ingin mengonfigurasi zypper secara eksplisit (melalui yast2) untuk selalu menggunakan proksi ini. 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 pada penginstalan WSL Anda dan mungkin menyelesaikan kendala yang ada:

• Jika Anda bisa, jalankan proses penginstalan yang sama pada mesin Linux atau VM untuk melihat apakah prosesnya berhasil. Jika ya, masalah Anda kemungkinan terkait dengan WSL. Untuk memulai VM Linux di Azure, lihat membuat VM Linux dalam dokumentasi portal Azure.
• Pastikan Anda menjalankan WSL versi terbaru. Untuk mendapatkan versi terbaru, perbarui penginstalan Windows 10 Anda.
• Periksa isu terbuka dengan WSL yang mungkin terkait dengan permasalahan Anda. Seringkali ada saran tentang cara mengatasi masalah, atau informasi tentang rilis tempat masalah 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

Ketika sertifikat rusak atau kedaluwarsa pada komputer, Anda mungkin menerima kesalahan yang menunjukkan bahwa curl gagal memverifikasi legitimasi server, dan karena itu tidak dapat membuat koneksi yang aman. Perbarui sertifikat Anda untuk memperbaiki masalah.

sudo zypper update-ca-certificates

Sebelum Anda mulai

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

  Distribusi	Versi
  Debian	11 (Bullseye), 12 (Bookworm)
  Ubuntu	22.04 (Jammy Jellyfish), 24.04 (Noble Numbat)

Menginstal Azure CLI

Ada dua opsi untuk menginstal Azure CLI di sistem Anda. Anda dapat mengunduh skrip penginstalan yang menjalankan perintah penginstalan untuk Anda, atau Anda dapat menjalankan perintah instal sendiri dalam proses langkah demi langkah. Kedua metode disediakan di sini:

Opsi 1: Menginstal dengan satu perintah

Cara term mudah untuk menginstal Azure CLI adalah melalui skrip yang dikelola oleh tim Azure CLI. Skrip ini menjalankan semua perintah penginstalan dalam satu langkah. Skrip ini diunduh melalui curl dan disalurkan langsung ke bash untuk menginstal CLI.

Jika Anda ingin memeriksa konten skrip sendiri sebelum mengeksekusi, 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 apt-transport-https ca-certificates curl gnupg lsb-release
   

2. Unduh dan instal kunci penandatanganan Microsoft:

   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. Tambahkan repositori perangkat lunak Azure CLI:

   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
   

4. Perbarui informasi repositori dan instal paket azure-cli:

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

Menginstal versi tertentu

Konfigurasikan informasi repositori azure-cli seperti yang ditunjukkan sebelumnya. Versi yang tersedia dapat ditemukan di Catatan rilis Azure CLI.

1. Menampilkan versi Azure CLI yang tersedia.

   apt-cache policy azure-cli
   

2. Instal versi tertentu.

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

   Untuk menginstal versi tertentu tanpa variabel, ganti versi Azure CLI dan nama distribusi Linux yang ditampilkan:

   sudo apt-get install azure-cli=2.51.0-1~bullseye
   

Jika Anda menerima pesan kesalahan Tidak dapat menemukan paket azure-cli, informasi azure-cli repository tidak dikonfigurasi. Ikuti langkah-langkah yang diberikan dalam Opsi 2: Instruksi penginstalan langkah demi langkah.

Jika Anda menerima pesan kesalahan Versi x.xx.x-1~distributionName untuk azure-cli tidak ditemukan, gunakan lsb_release -cs untuk menemukan distribusi yang Anda jalankan.

Memperbarui Azure CLI

Dimulai dengan versi 2.11.0, Azure CLI menyediakan perintah dalam alat untuk memperbarui ke versi terbaru.

az upgrade

Perintah ini juga memperbarui semua ekstensi yang diinstal secara default. Untuk opsi lainnya az upgrade , lihat halaman referensi perintah. Untuk versi Azure CLI sebelum 2.11.0, perbarui dengan menginstal ulang seperti yang dijelaskan dalam Menginstal Azure CLI.

Anda juga dapat menggunakan apt-get upgrade untuk memperbarui paket CLI. Perintah ini meningkatkan semua paket yang diinstal pada sistem Anda yang belum memiliki perubahan dependensi.

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

Untuk meningkatkan versi CLI saja, gunakan apt-get install.

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

Menghapus pemasangan Azure CLI

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. Copot pemasangan 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.sources
   

3. Jika Anda tidak menggunakan paket lain dari Microsoft, hapus kunci penandatanganan:

   sudo rm /etc/apt/keyrings/microsoft.gpg
   

4. Hapus semua paket yang tidak diperlukan:

   sudo apt autoremove
   

Menghapus data

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

rm -rf ~/.azure

Penyelesaian Masalah

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

Paket ini azure-cli mendukung arsitektur ARM64 dari CLI versi 2.46.0.

lsb_release tidak mengembalikan versi distribusi dasar yang benar

Beberapa Ubuntu atau distribusi turunan Debian lainnya (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 tempat distribusi Anda berasal, Anda dapat mengatur AZ_REPO nilai 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, paket Azure CLI yang diperbarui tidak segera tersedia setelah rilis versi distribusi. Azure CLI dirancang agar handal terhadap versi-versi dependensi di masa depan dan mengandalkan sesedikit mungkin dari dependensi tersebut. Jika tidak ada paket yang tersedia untuk distribusi dasar Anda, coba paket untuk distribusi sebelumnya.

Untuk mencoba paket untuk distribusi sebelumnya, atur nilai AZ_REPO secara manual saat menambahkan repositori. Untuk distribusi Ubuntu, gunakan repositori jammy terbaru:

AZ_REPO="jammy"

Untuk distribusi Debian, gunakan repositori bookworm terbaru:

AZ_REPO="bookworm"

Penting

Distribusi yang dirilis sebelum Ubuntu Bionic dan Debian Buster tidak didukung.

Elementary OS (EOS) gagal menginstal Azure CLI

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

Isi dari file asli

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: hera
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Konten file yang dimodifikasi

Types: deb
URIs: https://packages.microsoft.com/repos/azure-cli/
Suites: bionic
Components: main
Architectures: amd64
Signed-by: /etc/apt/keyrings/microsoft.gpg

Koneksi diblokir oleh 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 Anda untuk mengetahui host dan port apa yang akan digunakan untuk proksi ini.

Nilai dalam variabel ini digunakan oleh banyak program Linux, dan selama 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 disetel 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.

Anda mungkin juga ingin mengonfigurasi apt secara eksplisit untuk selalu menggunakan proksi ini. 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 URI proksi. Jika Anda memerlukan informasi lebih lanjut untuk konfigurasi proksi, lihat dokumentasi resmi Ubuntu:

• halaman panduan apt.conf
• Wiki Ubuntu - panduan apt-get

Untuk mendapatkan kunci penandatanganan Microsoft dan mendapatkan 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 pada penginstalan WSL Anda dan mungkin menyelesaikan kendala yang ada:

• Jika Anda bisa, jalankan proses penginstalan yang sama pada mesin Linux atau VM untuk melihat apakah prosesnya berhasil. Jika ya, masalah Anda kemungkinan terkait dengan WSL. Untuk memulai VM Linux di Azure, lihat membuat VM Linux dalam dokumentasi portal Azure.
• Pastikan Anda menjalankan WSL versi terbaru. Untuk mendapatkan versi terbaru, perbarui penginstalan Windows 10 Anda.
• Periksa isu terbuka dengan WSL yang mungkin terkait dengan permasalahan Anda. Seringkali ada saran tentang cara mengatasi masalah, atau informasi tentang rilis tempat masalah 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.

Menginstal Azure CLI

RPM untuk Azure Linux dirilis melalui CBL-Mariner. Paket ini azure-cli mendukung arsitektur ARM64 dari CLI versi 2.46.0.

Untuk menginstal Azure CLI, ikuti langkah-langkah berikut:

1. Instal sekumpulan sertifikat akar tepercaya resmi yang dikumpulkan Microsoft:

   sudo tdnf install ca-certificates
   

2. Instal Azure CLI:

   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

Memperbarui Azure CLI

Perbarui Azure CLI dengan perintah tdnf update:

sudo tdnf update azure-cli

Menghapus pemasangan Azure CLI

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

Menghapus data

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

rm -rf ~/.azure

Sebelum Anda mulai

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

Skrip penginstalan untuk Azure CLI memerlukan perangkat lunak berikut:

• Python 3.8.x, 3.9.x, 3.10.x - Untuk informasi selengkapnya, lihat Siklus hidup dukungan - Dependensi Python.
• libffi
• OpenSSL 1.0.2

Menginstal atau memperbarui Azure CLI

Penting

Skrip penginstalan hanya berfungsi pada Python 3.8.x, 3.9.x, atau 3.10.x. Skrip penginstalan ini tidak berfungsi pada Python 3.11.x atau versi yang lebih baru.

Menginstal dan memperbarui Azure CLI memerlukan penginstalan ulang skrip penginstalan:

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

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

Menghapus pemasangan Azure CLI

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 direktori beranda pengguna ($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

Penyelesaian Masalah

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

Instal tanpa Python 3

Azure CLI telah menghilangkan dukungan untuk Python 2.7 sejak versi 2.1.0. Pada sistem Anda, mungkin ada versi Python yang mendahului persyaratan Python 3.6.x. Temukan paket pengganti python3 .

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 menggunakan bash atau zsh, coba hapus cache hash perintah shell Anda dan periksa apakah masalah diselesaikan.

hash -r

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

 <install path>/bin

Koneksi diblokir oleh 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 Anda untuk mengetahui host dan port apa yang akan digunakan untuk proksi ini.

Nilai dalam variabel ini digunakan oleh banyak program Linux, dan selama 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 disetel 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 pada penginstalan WSL Anda dan mungkin menyelesaikan kendala yang ada:

• Jika Anda bisa, jalankan proses penginstalan yang sama pada mesin Linux atau VM untuk melihat apakah prosesnya berhasil. Jika ya, masalah Anda kemungkinan terkait dengan WSL. Untuk memulai VM Linux di Azure, lihat membuat VM Linux dalam dokumentasi portal Azure.
• Pastikan Anda menjalankan WSL versi terbaru. Untuk mendapatkan versi terbaru, perbarui penginstalan Windows 10 Anda.
• Periksa isu terbuka dengan WSL yang mungkin terkait dengan permasalahan Anda. Seringkali ada saran tentang cara mengatasi masalah, atau informasi tentang rilis tempat masalah 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.

Langkah Selanjutnya

Sekarang setelah Anda menginstal Azure CLI, ikuti tur singkat fitur dan perintah umumnya.

Mulai menggunakan Azure CLI