Alibaba Cloud CLI:Instalar, atualizar e desinstalar o Alibaba Cloud CLI

Usar um script Bash (recomendado)

O script detecta a arquitetura do seu sistema, baixa o pacote correto e coloca o binário aliyun em /usr/local/bin/.

• Instale a versão mais recente

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

• Instale uma versão específica

  Use a flag -V para especificar uma versão. Consulte as Releases no GitHub para ver as versões disponíveis.

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

Usar um pacote .tar.gz

1. Baixe o pacote correspondente à arquitetura do seu sistema.

   Nota

   Execute uname -m para verificar sua arquitetura. A saída arm64 ou aarch64 indica ARM64; qualquer outra saída indica x86_64.

   • x86_64 (64 bits):

     curl https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz -o aliyun-cli-linux-latest.tgz

   • ARM64:

     curl https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-arm64.tgz -o aliyun-cli-linux-latest.tgz

   • Para baixar uma versão específica, visite a página de Releases no GitHub. Os nomes dos pacotes seguem o formato aliyun-cli-linux-<version>-<arch>.tgz, onde <arch> é amd64 ou arm64.

2. Extraia o pacote.

   tar xzvf aliyun-cli-linux-latest.tgz

3. Mova o binário para um diretório presente no seu PATH.

   sudo mv ./aliyun /usr/local/bin/

Usar o Homebrew (recomendado)

brew install aliyun-cli

Usar o instalador do macOS (.pkg)

1. Baixe o instalador.

   • Versão mais recente: Baixe em https://aliyuncli.alicdn.com/aliyun-cli-latest.pkg.

   • Versão específica: Visite a página de Releases no GitHub. Os nomes dos instaladores seguem o formato aliyun-cli-<version>.pkg.

2. Clique duas vezes no arquivo .pkg baixado e siga as instruções na tela.

   Nota

   Se o macOS bloquear o instalador com um aviso de segurança, acesse System Settings > Privacy & Security e clique em Open Anyway para prosseguir.

Usar um script Bash

O script detecta o macOS e baixa o binário universal automaticamente. Os comandos são os mesmos usados no Linux.

• Instale a versão mais recente

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

• Instale uma versão específica

  Consulte as Releases no GitHub para ver as versões disponíveis.

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

Usar um pacote .tar.gz

1. Baixe o pacote.

   • Versão mais recente:

     curl https://aliyuncli.alicdn.com/aliyun-cli-macosx-latest-universal.tgz -o aliyun-cli-macosx-latest-universal.tgz

   • Versão específica: Visite a página de Releases no GitHub. Os nomes dos pacotes seguem o formato aliyun-cli-macosx-<version>-universal.tgz.

2. Extraia o pacote.

   tar xzvf aliyun-cli-macosx-latest-universal.tgz

3. Mova o binário para um diretório presente no seu PATH.

   sudo mv ./aliyun /usr/local/bin

Windows

Importante

O Alibaba Cloud CLI oferece suporte apenas a sistemas Windows x86_64 (64 bits). Não há suporte para sistemas de 32 bits e ARM64.

Use o pacote ZIP para uma instalação manual rápida ou use o script PowerShell para instalações automatizadas.

Usar um pacote ZIP

1. Baixe o pacote.

   • Versão mais recente: Baixe em https://aliyuncli.alicdn.com/aliyun-cli-windows-latest-amd64.zip.

   • Versão específica: Visite a página de Releases no GitHub. Os nomes dos pacotes seguem o formato aliyun-cli-windows-<version>-amd64.zip.

2. Extraia o aliyun.exe para um diretório de sua escolha. Por exemplo, C:\AliyunCLI.

   Nota

   O aliyun.exe é uma ferramenta de linha de comando. Clicar duas vezes nele não produz efeito. Execute-o a partir de um terminal (Prompt de Comando ou PowerShell).

3. Pressione Windows + S e pesquise por environment variables.

4. Clique em Edit the environment variables for your account.

5. Em User variables, selecione Path e clique em Edit.

   

6. Clique em New e insira o caminho do diretório (por exemplo, C:\AliyunCLI).

   

7. Clique em OK em cada caixa de diálogo para salvar.

8. Reinicie seu terminal para que a alteração tenha efeito.

Usar um script PowerShell

1. Crie um arquivo chamado Install-CLI-Windows.ps1 e cole o seguinte script nele.

   Script de exemplo

   # 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. Execute o script para instalar o Alibaba Cloud CLI.

   Nota

   O caminho do script de exemplo é C:\Example\Install-CLI-Windows.ps1. Substitua-o pelo caminho real do seu script.

   • Instale a versão mais recente. O caminho de instalação padrão é C:\Users\<*USERNAME**>*\AppData\Local\AliyunCLI.

     powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1

   • Especifique uma versão (nas Releases no GitHub) e o diretório de instalação.

     powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1 -Version 3.3.18 -InstallDir "C:\ExampleDir\AliyunCLI"

Verificar a instalação

Abra um novo terminal e execute:

aliyun version

Um número de versão como 3.3.18 confirma que a instalação foi bem-sucedida.

Para confirmar ainda mais que o CLI funciona corretamente:

aliyun configure list

Esse comando exibe seus perfis de credenciais, mesmo que a lista esteja vazia.

Se o comando retornar command not found, consulte a seção Solução de problemas.

Após a instalação, configure suas credenciais de acesso para começar a usar o Alibaba Cloud CLI:

• Início rápido: Configure as credenciais e execute seu primeiro comando.

• Configurar e gerenciar credenciais: Defina chaves de acesso, funções RAM ou outros tipos de identidade.

Atualizar o Alibaba Cloud CLI

Execute aliyun version para verificar sua versão atual e siga o caminho de atualização apropriado.

Determinar o método de instalação

Se você não tiver certeza de como o CLI foi instalado, localize o binário:

• Linux/macOS: Execute which aliyun.

  • O caminho contém /homebrew/ ou /linuxbrew/ → Homebrew.

  • O caminho é /usr/local/bin/aliyun → Script Bash ou pacote .tar.gz.

  • Outro caminho → Pacote .tar.gz em um diretório personalizado.

• Windows: Execute where aliyun.exe no Prompt de Comando.

  • O caminho é %LOCALAPPDATA%\AliyunCLI\aliyun.exe → Script PowerShell (caminho padrão).

  • Outro caminho → Pacote ZIP em um diretório personalizado.

Verificar sua versão

Execute aliyun version para checar sua versão atual e siga o caminho de atualização adequado:

• Versão 3.3.5 ou posterior: Use aliyun upgrade (recomendado) ou reinstale.

• Versão 3.3.0 a 3.3.4: Reinstale para atualizar. Ao atingir a versão 3.3.5 ou superior, use aliyun upgrade para atualizações futuras.

• Versão anterior à 3.3.0: Consulte o guia de migração para atualizar primeiro.

Usar aliyun upgrade (recomendado)

Disponível na versão 3.3.5 e posteriores. Este comando baixa e instala a versão mais recente.

• Atualize para a versão mais recente:

  aliyun upgrade

• Ignorar o prompt de confirmação:

  aliyun upgrade --yes

Nota

O comando aliyun upgrade não se aplica a instalações via Homebrew. Nesse caso, use brew upgrade aliyun-cli.

Atualizar via reinstalação

Escolha o método correspondente à sua instalação original:

• Script Bash (Linux/macOS): Execute novamente o script de instalação para atualizar para a versão mais recente.

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

• Homebrew (macOS):

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

• Instalador do macOS (.pkg) / Pacote ZIP (Windows):

  • Instalador do macOS (.pkg): Baixe o .pkg mais recente e execute-o. O novo binário substituirá a instalação anterior.

  • Pacote ZIP (Windows): Baixe o .zip mais recente, extraia o aliyun.exe e substitua o binário existente. Não é necessário alterar o PATH.

• Pacote .tar.gz (Linux/macOS): Baixe o pacote mais recente, extraia-o e mova o binário para o mesmo diretório da instalação original.

• Script PowerShell (Windows): Execute o script novamente com os mesmos parâmetros. Adicione -Version <version> para instalar uma versão específica.

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

  Nota

  Adicione -Version <version> para atualizar para uma versão específica. Omita esse parâmetro para instalar a versão mais recente. Consulte as Releases no GitHub para ver as versões disponíveis.

Observações

• Caso tenha usado um diretório de instalação personalizado, especifique o mesmo diretório durante a atualização.

• Se precisar mudar o método de instalação ou alterar o diretório, desinstale completamente antes de reinstalar.

Verificar a atualização

Confirme se a atualização foi bem-sucedida:

aliyun version

Desinstalar o Alibaba Cloud CLI

Linux

Usar a linha de comando

1. Localize e remova o binário:

   sudo rm -v "$(which aliyun)"

2. Se você instalou em um diretório personalizado e o adicionou ao PATH, remova essa entrada do arquivo de configuração do seu shell (~/.bashrc para Bash ou ~/.zshrc para Zsh) e recarregue:

   source ~/.bashrc

   Nota

   Substitua ~/.bashrc por ~/.zshrc se o seu shell padrão for o Zsh.

Usar um script Bash

1. Crie um arquivo de script e cole o seguinte conteúdo nele.

   Script de exemplo

   #!/usr/bin/env bash
   
   set -euo pipefail
   
   show_help() {
   cat << EOF
   
         Alibaba Cloud Command Line Interface Uninstaller
   
       -h          Display this help and exit
   
       -C          Remove user config file
   
   EOF
   }
   
   abort() {
     printf "%s\n" "$@" >&2
     exit 1
   }
   
   CLEAN_CONFIG=false
   
   while getopts ":hC" opt; do
     case "$opt" in
       "h")
         show_help
         exit 0
         ;;
       "C")
         CLEAN_CONFIG=true
         ;;
       *)
         echo "Unexpected flag not supported"
         exit 1
         ;;
     esac
   done
   
   echo -e "
   ..............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 ..............
   "
   
   USER_CONFIG_DIR="${HOME}/.aliyun"
   CONFIG_FILE_PATH="${USER_CONFIG_DIR}/config.json"
   
   remove_aliyun_binary() {
     local binary
     binary=$(which aliyun)
   
     if [ -n "$binary" ]; then
       rm -vf "$binary"
       rmdir --ignore-fail-on-non-empty "$(dirname "$binary")" 2>/dev/null || true
     fi
   }
   
   remove_user_config() {
     if $CLEAN_CONFIG; then
       rm -f "${CONFIG_FILE_PATH}" || abort "Failed to remove config file: ${CONFIG_FILE_PATH}"
   
       if [ -d "${USER_CONFIG_DIR}" ]; then
         rmdir --ignore-fail-on-non-empty "${USER_CONFIG_DIR}" 2>/dev/null || true
       fi
     fi
   }
   
   remove_aliyun_binary
   remove_user_config
   
   echo "Aliyun CLI has been uninstalled."

2. Execute o script:

   # 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

Usar o Homebrew

Desinstale o Alibaba Cloud CLI:

brew uninstall aliyun-cli

Usar a linha de comando

1. Remova o binário aliyun:

   BINARY=$(which aliyun 2>/dev/null) && [ -n "$BINARY" ] && sudo rm -v "$BINARY"

2. Se você instalou em um diretório personalizado e o adicionou ao PATH, remova essa entrada do ~/.zshrc (ou ~/.bashrc) e recarregue:

   source ~/.zshrc

   Nota

   Substitua ~/.zshrc por ~/.bashrc se você usar Bash.

Windows

Usar o Explorador de Arquivos

1. Acesse o diretório de instalação e exclua o aliyun.exe.

2. Pressione Windows + S e pesquise por environment variables.

3. Clique em Edit the environment variables for your account.

4. Em User variables, selecione Path e clique em Edit.

   

5. Selecione a entrada do diretório do Alibaba Cloud CLI e clique em Delete.

   

6. Clique em OK em cada caixa de diálogo para salvar.

Usar um script PowerShell

1. Crie um arquivo de script e cole o seguinte conteúdo nele.

   Script de exemplo

   # Uninstall-CLI-Windows.ps1
   # Purpose: Automatically detect and uninstall Aliyun CLI, and delete configuration files in user directory
   
   [CmdletBinding()]
   param (
       [switch]$Clean,
       [switch]$Help
   )
   
   function Show-Usage {
       Write-Output @"
   
         Alibaba Cloud Command Line Interface Uninstaller
   
       -Help                 Display this help and exit
   
       -Clean                Remove user config file
   
   "@
   }
   
   function Remove-DirectoryIfEmpty {
       param([string]$Path)
       if ((Get-ChildItem -Path $Path -Force).Count -eq 0) {
           Remove-Item -Path $Path -Force
       }
   }
   
   function Remove-AliyunCLIFromPath {
       param([string]$PathToRemove)
       $Key = 'HKCU:\Environment'
       $CurrentPath = (Get-ItemProperty -Path $Key -Name PATH).PATH
       if ($CurrentPath -like "*$PathToRemove*") {
           $newPath = ($CurrentPath -split ';' | Where-Object { $_ -ne $PathToRemove }) -join ';'
           Set-ItemProperty -Path $Key -Name PATH -Value $newPath
           $env:PATH = $newPath
       }
   }
   
   function Remove-AliyunCLI {
       $AliyunBinary = (Get-Command aliyun -ErrorAction SilentlyContinue).Source
       if ($AliyunBinary -and (Test-Path $AliyunBinary)) {
           Remove-Item -Path $AliyunBinary -Force
           $AliyunInstallDir = Split-Path -Parent $AliyunBinary
           Remove-DirectoryIfEmpty -Path $AliyunInstallDir
           Remove-AliyunCLIFromPath -PathToRemove $AliyunInstallDir
           Write-Output "Aliyun CLI binary has been removed."
       }
   }
   
   function Remove-ConfigFile {
       $ConfigDir = Join-Path $HOME ".aliyun"
       $ConfigFile = Join-Path $ConfigDir "config.json"
       if (Test-Path $ConfigFile) {
           Remove-Item -Path $ConfigFile -Force
           Remove-DirectoryIfEmpty -Path $ConfigDir
           Write-Output "Aliyun CLI config file has been removed."
       }
   }
   
   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 ..............
   "@
   
   try {
       Remove-AliyunCLI
       if ($PSBoundParameters['Clean']) { Remove-ConfigFile }
       Write-Output "Aliyun CLI has been uninstalled."
   } catch {
       Write-Output "Failed to uninstall Aliyun CLI: $_"
   }

2. Execute o script:

   # 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

Remover arquivos de configuração (opcional)

O Alibaba Cloud CLI armazena configurações no diretório .aliyun dentro do diretório home do usuário. Exclua-o para remover completamente todos os dados do CLI:

• Linux/macOS: ~/.aliyun

• Windows: C:\Users\<*USERNAME**>*\.aliyun

Solução de problemas

O comando aliyun retorna "command not found"

O binário aliyun não está no seu PATH ou não foi instalado corretamente.

• Linux/macOS: Execute which aliyun. Se um caminho for retornado, o binário existe, mas seu diretório não está no PATH. Se nenhum caminho for retornado, o binário não foi instalado. Tente instalar novamente usando um dos métodos da seção de Instalação.

• Windows: Execute where aliyun no Prompt de Comando. Se um caminho for retornado, o binário existe, mas seu diretório não está no PATH. Se nenhum caminho for retornado, o binário não foi instalado. Tente instalar novamente usando um dos métodos da seção de Instalação.

Se o binário for encontrado, adicione seu diretório ao PATH do seu shell:

• Bash: Adicione export PATH="$PATH:/your/install/dir" ao ~/.bashrc e execute source ~/.bashrc.

• Zsh: Adicione a mesma linha ao ~/.zshrc e execute source ~/.zshrc.

• Windows: Siga as etapas 3 a 8 na seção Windows > Usar um pacote ZIP para adicionar o diretório de instalação à variável de ambiente Path e reinicie o terminal.

aliyun version mostra uma versão diferente da esperada

Podem existir múltiplos binários aliyun no seu sistema. Execute which aliyun (Linux/macOS) ou where aliyun (Windows) para verificar qual binário seu shell está resolvendo. Se apontar para uma instalação antiga, exclua o binário antigo ou reordene os diretórios do seu PATH para que a nova instalação tenha prioridade. Reinicie o terminal e execute aliyun version novamente.

A instalação falha com "Permission denied"

Diretórios do sistema, como /usr/local/bin, exigem privilégios de administrador. No Linux e macOS, prefixe o comando com sudo (por exemplo, sudo mv ./aliyun /usr/local/bin/). No Windows, execute o PowerShell como administrador.

A instalação ou atualização via Homebrew atinge timeout no macOS

Isso geralmente ocorre devido ao acesso lento à CDN do GitHub. Configure um espelho doméstico do Homebrew, como o USTC, conforme descrito na seção de instalação do Homebrew. Para tornar as configurações do espelho persistentes, adicione as linhas export ao ~/.zshrc (ou ~/.bashrc) e execute source ~/.zshrc.

Clicar duas vezes no aliyun.exe no Windows não produz efeito

O Alibaba Cloud CLI é uma ferramenta de linha de comando sem interface gráfica. Abra o Prompt de Comando ou PowerShell, acesse o diretório que contém o aliyun.exe (ou certifique-se de que ele esteja no seu PATH) e execute os comandos a partir daí.