Menginstal Azure CLI di macOS

Azure Command-Line Interface (CLI) adalah alat baris perintah lintas platform yang dapat diinstal secara lokal di komputer macOS. Anda dapat menggunakan Azure CLI untuk menyambungkan ke Azure dan menjalankan perintah administratif pada sumber daya Azure menggunakan perintah baris perintah interaktif atau skrip.

Untuk platform macOS, instal Azure CLI dengan pengelola paket homebrew . Homebrew memudahkan untuk menjaga penginstalan Azure CLI Anda tetap terbarui. Paket Azure CLI memerlukan macOS 13 atau yang lebih tinggi.

Versi Azure CLI saat ini adalah 2.75.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 term mudah untuk mengelola penginstalan Azure CLI Anda. Ini menyediakan cara yang praktis untuk menginstal, memperbarui, dan mencopot. 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

Penyelesaian Masalah

Jika Anda mengalami masalah saat menginstal Azure CLI melalui Homebrew, berikut adalah beberapa 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 menyelesaikan pengaturan, ikuti instruksi dari 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 minor atau masalah lain selama penginstalan perangkat lunak "homebrew" (software yang dirakit sendiri). Azure CLI tidak menggunakan lingkungan virtual Python, sehingga bergantung pada menemukan 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

Azure CLI versi 1.x diinstal

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

Koneksi diblokir oleh proksi

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

Penting

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

Untuk mendapatkan sumber daya botol dari Homebrew, proksi Anda harus mengizinkan koneksi HTTPS ke alamat berikut:

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

Pemutakhiran

Azure CLI diperbarui secara teratur dengan perbaikan bug, peningkatan, fitur baru, dan fungsionalitas pratinjau. Rilis baru tersedia sekitar sebulan sekali.

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

Uninstal

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 berencana untuk menginstal 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. Menggunakan manajer paket seperti Homebrew disarankan. 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 Selanjutnya

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

Mulai menggunakan Azure CLI