Cette rubrique explique comment installer, vérifier, mettre à jour et désinstaller Alibaba Cloud CLI sous Linux, macOS et Windows.
Informations sur la version
Alibaba Cloud CLI publie régulièrement de nouvelles versions. Nous vous recommandons d'utiliser toujours la dernière version pour bénéficier de la meilleure expérience. Exécutez aliyun version pour consulter votre version actuelle. Consultez la page des GitHub Releases pour obtenir la dernière version ainsi que les notes de publication.
Les versions antérieures à la 3.3.0 ont atteint leur fin de vie (EOL) et ne reçoivent plus de mises à jour fonctionnelles ni de correctifs de sécurité. Si votre version est inférieure à la 3.3.0, consultez le guide de migration pour effectuer la mise à niveau.
Prérequis
Vous disposez d'un compte Alibaba Cloud.
(Facultatif) L'outil de ligne de commande
curl. La plupart des distributions Linux et macOS l'incluent par défaut. Vous pouvez ignorer cette exigence si vous effectuez l'installation via un gestionnaire de paquets ou un installateur graphique.
Systèmes d'exploitation pris en charge
|**Système d'exploitation**
|
**Versions prises en charge**
|
**Architectures prises en charge**
| | --- | --- | --- | |
Linux
|
CentOS 8+, RHEL 8+, Ubuntu 16.04+, Debian 9+ et autres distributions majeures. CentOS 7 a atteint sa fin de vie et n'est pas recommandé.
|
x86_64 (64 bits), ARM64
| |
macOS
|
macOS 11 (Big Sur) ou version ultérieure
|
Intel et puces Apple (binaire universel)
| |
Windows
|
Windows 10 et versions ultérieures (64 bits)
|
x86_64 uniquement. Les architectures 32 bits et ARM64 ne sont pas prises en charge.
|
Installer Alibaba Cloud CLI
Sélectionnez votre système d'exploitation, puis choisissez une méthode d'installation.
Linux
Utilisez le script Bash pour une installation rapide en une seule commande, ou optez pour le package .tar.gz pour les environnements isolés du réseau ou pour définir des chemins d'installation personnalisés.
Utiliser un script Bash (recommandé)
Le script détecte l'architecture de votre système, télécharge le package approprié et place le binaire aliyun dans le répertoire /usr/local/bin/.
-
Installer la dernière version
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)" -
Installer une version spécifique
Utilisez l'indicateur
-Vpour spécifier une version. Consultez les GitHub Releases pour connaître les versions disponibles./bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)" -- -V 3.3.18
Utiliser un package .tar.gz
-
Téléchargez le package correspondant à l'architecture de votre système.
RemarqueExécutez
uname -mpour vérifier votre architecture. Une sortiearm64ouaarch64indique une architecture ARM64 ; toute autre sortie indique 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 Pour télécharger une version spécifique, rendez-vous sur la page des GitHub Releases . Les noms de packages suivent le format
aliyun-cli-linux-<version>-<arch>.tgz, où<arch>correspond àamd64ouarm64.
-
-
Extrayez le package.
tar xzvf aliyun-cli-linux-latest.tgz -
Déplacez le binaire vers un répertoire inclus dans votre PATH.
sudo mv ./aliyun /usr/local/bin/
macOS
Utiliser Homebrew (recommandé)
Homebrew doit être installé avant de poursuivre.
Installez la dernière version :
brew install aliyun-cli
Utiliser l'installateur macOS (.pkg)
-
Téléchargez l'installateur.
Dernière version : téléchargez depuis https://aliyuncli.alicdn.com/aliyun-cli-latest.pkg.
Version spécifique : rendez-vous sur la page des GitHub Releases . Les noms des installateurs suivent le format
aliyun-cli-<version>.pkg.
-
Double-cliquez sur le fichier
.pkgtéléchargé et suivez les instructions à l'écran.RemarqueSi macOS bloque l'installateur avec un avertissement de sécurité, ouvrez System Settings > Privacy & Security , puis cliquez sur Open Anyway pour continuer.
Utiliser un script Bash
Le script détecte macOS et télécharge automatiquement le binaire universel. Les commandes sont identiques à celles utilisées sous Linux.
-
Installer la dernière version
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)" -
Installer une version spécifique
Consultez les GitHub Releases pour connaître les versions disponibles.
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)" -- -V 3.3.18
Utiliser un package .tar.gz
-
Téléchargez le package.
-
Dernière version :
curl https://aliyuncli.alicdn.com/aliyun-cli-macosx-latest-universal.tgz -o aliyun-cli-macosx-latest-universal.tgz Version spécifique : rendez-vous sur la page des GitHub Releases . Les noms de packages suivent le format
aliyun-cli-macosx-<version>-universal.tgz.
-
-
Extrayez le package.
tar xzvf aliyun-cli-macosx-latest-universal.tgz -
Déplacez le binaire vers un répertoire inclus dans votre PATH.
sudo mv ./aliyun /usr/local/bin
Windows
Alibaba Cloud CLI prend uniquement en charge les systèmes Windows x86_64 (64 bits). Les systèmes 32 bits et ARM64 ne sont pas pris en charge.
Utilisez le package ZIP pour une installation manuelle rapide, ou optez pour le script PowerShell pour des installations automatisées.
Utiliser un package ZIP
-
Téléchargez le package.
Dernière version : téléchargez depuis https://aliyuncli.alicdn.com/aliyun-cli-windows-latest-amd64.zip.
Version spécifique : rendez-vous sur la page des GitHub Releases . Les noms de packages suivent le format
aliyun-cli-windows-<version>-amd64.zip.
-
Extrayez
aliyun.exevers le répertoire de votre choix. Par exemple,C:\AliyunCLI.Remarquealiyun.exeest un outil de ligne de commande. Un double-clic dessus n'a aucun effet. Exécutez-le depuis un terminal (Invite de commandes ou PowerShell). Appuyez sur Windows + S et recherchez environment variables .
Cliquez sur Edit the environment variables for your account .
-
Sous User variables , sélectionnez
Path, puis cliquez sur Edit .
-
Cliquez sur New et saisissez le chemin du répertoire (par exemple,
C:\AliyunCLI).
Cliquez sur OK dans chaque boîte de dialogue pour enregistrer les modifications.
Redémarrez votre terminal pour que les modifications prennent effet.
Utiliser un script PowerShell
-
Créez un fichier nommé
Install-CLI-Windows.ps1et collez-y le script suivant. -
Exécutez le script pour installer Alibaba Cloud CLI.
RemarqueLe chemin d'exemple du script est
C:\Example\Install-CLI-Windows.ps1. Remplacez-le par le chemin réel de votre script.-
Installez la dernière version. Le chemin d'installation par défaut est C:\Users\<*USERNAME**>*\AppData\Local\AliyunCLI.
powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1 -
Spécifiez une version (disponible sur les GitHub Releases ) et un répertoire d'installation.
powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1 -Version 3.3.18 -InstallDir "C:\ExampleDir\AliyunCLI"
-
Vérifier l'installation
Ouvrez un nouveau terminal et exécutez :
aliyun version
Un numéro de version tel que 3.3.18 confirme que l'installation a réussi.
Pour vérifier plus en détail que la CLI fonctionne correctement :
aliyun configure list
Cette commande affiche vos profils d'identifiants, même si la liste est vide.
Si la commande renvoie command not found, consultez la section Dépannage.
Après l'installation, configurez vos identifiants d'accès pour commencer à utiliser Alibaba Cloud CLI :
Démarrage rapide : configurez les identifiants et exécutez votre première commande.
Configurer et gérer les identifiants : configurez des clés d'accès, des rôles RAM ou d'autres types d'identité.
Mettre à jour Alibaba Cloud CLI
Exécutez aliyun version pour vérifier votre version actuelle, puis suivez la procédure de mise à niveau appropriée.
Déterminer votre méthode d'installation
Si vous ne savez pas comment la CLI a été installée, localisez le binaire :
-
Linux/macOS : Exécutez
which aliyun.Le chemin contient
/homebrew/ou/linuxbrew/→ Homebrew.Le chemin est
/usr/local/bin/aliyun→ script Bash ou package .tar.gz.Autre chemin → package .tar.gz vers un répertoire personnalisé.
-
Windows : Exécutez
where aliyun.exedans l'invite de commandes.Le chemin est
%LOCALAPPDATA%\AliyunCLI\aliyun.exe→ script PowerShell (chemin par défaut).Autre chemin → package ZIP vers un répertoire personnalisé.
Vérifier votre version
Exécutez aliyun version pour vérifier votre version actuelle, puis suivez la procédure de mise à niveau appropriée :
Version 3.3.5 ou ultérieure : Utilisez
aliyun upgrade(recommandé) ou réinstallez.Version 3.3.0 à 3.3.4 : Réinstallez pour effectuer la mise à jour. Une fois la version 3.3.5 ou ultérieure atteinte, utilisez
aliyun upgradepour les futures mises à jour.Version antérieure à 3.3.0 : Consultez le guide de migration pour effectuer la mise à niveau initiale.
Utiliser aliyun upgrade (recommandé)
Disponible à partir de la version 3.3.5. Cette commande télécharge et installe la dernière version.
-
Mettre à jour vers la dernière version :
aliyun upgrade -
Pour ignorer la demande de confirmation :
aliyun upgrade --yes
aliyun upgrade ne s'applique pas aux installations effectuées via Homebrew. Utilisez plutôt brew upgrade aliyun-cli.
Mettre à jour par réinstallation
Choisissez la méthode correspondant à votre installation d'origine :
-
Script Bash (Linux/macOS) : Réexécutez le script d'installation pour passer à la dernière version.
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)" -
Homebrew (macOS) :
brew update && brew upgrade aliyun-cli && brew cleanup aliyun-cli -
Programme d'installation macOS (.pkg) / package ZIP (Windows) :
Programme d'installation macOS (.pkg) : Téléchargez le dernier fichier .pkg et exécutez-le. Le nouveau binaire écrase l'installation précédente.
Package ZIP (Windows) : Téléchargez le dernier fichier .zip, extrayez
aliyun.exeet remplacez le binaire existant. Aucune modification du PATH n'est nécessaire.
Package .tar.gz (Linux/macOS) : Téléchargez le dernier package, extrayez-le et déplacez le binaire vers le même répertoire que votre installation d'origine.
-
Script PowerShell (Windows) : Réexécutez le script avec les mêmes paramètres. Ajoutez
-Version <version>pour installer une version spécifique.powershell.exe -ExecutionPolicy Bypass -File <script_path> [-InstallDir <install_path>]RemarqueAjoutez
-Version <version>pour mettre à jour vers une version spécifique. Omettez ce paramètre pour installer la dernière version publiée. Consultez les Versions GitHub pour voir les versions disponibles.
Remarques
Si vous avez utilisé un répertoire d'installation personnalisé, spécifiez le même répertoire lors de la mise à jour.
Si vous devez changer de méthode d'installation ou modifier le répertoire d'installation, désinstallez complètement d'abord, puis réinstallez.
Vérifier la mise à jour
Confirmez que la mise à jour a réussi :
aliyun version
Désinstaller Alibaba Cloud CLI
Linux
Utiliser la ligne de commande
-
Localisez et supprimez le binaire :
sudo rm -v "$(which aliyun)" -
Si vous avez installé dans un répertoire personnalisé et l'avez ajouté au PATH, supprimez cette entrée de votre fichier de configuration shell (
~/.bashrcpour Bash ou~/.zshrcpour Zsh) et rechargez :source ~/.bashrcRemarqueRemplacez
~/.bashrcpar~/.zshrcsi votre shell par défaut est Zsh.
Utiliser un script Bash
-
Créez un fichier de script et collez-y le contenu suivant.
-
Exécutez le 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
Utiliser Homebrew
Désinstallez Alibaba Cloud CLI :
brew uninstall aliyun-cli
Utiliser la ligne de commande
-
Supprimez le binaire
aliyun:BINARY=$(which aliyun 2>/dev/null) && [ -n "$BINARY" ] && sudo rm -v "$BINARY" -
Si vous avez installé dans un répertoire personnalisé et l'avez ajouté au PATH, supprimez cette entrée de
~/.zshrc(ou~/.bashrc) et rechargez :source ~/.zshrcRemarqueRemplacez
~/.zshrcpar~/.bashrcsi vous utilisez Bash.
Windows
Utiliser l'Explorateur de fichiers
Accédez au répertoire d'installation et supprimez
aliyun.exe.Appuyez sur Windows + S et recherchez environment variables.
Cliquez sur Edit the environment variables for your account.
-
Sous User variables, sélectionnez
Pathet cliquez sur Edit.
-
Sélectionnez l'entrée du répertoire Alibaba Cloud CLI et cliquez sur Delete.

Cliquez sur OK dans chaque boîte de dialogue pour enregistrer.
Utiliser un script PowerShell
-
Créez un fichier de script et collez-y le contenu suivant.
-
Exécutez le 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
Supprimer les fichiers de configuration (facultatif)
Alibaba Cloud CLI stocke la configuration dans le répertoire .aliyun situé sous le répertoire personnel de l'utilisateur. Supprimez-le pour retirer entièrement toutes les données de la CLI :
Linux/macOS :
~/.aliyunWindows : C:\Users\<*NOMUTILISATEUR**>*\.aliyun
Dépannage
La commande aliyun renvoie « command not found »
Le binaire aliyun ne figure pas dans votre PATH ou n'a pas été installé correctement.
Linux/macOS : Exécutez
which aliyun. Si un chemin est renvoyé, le binaire existe mais son répertoire n'est pas inclus dans la variablePATH. En l'absence de résultat, le binaire n'a pas été installé. Relancez l'installation en suivant l'une des méthodes présentées dans la section Installation.Windows : Exécutez
where aliyundans l'invite de commandes. Si un chemin s'affiche, le binaire est présent mais son dossier ne figure pas dans la variablePATH. Sans résultat, l'installation a échoué. Recommencez la procédure via l'une des options décrites dans la section Installation.
Si le binaire est localisé, ajoutez son répertoire à la variable PATH de votre shell :
Bash : Ajoutez la ligne
export PATH="$PATH:/your/install/dir"au fichier~/.bashrc, puis exécutezsource ~/.bashrc.Zsh : Insérez la même instruction dans
~/.zshrc, ensuite lancezsource ~/.zshrc.Windows : Suivez les étapes 3 à 8 de la section Windows > Utilisation d'un package ZIP afin d'intégrer le dossier d'installation à la variable d'environnement
Path, puis redémarrez votre terminal.
La version affichée par aliyun diffère de celle attendue
Plusieurs binaires aliyun peuvent coexister sur votre système. Exécutez which aliyun (Linux/macOS) ou where aliyun (Windows) pour identifier le binaire résolu par votre shell. S'il pointe vers une ancienne installation, supprimez l'ancien binaire ou réorganisez les répertoires de votre variable PATH afin que la nouvelle installation soit prioritaire. Redémarrez le terminal et relancez aliyun version.
L'installation échoue avec l'erreur « Permission denied »
Les répertoires système tels que /usr/local/bin nécessitent des privilèges administrateur. Sous Linux et macOS, préfixez la commande avec sudo (par exemple, sudo mv ./aliyun /usr/local/bin/). Sur Windows, exécutez PowerShell en tant qu'administrateur.
Le délai d'attente est dépassé lors de l'installation ou de la mise à jour via Homebrew sur macOS
Ce problème survient généralement en raison d'une lenteur d'accès réseau au CDN GitHub. Configurez un miroir domestique pour Homebrew, tel que celui de l'USTC, comme indiqué dans la section d'installation Homebrew. Pour rendre ces paramètres persistants, ajoutez les lignes export au fichier ~/.zshrc (ou ~/.bashrc), puis exécutez source ~/.zshrc.
Un double-clic sur aliyun.exe sous Windows reste sans effet
Alibaba Cloud CLI est un outil en ligne de commande dépourvu d'interface graphique. Ouvrez l'invite de commandes ou PowerShell, accédez au répertoire contenant aliyun.exe (ou assurez-vous qu'il figure dans votre variable PATH), puis saisissez vos commandes.