Menginstal Azure CLI di macOS

Azure Command-Line Interface (CLI) memungkinkan eksekusi perintah melalui terminal menggunakan permintaan baris perintah interaktif atau skrip. Anda dapat menginstal Azure CLI secara lokal di komputer macOS. Azure CLI di macOS memungkinkan eksekusi berbagai perintah melalui terminal menggunakan permintaan baris perintah interaktif atau skrip.

Untuk platform macOS, Anda dapat menginstal Azure CLI dengan pengelola paket homebrew. Homebrew memudahkan penginstalan pembaruan CLI tetap diperbarui. Paket CLI telah diuji di macOS versi 10.9 dan yang lebih baru.

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

Menginstal dengan Homebrew

Homebrew adalah cara termudah untuk mengelola penginstalan CLI Anda. Ini menyediakan cara yang mudah untuk menginstal, memperbarui, dan menghapus instalan. Jika Anda belum memiliki homebrew di sistem Anda, instal homebrew sebelum melanjutkan.

Anda dapat menginstal Azure CLI di macOS dengan memperbarui informasi repositori homebrew, lalu menjalankan perintah install:

brew update && brew install azure-cli

Pemecahan Masalah

Jika Anda mengalami masalah saat menginstal CLI melalui Homebrew, berikut beberapa daftar kesalahan umum. Jika masalah Anda tidak tercantum di sini, ajukan masalah di GitHub.

Penyelesaian tidak berfungsi

Rumus Homebrew di Azure CLI menginstal file penyelesaian bernama az di direktori penyelesaian yang dikelola Homebrew (lokasi default adalah /usr/local/etc/bash_completion.d/). Untuk mengaktifkan penyelesaian, ikuti instruksi Homebrew di sini.

Untuk Zsh, tambahkan dua baris berikut ke bagian bawah file Anda .zshrc , lalu simpan dan muat ulang profil Zsh Anda.

autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az

Tidak dapat menemukan Python atau paket yang diinstal

Mungkin ada ketidakcocokan versi kecil atau masalah lain selama penginstalan homebrew. CLI tidak menggunakan lingkungan virtual Python, sehingga ini bergantung pada penemuan versi Python yang diinstal. Kemungkinan perbaikannya adalah dengan menginstal dan menautkan ulang dependensi python@3.10 dari Homebrew.

brew update && brew install python@3.10 && brew upgrade python@3.10
brew link --overwrite python@3.10

CLI versi 1.x diinstal

Jika versi yang usang diinstal, hal ini bisa jadi karena cache homebrew juga sudah tidak terpakai. Ikuti petunjuk pembaruan.

Koneksi blok proksi

Anda mungkin tidak bisa mendapatkan sumber daya dari Homebrew kecuali Anda telah mengonfigurasinya dengan benar untuk menggunakan proksi Anda. Ikuti Petunjuk konfigurasi proksi Homebrew.

Penting

Jika Anda berada di belakang proksi, HTTP_PROXY dan HTTPS_PROXY 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 sumber daya botol dari Homebrew, proksi Anda perlu mengizinkan koneksi HTTPS ke alamat berikut:

  • https://formulae.brew.sh
  • https://homebrew.bintray.com

Pembaruan

CLI diperbarui secara rutin disertai perbaikan bug, penyempurnaan, fitur baru, dan fungsionalitas pratinjau. Rilis baru tersedia kira-kira setiap tiga minggu.

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 informasi repositori Homebrew lokal dan kemudian meningkatkan paket azure-cli.

brew update && brew upgrade azure-cli

Menghapus instalan

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.

Gunakan homebrew untuk menghapus instalan paket azure-cli.

brew uninstall azure-cli

Menghapus data

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

rm -rf ~/.azure

Metode penginstalan lainnya

Jika Anda tidak dapat menggunakan homebrew untuk menginstal Azure CLI di lingkungan Anda, gunakan petunjuk penggunaan untuk Linux. Proses ini tidak secara resmi dipertahankan agar kompatibel dengan macOS. Sebaiknya selalu gunakan pengelola paket seperti Homebrew. Hanya gunakan metode penginstalan manual jika Anda tidak ada opsi lain yang tersedia.

Untuk petunjuk penginstalan manual, lihat Menginstal Azure CLI di Linux secara manual.

Langkah berikutnya

Setelah Anda menginstal Azure CLI di macOS, ikuti tur singkat tentang fitur dan perintah umumnya.