全部产品
Search
文档中心

Alibaba Cloud CLI:Perbarui Alibaba Cloud CLI

更新时间:Jan 28, 2026

Topik ini menjelaskan cara memperbarui Alibaba Cloud CLI serta menyediakan catatan penting terkait proses tersebut.

Perhatian

  • Untuk menghindari konflik versi dan potensi masalah kompatibilitas, selalu gunakan metode pembaruan yang sama dengan metode instalasi awal. Contohnya:

    • Jika Anda menginstal Alibaba Cloud CLI menggunakan Homebrew, teruslah menggunakan Homebrew untuk pembaruan. Jangan gunakan paket instalasi atau skrip untuk memperbaruinya.

    • Jika Anda menginstal Alibaba Cloud CLI di direktori kustom pada Linux atau macOS, kami menyarankan agar Anda memperbaruinya secara manual menggunakan file TGZ untuk memastikan penggantian file yang tepat.

  • Jika Anda menggunakan path kustom untuk menginstal Alibaba Cloud CLI, tentukan path yang sama saat memperbarui guna menjaga konsistensi.

  • Jika Anda mengalami salah satu situasi berikut, uninstall the CLI sepenuhnya lalu lakukan instalasi ulang:

    • Anda tidak yakin dengan metode atau direktori instalasi awal.

    • Anda perlu beralih ke metode instalasi yang tidak kompatibel, misalnya dari instalasi berbasis skrip ke Homebrew.

    • Anda perlu mengubah direktori instalasi.

Prosedur

Catatan

Pada langkah-langkah berikut, <script_path> dan <install_path> merupakan placeholder. Gantilah dengan path file skrip dan direktori instalasi Alibaba Cloud CLI yang sebenarnya sebelum menjalankan perintah.

Linux

Perbarui menggunakan skrip Bash

Jalankan perintah berikut untuk menginstal versi terbaru Alibaba Cloud CLI.

/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"

Perbarui menggunakan file TGZ

  1. Unduh paket instalasi yang sesuai dengan arsitektur sistem Anda.

    Catatan

    Jalankan perintah uname -m untuk memeriksa arsitektur sistem Linux Anda. Jika output-nya arm64 atau aarch64, arsitektur sistem Anda adalah ARM64. Jika tidak, arsitekturnya AMD64.

    • Jalankan perintah berikut untuk mengunduh paket instalasi terbaru untuk sistem Linux AMD64.

      curl https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz -o aliyun-cli-linux-latest.tgz
    • Jalankan perintah berikut untuk mengunduh paket instalasi terbaru untuk sistem Linux ARM64.

      curl https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-arm64.tgz -o aliyun-cli-linux-latest.tgz
  2. Ekstrak paket instalasi ke direktori instalasi untuk menimpa file lama.

    tar xzvf aliyun-cli-latest.tgz -C <install_path>

macOS

Perbarui menggunakan file PKG

  1. Unduh file PKG terbaru untuk macOS dari tautan berikut: <a class="xref" href="https://aliyuncli.alicdn.com/aliyun-cli-latest.pkg" id="a-39j-7g6-ic9" title="">https://aliyuncli.alicdn.com/aliyun-cli-latest.pkg</a>.

  2. Klik ganda paket yang telah diunduh dan ikuti petunjuk di layar untuk menyelesaikan pembaruan.

Perbarui menggunakan Homebrew

Jalankan perintah berikut untuk memperbarui Alibaba Cloud CLI menggunakan Homebrew.

brew update && brew upgrade aliyun-cli && brew cleanup aliyun-cli

Perbarui menggunakan skrip Bash

Jalankan perintah berikut untuk menginstal versi terbaru Alibaba Cloud CLI.

/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"

Perbarui menggunakan paket TGZ

  1. Jalankan perintah berikut untuk mengunduh paket instalasi terbaru untuk sistem macOS.

    curl https://aliyuncli.alicdn.com/aliyun-cli-macosx-latest-universal.tgz -o aliyun-cli-macosx-latest-universal.tgz
  2. Ekstrak paket instalasi ke direktori instalasi untuk menimpa file lama.

    tar xzvf aliyun-cli-macosx-latest-universal.tgz -C <install_path>

Windows

Perbarui menggunakan paket ZIP

  1. Unduh paket terbaru untuk Windows dari tautan berikut: <a data-link-href-cangjie="https://aliyuncli.alicdn.com/aliyun-cli-windows-latest-amd64.zip" href="https://aliyuncli.alicdn.com/aliyun-cli-windows-latest-amd64.zip" id="xref_0dj_47w_qkg" rel="noopener noreferrer" target="_blank">https://aliyuncli.alicdn.com/aliyun-cli-windows-latest-amd64.zip</a>.

  2. Ekstrak file yang dapat dieksekusi aliyun.exe dalam paket instalasi ke direktori instalasi Alibaba Cloud CLI, timpa file yang ada untuk menyelesaikan pembaruan.

    Catatan

    File ini harus dijalankan dari CLI. File ini tidak akan berfungsi jika diklik ganda.

Perbarui menggunakan skrip PowerShell

  1. Buat file skrip bernama Install-CLI-Windows.ps1 dan simpan kode berikut ke dalam file tersebut. Jika Anda sudah memiliki skrip ini, lewati langkah ini.

    Contoh skrip

    # Install-CLI-Windows.ps1
    # Purpose: Install Alibaba Cloud CLI on Windows AMD64 systems.
    # Supports custom version and install directory. Only modifies User-level and Process-level PATH.
    
    [CmdletBinding()]
    param (
        [string]$Version = "latest",
        [string]$InstallDir = "$env:LOCALAPPDATA",
        [switch]$Help
    )
    
    function Show-Usage {
        Write-Output @"
    
          Alibaba Cloud Command Line Interface Installer
    
        -Help                 Display this help and exit
    
        -Version VERSION      Custom CLI version. Default is 'latest'
    
        -InstallDir PATH      Custom installation directory. Default is:
                              $InstallDir\AliyunCLI
    
    "@
    }
    
    function Write-ErrorExit {
        param([string]$Message)
        Write-Error $Message
        exit 1
    }
    
    if ($PSBoundParameters['Help']) {
        Show-Usage
        exit 0
    }
    
    Write-Output @"
    ..............888888888888888888888 ........=8888888888888888888D=..............
    ...........88888888888888888888888 ..........D8888888888888888888888I...........
    .........,8888888888888ZI: ...........................=Z88D8888888888D..........
    .........+88888888 ..........................................88888888D..........
    .........+88888888 .......Welcome to use Alibaba Cloud.......O8888888D..........
    .........+88888888 ............. ************* ..............O8888888D..........
    .........+88888888 .... Command Line Interface(Reloaded) ....O8888888D..........
    .........+88888888...........................................88888888D..........
    ..........D888888888888DO+. ..........................?ND888888888888D..........
    ...........O8888888888888888888888...........D8888888888888888888888=...........
    ............ .:D8888888888888888888.........78888888888888888888O ..............
    "@
    
    $OSArchitecture = (Get-WmiObject -Class Win32_OperatingSystem).OSArchitecture
    
    $ProcessorArchitecture = [int](Get-WmiObject -Class Win32_Processor).Architecture
    
    if (-not ($OSArchitecture -match "64") -or $ProcessorArchitecture -ne 9) {
        Write-ErrorExit "Alibaba Cloud CLI only supports Windows AMD64 systems. Please run on a compatible system."
    }
    
    $DownloadUrl = "https://aliyuncli.alicdn.com/aliyun-cli-windows-$Version-amd64.zip"
    
    $tempPath = $env:TEMP
    $randomName = -join ((65..90) + (97..122) + (48..57) | Get-Random -Count 8)
    $DownloadDir = Join-Path -Path $tempPath -ChildPath $randomName
    New-Item -ItemType Directory -Path $DownloadDir | Out-Null
    
    try {
        $InstallDir = Join-Path $InstallDir "AliyunCLI"
        if (-not (Test-Path $InstallDir)) {
            New-Item -ItemType Directory -Path $InstallDir -Force | Out-Null
        }
    
        $ZipPath = Join-Path $DownloadDir "aliyun-cli.zip"
        Start-BitsTransfer -Source $DownloadUrl -Destination $ZipPath
    
        Expand-Archive -Path $ZipPath -DestinationPath $DownloadDir -Force
    
        Move-Item -Path "$DownloadDir\aliyun.exe" -Destination "$InstallDir\" -Force
    
        $Key = 'HKCU:\Environment'
        $CurrentPath = (Get-ItemProperty -Path $Key -Name PATH).PATH
    
        if ([string]::IsNullOrEmpty($CurrentPath)) {
            $NewPath = $InstallDir
        } else {
            if ($CurrentPath -notlike "*$InstallDir*") {
                $NewPath = "$CurrentPath;$InstallDir"
            } else {
                $NewPath = $CurrentPath
            }
        }
    
        if ($NewPath -ne $CurrentPath) {
            Set-ItemProperty -Path $Key -Name PATH -Value $NewPath
            $env:PATH += ";$InstallDir"
        }
    } catch {
        Write-ErrorExit "Failed to install Alibaba Cloud CLI: $_"
    } finally {
        Remove-Item -Path $DownloadDir -Recurse -Force | Out-Null
    }
  2. Jalankan perintah berikut untuk menjalankan file skrip guna memperbarui Alibaba Cloud CLI.

    powershell.exe -ExecutionPolicy Bypass -File <script_path> [-InstallDir <install_path>]