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. Menggunakan manajer paket distribusi Linux disarankan, tetapi Anda dapat menginstal Azure CLI secara manual di Linux dengan memilih opsi Instal skrip .

Versi Azure CLI saat ini adalah 2.63.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.

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

2. Untuk RHEL 9 atau CentOS Stream, 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 instalan 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

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

Catatan

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 mendapatkan kesalahan python3: command not found. Pastikan telah disertakan dalam 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 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 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.

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 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 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 masalah terbuka dengan WSL yang mungkin mengatasi masalah 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. 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 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 instalan 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

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

NotImplementedError di 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 az 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 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 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.

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 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 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 masalah terbuka dengan WSL yang mungkin mengatasi masalah 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
  Ubuntu	20.04 LTS (Focal Fossa), 22.04 (Jammy Jellyfish), 24.04 (Noble Numbat)
  Debian	10 (Buster), 11 (Bullseye), 12 (Bookworm)

• Ubuntu 20.04 (Focal Fossa) 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. Untuk informasi selengkapnya tentang apt remove, lihat manajemen paket Ubuntu atau tanyakan ubuntu.

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 seperti yang azure-cli 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, azure-cli informasi repositori 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 instalan 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 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.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

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

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 instruksi di atas untuk menginstal paket terbaruazure-cli.

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 tahan terhadap versi dependensi di masa mendatang dan bergantung pada sesekali. 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 , yang merupakan nama rilis HERAEOS. Solusinya adalah memperbaiki file /etc/apt/sources.list.d/azure-cli.sources dan mengubah Suites: hera menjadi Suites: bionic.

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

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 [username]:[password]@ bagian URI proksi. Jika Anda memerlukan informasi lebih lanjut untuk konfigurasi proksi, lihat dokumentasi resmi Ubuntu:

• halaman apt.conf man
• Ubuntu wiki - apt-get howto

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 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 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 masalah terbuka dengan WSL yang mungkin mengatasi masalah 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 dirilis untuk Azure Linux 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 instalan 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 agar perubahan diterapkan.

Menghapus instalan 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

Pemecahan Masalah

Berikut beberapa masalah umum yang terjadi 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 bisa 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 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 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 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 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 masalah terbuka dengan WSL yang mungkin mengatasi masalah 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 berikutnya

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

Mulai menggunakan Azure CLI