Menginstal Azure CLI di macOS - Pratinjau

Azure CLI adalah alat baris perintah lintas platform untuk mengelola sumber daya Azure secara interaktif atau melalui skrip.

Di macOS, Azure CLI beralih menjauh dari rumus Homebrew Core ke model penginstalan yang lebih dapat dipertahankan dan fleksibel. Model baru mencakup:

• Homebrew Cask (direkomendasikan untuk sebagian besar pengguna)
• Tarball (disarankan untuk lingkungan offline atau terisolasi)

Pengalaman ini saat ini dalam pratinjau dan akan menjadi pendekatan penginstalan standar dalam rilis mendatang.

Mengapa menggunakan Homebrew Cask?

• Pengalaman penginstalan dan peningkatan paling sederhana
• Mengelola dependensi secara otomatis
• Menyelaraskan dengan model penginstalan yang didukung di masa mendatang

Apa yang berubah

Azure CLI berkembang untuk mendukung autentikasi yang lebih aman, termasuk autentikasi berbasis broker. Kemampuan ini memerlukan model penginstalan berbasis cask. Akibatnya, kami beralih dari Homebrew Core ke Homebrew Cask. Perubahan ini tidak menghapus atau membatasi fungsionalitas Azure CLI yang ada. Homebrew Cask sepenuhnya kompatibel dengan semua fitur dan versi Azure CLI saat ini.

Perubahan ini meningkatkan konsistensi di seluruh lingkungan dan memberikan dukungan yang lebih baik untuk skenario seperti penginstalan offline dan lingkungan penyebaran terkontrol.

Important

Azure CLI saat ini dalam fase pratinjau untuk model penginstalan Homebrew Cask. Selama fase ini, penginstalan hanya tersedia melalui fitur tap kustom di Homebrew.

• Metode saat ini: brew install azure-cli
• Metode baru (fase pratinjau):
  • Homebrew Cask melalui ketuk kustom
    1. brew tap azure/azure-cli
    2. brew install --cask azure-cli-preview
  • Penginstalan berbasis tarball

Pilih metode penginstalan

Gunakan panduan berikut untuk memilih metode penginstalan yang paling sesuai dengan skenario Anda:

Skenario	Metode yang direkomendasikan
Sebagian besar pengguna	Homebrew Cask
Sistem offline atau terisolasi	Tarball
Lokasi penginstalan kustom diperlukan	Tarball

Menginstal Azure CLI menggunakan Homebrew Cask

Homebrew memberikan pengalaman penginstalan yang paling sederhana dan paling dapat dipertahankan untuk Azure CLI di macOS. Ini menangani penginstalan, peningkatan, dan penghapusan menggunakan alur kerja manajemen paket standar.

Prerequisites

• macOS (Apple Silicon atau Intel)
• Homebrew terinstal

Jika Azure CLI sudah diinstal menggunakan rumus Homebrew, hapus instalannya sebelum melanjutkan untuk menghindari konflik:

brew uninstall azure-cli

Menginstal Azure CLI

Ini memasang Azure CLI menggunakan Homebrew Cask dari tap kustom Azure CLI. Ini adalah satu-satunya metode penginstalan Homebrew yang didukung selama fase pratinjau.

brew tap azure/azure-cli
brew install --cask azure-cli-preview

Verifikasi penginstalan

Setelah penginstalan, konfirmasikan Azure CLI tersedia:

az --version

Tingkatkan Azure CLI

Untuk meningkatkan ke versi terbaru:

brew update && brew upgrade --cask azure-cli-preview

Menghapus pemasangan Azure CLI

Untuk menghapus Azure CLI:

brew uninstall --cask azure-cli-preview
brew untap azure/azure-cli

Setelah fase pratinjau berakhir

Ketika instalasi Homebrew Cask menjadi tersedia secara umum:

• Metode instalasi pratinjau (azure-cli-preview melalui tap kustom) akan dihentikan.
• Azure CLI akan tersedia dari repositori Resmi Homebrew Cask.

Instal Azure CLI menggunakan:

brew install --cask azure-cli
# Or
brew install azure-cli

Penginstalan yang ada menggunakan rumus Homebrew Core harus bermigrasi ke penginstalan berbasis Cask. Rumus Homebrew Core tidak akan lagi didukung setelah transisi ini.

Menginstal Azure CLI menggunakan Tarball

Gunakan metode ini jika:

• Homebrew tidak tersedia
• Akses internet dibatasi
• Anda memerlukan kontrol penuh atas lokasi penginstalan

Metode ini umumnya digunakan dalam lingkungan perusahaan, teregulasi, atau terpisah secara fisik.

Prerequisites

• macOS (Apple Silicon atau Intel)
• Python 3.13 diinstal melalui metode apa pun (python.org, pyenv, dll.)

Unduh tarball

Di mesin dengan akses internet, Anda dapat mengunduh tarball Azure CLI terbaru secara otomatis untuk arsitektur Anda:

ARCH=$(uname -m)
VER=$(curl -s https://api.github.com/repos/Azure/azure-cli/releases/latest | grep tag_name | cut -d '"' -f4 | sed 's/azure-cli-//')
curl -L -o az.tar.gz "https://github.com/Azure/azure-cli/releases/download/azure-cli-$VER/azure-cli-$VER-macos-$ARCH.tar.gz"

Skrip ini mendeteksi arsitektur Anda dan mengunduh tarball Azure CLI terbaru dari halaman rilis Azure CLI.

• arm64 menunjukkan Apple Silicon
• x86_64 mengindikasikan Intel

Memilih arsitektur yang benar memastikan kompatibilitas dan performa optimal.

Tip

Untuk lingkungan offline, jalankan perintah ini pada komputer dengan akses internet, lalu transfer tarball yang diunduh ke sistem target.

Ekstrak ke direktori penginstalan

Pilih direktori tempat Azure CLI harus diinstal:

mkdir -p $HOME/lib/azure-cli
tar -xzf az.tar.gz -C $HOME/lib/azure-cli

Mengonfigurasi variabel lingkungan

Azure CLI memerlukan akses ke runtime Python. Konfigurasikan lingkungan Anda untuk menunjuk ke Python dan biner Azure CLI.

Tambahkan yang berikut ini ke profil shell Anda (~/.zshrc atau ~/.bashrc):

export AZ_PYTHON="/path_to_python"
export PATH="/target_directory_path/bin:$PATH"

Muat ulang konfigurasi shell Anda:

source ~/.zshrc

Verifikasi penginstalan

az --version

Tingkatkan Azure CLI

Untuk meningkatkan Azure CLI di lingkungan offline, unduh Tarball yang lebih baru dan ekstrak melalui penginstalan yang ada:

sudo tar -xzf az.tar.gz -C /target_directory_path

Menghapus pemasangan Azure CLI

Hapus direktori penginstalan:

sudo rm -rf /target_directory_path

Kemudian hapus AZ_PYTHON dan PATH entri dari profil shell Anda.

Troubleshooting

Jika Anda mengalami masalah saat menginstal atau menggunakan Azure CLI dengan Homebrew Cask atau metode Tarball, berikut adalah beberapa kesalahan umum (banyak di antaranya khusus untuk Homebrew). Jika Anda mengalami masalah yang tidak tercakup di sini, laporkan masalah di GitHub.

Azure CLI tidak ditemukan

Pastikan PATH Anda menyertakan direktori penginstalan:

echo $PATH

Penyelesaian tidak berfungsi

Penginstalan Azure CLI Homebrew (baik melalui rumus atau cask) menyediakan file penyelesaian bernama az di direktori penyelesaian terkelola Homebrew. Untuk memungkinkan penyelesaian, ikuti Instruksi Homebrew.

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 terinstal

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.13 dari Homebrew.

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

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.

Important

Jika Anda menggunakan proksi, HTTP_PROXY dan HTTPS_PROXY harus dikonfigurasi untuk terhubung 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

Langkah Selanjutnya

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

Mulai menggunakan Azure CLI