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

Penting

Azure CLI memiliki dependensi pada paket python@3.10 Homebrew, dan akan menginstalnya.

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 bisa selesai, ikuti petunjuk Homebrew di sini.

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.

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

brew update && brew upgrade 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.

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