Tous les produits
Search
Centre de documentation

Elastic Compute Service:Upgrade or disable auto-upgrade for Cloud Assistant Agent

Dernière mise à jour :Aug 18, 2026

Mettez à jour le Cloud Assistant Agent pour bénéficier des dernières fonctionnalités, ou désactivez la mise à jour automatique pour figer une version spécifique.

Limites

Mises à jour automatiques

Important

Dans les régions Mexique et Chine (Zhongwei), Cloud Assistant ne met pas automatiquement à jour les instances exécutant des versions antérieures à celles indiquées ci-dessous. Pour utiliser les nouvelles fonctionnalités, appelez InstallCloudAssistant afin d'installer la dernière version, ou effectuez une mise à jour manuelle. Consultez la rubrique Installer le Cloud Assistant Agent.

  • Linux : 2.2.3.515

  • Windows : 2.1.3.515

Par défaut, le Cloud Assistant Agent exécute le programme aliyun_assist_update toutes les 30 minutes. Voici le chemin du programme :

  • Instances Windows : C:\ProgramData\aliyun\assist\{VERSION}\aliyun_assist_update.exe

  • Instances Linux : /usr/local/share/aliyun-assist/{VERSION}/aliyun_assist_update

Remarque

{VERSION} représente le numéro de version du Cloud Assistant Agent. Pour afficher le numéro de version, consultez la rubrique Installer le Cloud Assistant Agent.

Configurez une politique de mise à jour pour contrôler les fenêtres de mise à jour et éviter les interruptions pendant les heures de pointe.

  1. Accédez à Console ECS - Cloud Assistant.

  2. Dans le coin supérieur droit, cliquez sur Settings.

    image

  3. Dans la boîte de dialogue Cloud Assistant Settings, cliquez sur l'onglet Cloud Assistant Agent Upgrade Settings.

  4. Sélectionnez Cloud Assistant Agent Upgrade Settings, définissez les paramètres Period Allowed for Upgrade et Time Zone, puis cliquez sur OK.

    Remarque

    Vous pouvez spécifier jusqu'à cinq plages horaires. L'intervalle minimal entre deux plages est d'une heure.

    image

Désactiver les mises à jour automatiques

  • Pour désactiver la mise à jour automatique d'une version spécifique, créez des fichiers de configuration pour désactiver les mises à jour automatiques ou renommez le programme de mise à jour automatique.

  • Pour désactiver la mise à jour automatique pour toutes les versions, créez des fichiers de configuration pour désactiver les mises à jour automatiques.

Renommer le programme de mise à jour automatique

Renommez le fichier aliyun_assist_update pour désactiver la mise à jour automatique du Cloud Assistant Agent.

Remarque

VERSION représente le numéro de version du Cloud Assistant Agent. Pour plus d'informations sur l'affichage du numéro de version, consultez la rubrique Installer le Cloud Assistant Agent.

  • Windows Server : Renommez aliyun_assist_update en aliyun_assist_update.bk.Rename-Item -Path 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe' -NewName 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe.bk'

  • Linux : Renommez aliyun_assist_update en aliyun_assist_update.bk.mv /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update.bk

Pour réactiver la mise à jour automatique, renommez le fichier en aliyun_assist_update.

  • Windows Server :Rename-Item -Path 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe.bk' -NewName 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe'

  • Linux :mv /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update.bk /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update

Créer des fichiers de configuration pour désactiver les mises à jour automatiques

Pour le Cloud Assistant Agent 2.2.1.140 ou version ultérieure sous Linux et le Cloud Assistant Agent 2.1.1.140 ou version ultérieure sous Windows, créez des fichiers de configuration pour désactiver la mise à jour automatique :

Étape 1 : Désactiver la vérification des mises à jour au démarrage par le Cloud Assistant Agent

Créez un fichier vide disable_bootstrap_update dans le répertoire config du répertoire d'installation du Cloud Assistant Agent. Cela désactive la vérification de mise à jour au démarrage pour la version actuelle. Pour la désactiver pour toutes les versions, créez le fichier dans le répertoire config partagé.

  • Windows Server :# Par exemple, la commande suivante désactive la vérification de mise à jour au démarrage pour une version spécifique du Cloud Assistant Agent.

    New-Item -Path 'C:\ProgramData\aliyun\assist\VERSION\config\disable_bootstrap_update'

    Par exemple, la commande suivante désactive la vérification de mise à jour au démarrage pour toutes les versions du Cloud Assistant Agent.

    New-Item -Path 'C:\ProgramData\aliyun\assist\config\disable_bootstrap_update'

  • Linux :# Par exemple, la commande suivante désactive la vérification de mise à jour au démarrage pour une version spécifique du Cloud Assistant Agent.

    touch /usr/local/share/aliyun-assist/VERSION/config/disable_bootstrap_update

    Par exemple, la commande suivante désactive la vérification de mise à jour au démarrage pour toutes les versions du Cloud Assistant Agent.

    touch /usr/local/share/aliyun-assist/config/disable_bootstrap_update

Remarque

VERSION représente le numéro de version du Cloud Assistant Agent. Pour plus d'informations sur l'affichage du numéro de version, consultez la rubrique Installer le Cloud Assistant Agent.

Étape 2 : Désactiver la vérification automatique des mises à jour par le Cloud Assistant Agent

Créez un fichier vide disable_update dans le répertoire config du répertoire d'installation du Cloud Assistant Agent. Cela désactive la mise à jour automatique périodique pour cette version. Pour la désactiver pour toutes les versions, créez le fichier dans le répertoire config partagé.

  • Windows Server :# Par exemple, la commande suivante désactive les mises à jour automatiques pour une version spécifique du Cloud Assistant Agent.

    New-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_update

    Par exemple, la commande suivante désactive les mises à jour automatiques pour toutes les versions du Cloud Assistant Agent.

    New-Item -Path C:\ProgramData\aliyun\assist\config\disable_update

  • Linux :# Par exemple, la commande suivante désactive les mises à jour automatiques pour une version spécifique du Cloud Assistant Agent.

    touch /usr/local/share/aliyun-assist/VERSION/config/disable_update

    Par exemple, la commande suivante désactive les mises à jour automatiques pour toutes les versions du Cloud Assistant Agent.

    touch /usr/local/share/aliyun-assist/config/disable_update

Remarque

VERSION représente le numéro de version du Cloud Assistant Agent. Pour plus d'informations sur l'affichage du numéro de version, consultez la rubrique Installer le Cloud Assistant Agent.

Pour réactiver la mise à jour automatique, supprimez les fichiers disable_update et disable_bootstrap_update.

  • Windows Server :Remove-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_update

    Remove-Item -Path C:\ProgramData\aliyun\assist\config\disable_update

    Remove-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_bootstrap_update

    Remove-Item -Path C:\ProgramData\aliyun\assist\config\disable_bootstrap_update

  • Linux :rm /usr/local/share/aliyun-assist/VERSION/config/disable_update

    rm /usr/local/share/aliyun-assist/config/disable_update

    rm /usr/local/share/aliyun-assist/VERSION/config/disable_bootstrap_update

    rm /usr/local/share/aliyun-assist/config/disable_bootstrap_update

Mise à jour manuelle

Remarque

Pour connaître les fonctionnalités prises en charge et les versions minimales de l'agent, consultez la rubrique Fonctionnalités et versions prises en charge.

Mettre à jour à l'aide de commandes publiques

Si la mise à jour automatique échoue, exécutez des commandes publiques pour mettre à jour l'agent.

Important

Les étapes suivantes utilisent la console. Pour exécuter des commandes publiques avec OpenAPI ou CLI, consultez la rubrique Afficher et exécuter des commandes publiques.

  1. Accédez à Console ECS - Cloud Assistant.

  2. Sur la page Cloud Assistant, cliquez sur l'onglet Common Commands.

  3. Recherchez la dernière version de la commande publique applicable et cliquez sur Run.

    • Instances Linux : ACS-ECS-UpdateAliyunAssist-linux.sh.

    • Instances Windows : ACS-ECS-UpdateAliyunAssist-windows.ps1.

    Dans la console ECS Cloud Assistant, cliquez sur l'onglet Public Commands, recherchez la commande cible (par exemple ACS-ECS-UpdateAliyunAssist-linux.sh), puis cliquez sur Execute à côté de la version souhaitée.

  4. Dans le panneau Run Command, configurez les paramètres et cliquez sur Run.

    • Execution Plan : Sélectionnez l'heure d'exécution de la commande. Consultez la rubrique Détails du plan d'exécution.

    • Select Instance : Sélectionnez les instances à mettre à jour. Les instances doivent être dans l'état Running et l'agent doit être installé.

      Pour plus de détails sur les paramètres, consultez la rubrique Afficher et exécuter des commandes publiques.

    Si la sortie ressemble à celle de la figure suivante, le Cloud Assistant Agent est mis à jour.image.png

Remarque

Si la commande publique échoue, vérifiez le message d'erreur. Consultez la rubrique Erreurs courantes et dépannage des échecs d'exécution.

Mettre à jour en téléchargeant manuellement le package d'installation

Téléchargez le dernier package d'installation pour mettre à jour l'agent. Pour les méthodes d'installation, consultez la rubrique Installer le Cloud Assistant Agent.

Par exemple, sur une instance Linux x86, téléchargez et installez le dernier package RPM de l'agent :

wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm" && sudo rpm -ivh --force aliyun_assist_latest.rpm

Versions maximales de l'agent par version du noyau

Version du noyau

Version maximale de l'agent

Noyau Linux antérieur à 2.6.32

  • Architecture x86/x64 : 2.2.3.398

  • Architecture ARM : 2.4.3.398

FreeBSD 11 ou version antérieure (version du noyau antérieure à 12.x)

2.3.3.529