Topik ini menjelaskan cara menginstal, memverifikasi, memperbarui, dan menguninstal Alibaba Cloud CLI di Linux, macOS, dan Windows.
Informasi versi
Alibaba Cloud CLI merilis versi baru secara berkala. Untuk pengalaman terbaik, selalu gunakan versi terbaru. Jalankan aliyun version untuk memeriksa versi saat ini. Kunjungi halaman GitHub Releases untuk melihat versi terbaru dan catatan rilis.
Versi sebelum 3.3.0 telah mencapai akhir masa pakai (EOL) dan tidak lagi menerima pembaruan fitur atau perbaikan keamanan. Jika versi Anda di bawah 3.3.0, lihat panduan migrasi untuk melakukan peningkatan.
Prasyarat
Anda memiliki Akun Alibaba Cloud.
(Opsional) Alat baris perintah
curl. Sebagian besar distribusi macOS dan Linux sudah menyertakannya secara default. Anda dapat melewatkan prasyarat ini jika menginstal melalui manajer paket atau installer grafis.
Sistem operasi yang didukung
Sistem operasi | Versi yang didukung | Arsitektur yang didukung |
Linux | CentOS 8+, RHEL 8+, Ubuntu 16.04+, Debian 9+, dan distribusi utama lainnya. CentOS 7 telah mencapai EOL dan tidak disarankan. | x86_64 (64-bit), ARM64 |
macOS | macOS 11 (Big Sur) atau lebih baru | Intel dan Apple silicon (Universal binary) |
Windows | Windows 10 dan lebih baru (64-bit) | Hanya x86_64. Sistem 32-bit dan ARM64 tidak didukung. |
Instal Alibaba Cloud CLI
Pilih sistem operasi Anda, lalu pilih metode instalasi.
Linux
Gunakan skrip Bash untuk instalasi cepat dengan satu perintah, atau gunakan paket .tar.gz untuk lingkungan tanpa koneksi internet (air-gapped) atau jalur instalasi kustom.
Gunakan skrip Bash (disarankan)
Skrip ini mendeteksi arsitektur sistem Anda, mengunduh paket yang sesuai, dan menempatkan binari aliyun di /usr/local/bin/.
Instal versi terbaru
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"Instal versi tertentu
Gunakan flag
-Vuntuk menentukan versi. Periksa halaman GitHub Releases untuk daftar versi yang tersedia./bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)" -- -V 3.3.18
Gunakan paket .tar.gz
Unduh paket yang sesuai dengan arsitektur sistem Anda.
CatatanJalankan
uname -muntuk memeriksa arsitektur Anda. Outputarm64atauaarch64menunjukkan ARM64; output lainnya menunjukkan x86_64.x86_64 (64-bit):
curl https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz -o aliyun-cli-linux-latest.tgzARM64:
curl https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-arm64.tgz -o aliyun-cli-linux-latest.tgzUntuk mengunduh versi tertentu, kunjungi halaman GitHub Releases. Nama paket mengikuti format
aliyun-cli-linux-<version>-<arch>.tgz, dengan<arch>berupaamd64atauarm64.
Ekstrak paket tersebut.
tar xzvf aliyun-cli-linux-latest.tgzPindahkan binari ke direktori dalam PATH Anda.
sudo mv ./aliyun /usr/local/bin/
macOS
Gunakan Homebrew (disarankan)
Homebrew harus diinstal terlebih dahulu sebelum Anda melanjutkan.
Instal versi terbaru:
brew install aliyun-cliGunakan installer macOS (.pkg)
Unduh installer.
Versi terbaru: Unduh dari https://aliyuncli.alicdn.com/aliyun-cli-latest.pkg.
Versi tertentu: Kunjungi halaman GitHub Releases. Nama installer mengikuti format
aliyun-cli-<version>.pkg.
Klik ganda file
.pkgyang telah diunduh dan ikuti petunjuk di layar.CatatanJika macOS memblokir installer dengan peringatan keamanan, buka System Settings > Privacy & Security dan klik Open Anyway untuk melanjutkan.
Gunakan skrip Bash
Skrip ini mendeteksi macOS dan mengunduh binari universal secara otomatis. Perintahnya sama seperti pada Linux.
Instal versi terbaru
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"Instal versi tertentu
Periksa halaman GitHub Releases untuk daftar versi yang tersedia.
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)" -- -V 3.3.18
Gunakan paket .tar.gz
Unduh paket tersebut.
Versi terbaru:
curl https://aliyuncli.alicdn.com/aliyun-cli-macosx-latest-universal.tgz -o aliyun-cli-macosx-latest-universal.tgzVersi tertentu: Kunjungi halaman GitHub Releases. Nama paket mengikuti format
aliyun-cli-macosx-<version>-universal.tgz.
Ekstrak paket tersebut.
tar xzvf aliyun-cli-macosx-latest-universal.tgzPindahkan binari ke direktori dalam PATH Anda.
sudo mv ./aliyun /usr/local/bin
Windows
Alibaba Cloud CLI hanya mendukung sistem Windows x86_64 (64-bit). Sistem 32-bit dan ARM64 tidak didukung.
Gunakan paket ZIP untuk instalasi manual cepat, atau gunakan skrip PowerShell untuk instalasi otomatis.
Gunakan paket ZIP
Unduh paket tersebut.
Versi terbaru: Unduh dari https://aliyuncli.alicdn.com/aliyun-cli-windows-latest-amd64.zip.
Versi tertentu: Kunjungi halaman GitHub Releases. Nama paket mengikuti format
aliyun-cli-windows-<version>-amd64.zip.
Ekstrak
aliyun.exeke direktori pilihan Anda. Misalnya,C:\AliyunCLI.Catatanaliyun.exeadalah alat baris perintah. Mengklik ganda tidak akan memberikan efek apa pun. Jalankan dari terminal (Command Prompt atau PowerShell).Tekan Windows + S dan cari environment variables.
Klik Edit the environment variables for your account.
Di bawah User variables, pilih
Pathdan klik Edit.
Klik New dan masukkan jalur direktori (misalnya,
C:\AliyunCLI).
Klik OK di setiap dialog untuk menyimpan.
Restart terminal Anda agar perubahan diterapkan.
Gunakan skrip PowerShell
Buat file bernama
Install-CLI-Windows.ps1dan tempel skrip berikut ke dalamnya.Jalankan skrip untuk menginstal Alibaba Cloud CLI.
CatatanJalur contoh skrip adalah
C:\Example\Install-CLI-Windows.ps1. Ganti dengan jalur skrip aktual Anda.Instal versi terbaru. Jalur instalasi default adalah
C:\Users\<USERNAME>\AppData\Local\AliyunCLI.powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1Tentukan versi (dari GitHub Releases) dan direktori instalasi.
powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1 -Version 3.3.18 -InstallDir "C:\ExampleDir\AliyunCLI"
Verifikasi instalasi
Buka terminal baru dan jalankan:
aliyun versionNomor versi seperti 3.3.18 menunjukkan instalasi berhasil.
Untuk memverifikasi lebih lanjut bahwa CLI berfungsi dengan benar:
aliyun configure listIni menampilkan profil kredensial Anda, meskipun daftarnya kosong.
Jika perintah mengembalikan command not found, lihat Pemecahan Masalah.
Setelah instalasi, konfigurasikan kredensial akses Anda untuk mulai menggunakan Alibaba Cloud CLI:
Mulai cepat: Konfigurasikan kredensial dan jalankan perintah pertama Anda.
Konfigurasikan dan kelola kredensial: Siapkan access key, Peran RAM, atau jenis identitas lainnya.
Perbarui Alibaba Cloud CLI
Jalankan aliyun version untuk memeriksa versi saat ini, lalu ikuti jalur peningkatan yang sesuai.
Tentukan metode instalasi Anda
Jika Anda tidak yakin bagaimana CLI diinstal, temukan lokasi binari:
Linux/macOS: Jalankan
which aliyun.Jalur berisi
/homebrew/atau/linuxbrew/→ Homebrew.Jalur adalah
/usr/local/bin/aliyun→ Skrip Bash atau paket .tar.gz.Jalur lainnya → Paket .tar.gz ke direktori kustom.
Windows: Jalankan
where aliyun.exedi Command Prompt.Jalur adalah
%LOCALAPPDATA%\AliyunCLI\aliyun.exe→ Skrip PowerShell (jalur default).Jalur lainnya → Paket ZIP ke direktori kustom.
Periksa versi Anda
Jalankan aliyun version untuk memeriksa versi saat ini, lalu ikuti jalur peningkatan yang sesuai:
Versi 3.3.5 atau lebih baru: Gunakan
aliyun upgrade(disarankan) atau instal ulang.Versi 3.3.0 hingga 3.3.4: Instal ulang untuk memperbarui. Setelah mencapai 3.3.5+, gunakan
aliyun upgradeuntuk pembaruan mendatang.Versi sebelum 3.3.0: Lihat panduan migrasi untuk melakukan peningkatan terlebih dahulu.
Gunakan aliyun upgrade (disarankan)
Tersedia di versi 3.3.5 dan lebih baru. Perintah ini mengunduh dan menginstal versi terbaru.
Perbarui ke versi terbaru:
aliyun upgradeUntuk melewati prompt konfirmasi:
aliyun upgrade --yes
aliyun upgrade tidak berlaku untuk instalasi Homebrew. Gunakan brew upgrade aliyun-cli sebagai gantinya.
Perbarui dengan menginstal ulang
Pilih metode yang sesuai dengan instalasi awal Anda:
Skrip Bash (Linux/macOS): Jalankan ulang skrip instalasi untuk memperbarui ke versi terbaru.
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"Homebrew (macOS):
brew update && brew upgrade aliyun-cli && brew cleanup aliyun-cliInstaller macOS (.pkg) / Paket ZIP (Windows):
Installer macOS (.pkg): Unduh .pkg terbaru dan jalankan. Binari baru akan menimpa instalasi sebelumnya.
Paket ZIP (Windows): Unduh .zip terbaru, ekstrak
aliyun.exe, dan ganti binari yang ada. Tidak perlu mengubah PATH.
Paket .tar.gz (Linux/macOS): Unduh paket terbaru, ekstrak, dan pindahkan binari ke direktori yang sama dengan instalasi awal Anda.
Skrip PowerShell (Windows): Jalankan ulang skrip dengan parameter yang sama. Tambahkan
-Version <version>untuk menginstal versi tertentu.powershell.exe -ExecutionPolicy Bypass -File <script_path> [-InstallDir <install_path>]CatatanTambahkan
-Version <version>untuk memperbarui ke versi tertentu. Abaikan untuk menginstal rilis terbaru. Periksa GitHub Releases untuk daftar versi yang tersedia.
Catatan
Jika Anda menggunakan direktori instalasi kustom, tentukan direktori yang sama saat memperbarui.
Jika Anda perlu mengganti metode instalasi atau mengubah direktori instalasi, lakukan uninstall lengkap terlebih dahulu, lalu instal ulang.
Verifikasi pembaruan
Konfirmasi bahwa pembaruan berhasil:
aliyun versionUninstal Alibaba Cloud CLI
Linux
Gunakan baris perintah
Temukan dan hapus binari:
sudo rm -v "$(which aliyun)"Jika Anda menginstal ke direktori kustom dan menambahkannya ke PATH, hapus entri tersebut dari file konfigurasi shell Anda (
~/.bashrcuntuk Bash atau~/.zshrcuntuk Zsh) dan muat ulang:source ~/.bashrcCatatanGanti
~/.bashrcdengan~/.zshrcjika shell default Anda adalah Zsh.
Gunakan skrip Bash
Buat file skrip dan tempel konten berikut ke dalamnya.
Jalankan skrip:
# Uninstall only the executable file bash <script_path> # Uninstall the executable file and delete the configuration file bash <script_path> -C # View script help bash <script_path> -h
macOS
Gunakan Homebrew
Uninstal Alibaba Cloud CLI:
brew uninstall aliyun-cliGunakan baris perintah
Hapus binari
aliyun:BINARY=$(which aliyun 2>/dev/null) && [ -n "$BINARY" ] && sudo rm -v "$BINARY"Jika Anda menginstal ke direktori kustom dan menambahkannya ke PATH, hapus entri tersebut dari
~/.zshrc(atau~/.bashrc) dan muat ulang:source ~/.zshrcCatatanGanti
~/.zshrcdengan~/.bashrcjika Anda menggunakan Bash.
Windows
Gunakan File Explorer
Buka direktori instalasi dan hapus
aliyun.exe.Tekan Windows + S dan cari environment variables.
Klik Edit the environment variables for your account.
Di bawah User variables, pilih
Pathdan klik Edit.
Pilih entri direktori Alibaba Cloud CLI dan klik Delete.

Klik OK di setiap dialog untuk menyimpan.
Gunakan skrip PowerShell
Buat file skrip dan tempel konten berikut ke dalamnya.
Jalankan skrip:
# Uninstall only the executable file powershell.exe -ExecutionPolicy Bypass -File <script_path> # Uninstall the executable file and delete the configuration file powershell.exe -ExecutionPolicy Bypass -File <script_path> -Clean # View script help powershell.exe -ExecutionPolicy Bypass -File <script_path> -Help
Hapus file konfigurasi (opsional)
Alibaba Cloud CLI menyimpan konfigurasi di direktori .aliyun di bawah direktori home pengguna Anda. Hapus direktori ini untuk menghapus semua data CLI secara lengkap:
Linux/macOS:
~/.aliyunWindows:
C:\Users\<USERNAME>\.aliyun
Pemecahan Masalah
Perintah aliyun mengembalikan "command not found"
Binari aliyun tidak berada dalam PATH Anda atau tidak diinstal dengan benar.
Linux/macOS: Jalankan
which aliyun. Jika jalur dikembalikan, binari tersebut ada tetapi direktorinya tidak dalamPATH. Jika tidak ada jalur yang dikembalikan, binari tidak diinstal. Ulangi instalasi menggunakan salah satu metode di bagian Instal.Windows: Jalankan
where aliyundi Command Prompt. Jika jalur dikembalikan, binari tersebut ada tetapi direktorinya tidak dalamPATH. Jika tidak ada jalur yang dikembalikan, binari tidak diinstal. Ulangi instalasi menggunakan salah satu metode di bagian Instal.
Jika binari ditemukan, tambahkan direktorinya ke PATH untuk shell Anda:
Bash: Tambahkan
export PATH="$PATH:/your/install/dir"ke~/.bashrc, lalu jalankansource ~/.bashrc.Zsh: Tambahkan baris yang sama ke
~/.zshrc, lalu jalankansource ~/.zshrc.Windows: Ikuti langkah 3–8 di bagian instalasi Windows > Gunakan paket ZIP untuk menambahkan direktori instalasi ke variabel lingkungan
Path, lalu restart terminal Anda.
aliyun version menampilkan versi yang berbeda dari yang diharapkan
Beberapa binari aliyun mungkin ada di sistem Anda. Jalankan which aliyun (Linux/macOS) atau where aliyun (Windows) untuk memeriksa binari mana yang diselesaikan oleh shell Anda. Jika mengarah ke instalasi lama, hapus binari lama tersebut atau atur ulang urutan direktori PATH agar instalasi baru memiliki prioritas lebih tinggi. Restart terminal Anda dan jalankan aliyun version lagi.
Instalasi gagal dengan "Permission denied"
Direktori sistem seperti /usr/local/bin memerlukan hak istimewa administrator. Di Linux dan macOS, tambahkan awalan perintah dengan sudo (misalnya, sudo mv ./aliyun /usr/local/bin/). Di Windows, jalankan PowerShell sebagai administrator.
Instalasi atau pembaruan Homebrew timeout di macOS
Hal ini biasanya terjadi karena akses jaringan yang lambat ke CDN GitHub. Konfigurasikan mirror Homebrew domestik seperti USTC, seperti yang dijelaskan di bagian instalasi Homebrew. Untuk menyimpan pengaturan mirror secara permanen, tambahkan baris export ke ~/.zshrc (atau ~/.bashrc) dan jalankan source ~/.zshrc.
Mengklik ganda aliyun.exe di Windows tidak memberikan efek apa pun
Alibaba Cloud CLI adalah alat baris perintah tanpa antarmuka grafis. Buka Command Prompt atau PowerShell, navigasi ke direktori yang berisi aliyun.exe (atau pastikan berada dalam PATH Anda), lalu jalankan perintah dari sana.