Tous les produits
Search
Centre de documentation

Elastic Compute Service:Install the Cloud Assistant agent

Dernière mise à jour :Sep 06, 2026

Pour gérer vos instances sans vous y connecter, exécuter des commandes ou envoyer des fichiers via la console ou une API, vous devez installer et exécuter l'agent Cloud Assistant sur les instances cibles.

Applicabilité

L'agent Cloud Assistant est pris en charge sur les systèmes d'exploitation suivants :

  • Linux : Alibaba Cloud Linux, AlmaLinux 8+, Anolis OS 7+, CentOS 5+, Debian 8+, Ubuntu 12+, RHEL 5+, SUSE 11+, Fedora 33+, CoreOS et OpenSUSE.

  • FreeBSD : 11+.

  • Windows : Windows Server 2012+.

Alibaba Cloud préinstalle l'agent Cloud Assistant sur les instances ECS créées à partir d'images publiques après le 1er décembre 2017.

Procédure

Console

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

  2. Dans le coin supérieur gauche de la page, sélectionnez le groupe de ressources et la région des ressources cibles.

  3. Cliquez sur l'onglet ECS Instance pour afficher l'état de Cloud Assistant pour les instances ECS dans la région actuelle.

    • Normal : L'agent est installé.

    • Not Installed : Cliquez sur Install et attendez la fin de l'installation. Redémarrez l'instance, puis vérifiez si l'état passe à Normal.

    • Abnormal : Pour plus d'informations, consultez la rubrique Gérer les exceptions de Cloud Assistant.

Instance Linux

Étape 1 : Vérifier l'installation de l'agent

  1. Se connecter à l'instance Linux à l'aide de Workbench.

  2. Identifiez le type de système init.

    Le système init charge et gère les processus de service au démarrage. Les commandes de l'agent Cloud Assistant varient selon le système init.
    • systemd : Alibaba Cloud Linux, CentOS 7+, RHEL 7+, Fedora 15+, Ubuntu 15.04+, Debian 8+ et autres distributions similaires.

    • Upstart : Ubuntu 6.10 à 14.10, RHEL 6, CentOS 6 et autres distributions similaires.

    • SysVinit : RHEL 5, CentOS 5, Debian 6 et autres distributions similaires.

  3. Vérifiez que l'agent Cloud Assistant est installé.

    systemd

    systemctl status aliyun.service

    Si la sortie contient le message Unit aliyun.service could not be found, l'agent n'est pas installé.

    Upstart

    /sbin/initctl status aliyun-service

    Si la sortie contient le message initctl: Unknown job: aliyun-service, l'agent n'est pas installé.

    SysVinit

    /etc/init.d/aliyun-service status

    Si la sortie est vide, l'agent n'est pas installé.

Étape 2 : Télécharger et installer l'agent

Ce script est destiné aux instances ECS Alibaba Cloud. Par défaut, il installe la dernière version de l'agent. Pour installer une version spécifique, modifiez VERSION=latest.

#!/bin/bash
VERSION=latest
PACKAGE=
PKG_URI=

REGION=$(curl -s http://100.100.100.200/latest/meta-data/region-id)
DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com

arch=$(uname -m)
echo "[main] arch = ${arch}"

# Detect whether the system is openSUSE or SLES.
is_suse_like() {
    if [[ -f /etc/os-release ]]; then
        local os_id
        os_id=$(grep -E "^ID=" /etc/os-release | tr -d '"' | cut -d= -f2)
        local os_version
        os_version=$(grep -E "^VERSION_ID=" /etc/os-release | tr -d '"' | cut -d= -f2 | cut -d. -f1)
        if ([[ "$os_id" == "opensuse"* ]] || [[ "$os_id" == "sles" ]]) && [[ "$os_version" == "16" ]]; then
            return 0
        fi
    fi
    return 1
}

case $arch in
    "i386"|"i686"|"x86_64"|"amd64")
        if command -v rpm && ! command -v dpkg; then
            if [[ "$arch" == "x86_64" ]] && is_suse_like; then
                PACKAGE="aliyun_assist_${VERSION}_x86_64.rpm"
            else
                PACKAGE="aliyun_assist_${VERSION}.rpm"
            fi
        else
            if [[ "$arch" == "x86_64" ]] && is_suse_like; then
                PACKAGE="aliyun_assist_${VERSION}_x86_64.deb"
            else
                PACKAGE="aliyun_assist_${VERSION}.deb"
            fi
        fi
        PKG_URI="https://$DOMAIN/linux/$PACKAGE"
        ;;
    *)
        if command -v rpm && ! command -v dpkg; then
            PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
        else
            PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb"
        fi
        PKG_URI="https://$DOMAIN/arm/$PACKAGE"
        ;;
esac

echo "[main] package = ${PACKAGE}"
echo "[main] pkg_uri = ${PKG_URI}"

if command -v wget; then
    sudo wget -O "${PACKAGE}" "${PKG_URI}"
elif command -v curl; then
    sudo curl -o "${PACKAGE}" "${PKG_URI}"
else
    echo "[WARN] command wget/curl not found, exit"
    exit 1
fi

if command -v rpm && ! command -v dpkg; then
    sudo rpm -ivh --force "${PACKAGE}"
elif command -v dpkg; then
    sudo dpkg -i "${PACKAGE}"
else
    echo "[WARN] command rpm/dpkg not found, exit"
    exit 2
fi

if [[ -e /etc/redhat-release ]]; then
    if sudo systemctl status qemu-guest-agent; then
        sudo systemctl stop qemu-guest-agent
        sudo systemctl disable qemu-guest-agent
        sudo systemctl restart aliyun.service
    fi
fi

Instance Windows

Étape 1 : Vérifier l'installation de l'agent

  1. Se connecter à une instance Windows à l'aide d'un client Remote Desktop ou de l'application Windows.

  2. Vérifiez l'état du service Cloud Assistant.

    1. Ouvrez le menu Démarrer et recherchez Computer Management.

    2. Accédez à Services and Applications > Services.

    3. Recherchez Aliyun Assist Service. S'il ne figure pas dans la liste, l'agent n'est pas installé.

      Si le service existe et que son état est Running avec un type de démarrage défini sur Automatic, l'agent Cloud Assistant est installé et fonctionne correctement.

Étape 2 : Télécharger et installer l'agent

Méthode 1 : Télécharger via un navigateur
  1. Téléchargez l'agent Cloud Assistant.

    Remplacez {regionId} par l'ID de région de votre instance, puis ouvrez l'URL dans un navigateur.

    https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
    
    # Example download URL for the China (Hangzhou) region (cn-hangzhou)
    https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
  2. Installez l'agent Cloud Assistant.

    Double-cliquez sur le fichier de l'agent Cloud Assistant et suivez l'assistant d'installation. Le chemin d'installation par défaut est C:\ProgramData\aliyun\assist\.

Méthode 2 : Utiliser PowerShell

Remplacez {regionId} par l'ID de région de votre instance, puis exécutez les commandes suivantes dans PowerShell.

curl -UseBasicParsing -Uri https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe -OutFile 'C:\aliyun_agent_latest_setup.exe'
& "C:\aliyun_agent_latest_setup.exe" /S

API

Le processus d'installation via l'API est identique pour tous les systèmes d'exploitation pris en charge.

  1. Appelez l'opération DescribeCloudAssistantStatus pour vérifier si l'agent Cloud Assistant est installé sur l'instance ECS cible.

    Si le paramètre CloudAssistantStatus renvoie false, l'agent n'est pas installé.

  2. Si l'agent n'est pas installé, appelez l'opération InstallCloudAssistant pour installer l'agent Cloud Assistant.

  3. Une fois l'installation terminée, appelez l'opération RebootInstance pour redémarrer l'instance ECS et appliquer les modifications.

CLI

Vous pouvez utiliser l'Alibaba Cloud CLI pour installer l'agent Cloud Assistant sur la plupart des systèmes d'exploitation pris en charge. Remplacez <YOUR-REGION-ID> par l'ID de région de votre instance ECS et <YOUR-INSTANCE-ID> par l'ID de votre instance ECS.

Red Hat Enterprise Linux (RHEL) ne prend pas en charge l'installation via Alibaba Cloud CLI.
  1. Appelez l'opération DescribeCloudAssistantStatus pour vérifier si l'agent Cloud Assistant est installé sur l'instance ECS cible.

    aliyun ecs DescribeCloudAssistantStatus --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]

    Si la commande renvoie CloudAssistantStatus=true, l'agent Cloud Assistant est installé sur l'instance ECS.

  2. Appelez l'opération InstallCloudAssistant pour installer l'agent Cloud Assistant.

    aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>
  3. Appelez l'opération RebootInstance pour redémarrer l'instance ECS.

    aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>

FAQ

Systèmes d'exploitation non pris en charge

Limites d'installation de la dernière version

Certains noyaux limitent la version la plus élevée de l'agent que vous pouvez installer.

Exécutez la commande uname -r pour vérifier la version du noyau.

Version du noyau de l'instance

Version la plus élevée prise en charge

Version du noyau Linux < 2.6.32

  • Architecture x86/x64 : 2.2.3.398

  • Architecture ARM : 2.4.3.398

Version du noyau FreeBSD < 12.x

2.3.3.529

Installation sur FreeBSD

  • Pour les instances ECS Alibaba Cloud

    #!/bin/sh
    
    VERSION=latest
    use_curl=0
    which curl >/dev/null 2>&1 && use_curl=1
    if [ $use_curl -eq 1 ];then
        REGION=$(curl http://100.100.100.200/latest/meta-data/region-id)
    else
        REGION=$(wget -O - http://100.100.100.200/latest/meta-data/region-id)
    fi
    DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com
    PACKAGE=aliyun_assist_${VERSION}.txz
    PKG_URI="https://$DOMAIN/freebsd/$PACKAGE"
    
    if [ $use_curl -eq 1 ];then
        curl -o $PACKAGE $PKG_URI
    else
        wget -O $PACKAGE $PKG_URI
    fi
    pkg install -U -y $PACKAGE
    service aliyun start
  • Pour les instances gérées (serveurs non Alibaba Cloud)

    #!/bin/sh
    
    VERSION=latest
    DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
    PACKAGE=aliyun_assist_${VERSION}.txz
    PKG_URI="https://$DOMAIN/freebsd/$PACKAGE"
    
    use_curl=0
    which curl >/dev/null 2>&1 && use_curl=1
    if [ $use_curl -eq 1 ];then
        curl -o $PACKAGE $PKG_URI
    else
        wget -O $PACKAGE $PKG_URI
    fi
    pkg install -U -y $PACKAGE
    service aliyun start

Installation sur instance gérée

Linux

Ce script installe la dernière version de l'agent par défaut. Pour installer une version spécifique, modifiez VERSION=latest .
#!/bin/bash
VERSION=latest
PACKAGE=
PKG_URI=

DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com

arch=$(uname -m)
echo "[main] arch = ${arch}"

# Detect whether the system is openSUSE or SLES.
is_suse_like() {
    if [[ -f /etc/os-release ]]; then
        local os_id
        os_id=$(grep -E "^ID=" /etc/os-release | tr -d '"' | cut -d= -f2)
        local os_version
        os_version=$(grep -E "^VERSION_ID=" /etc/os-release | tr -d '"' | cut -d= -f2 | cut -d. -f1)
        if ([[ "$os_id" == "opensuse"* ]] || [[ "$os_id" == "sles" ]]) && [[ "$os_version" == "16" ]]; then
            return 0
        fi
    fi
    return 1
}

case $arch in
    "i386"|"i686"|"x86_64"|"amd64")
        if command -v rpm && ! command -v dpkg; then
            if [[ "$arch" == "x86_64" ]] && is_suse_like; then
                PACKAGE="aliyun_assist_${VERSION}_x86_64.rpm"
            else
                PACKAGE="aliyun_assist_${VERSION}.rpm"
            fi
        else
            if [[ "$arch" == "x86_64" ]] && is_suse_like; then
                PACKAGE="aliyun_assist_${VERSION}_x86_64.deb"
            else
                PACKAGE="aliyun_assist_${VERSION}.deb"
            fi
        fi
        PKG_URI="https://$DOMAIN/linux/$PACKAGE"
        ;;
    *)
        if command -v rpm && ! command -v dpkg; then
            PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
        else
            PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb"
        fi
        PKG_URI="https://$DOMAIN/arm/$PACKAGE"
        ;;
esac

echo "[main] package = ${PACKAGE}"
echo "[main] pkg_uri = ${PKG_URI}"

if command -v wget; then
    sudo wget -O "${PACKAGE}" "${PKG_URI}"
elif command -v curl; then
    sudo curl -o "${PACKAGE}" "${PKG_URI}"
else
    echo "[WARN] command wget/curl not found, exit"
    exit 1
fi

if command -v rpm && ! command -v dpkg; then
    sudo rpm -ivh --force "${PACKAGE}"
elif command -v dpkg; then
    sudo dpkg -i "${PACKAGE}"
else
    echo "[WARN] command rpm/dpkg not found, exit"
    exit 2
fi

if [[ -e /etc/redhat-release ]]; then
    if sudo systemctl status qemu-guest-agent; then
        sudo systemctl stop qemu-guest-agent
        sudo systemctl disable qemu-guest-agent
        sudo systemctl restart aliyun.service
    fi
fi

Windows

Méthode 1 : Télécharger via un navigateur
  1. Ouvrez l'URL suivante dans un navigateur pour télécharger l'agent Cloud Assistant.

    https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
  2. Installez l'agent Cloud Assistant.

    Double-cliquez sur le fichier de l'agent Cloud Assistant et suivez l'assistant d'installation. Le chemin d'installation par défaut est C:\ProgramData\aliyun\assist\.

Méthode 2 : Utiliser PowerShell
curl -UseBasicParsing -Uri https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe -OutFile 'C:\\aliyun_agent_latest_setup.exe' & "C:\\aliyun_agent_latest_setup.exe" /S 

Installer à partir d'un binaire ou du code source

Package binaire

  • Pour les instances ECS Alibaba Cloud

    Ce script installe la dernière version de l'agent par défaut. Pour installer une version spécifique, modifiez VERSION=latest .
    #!/bin/bash
    
    VERSION=latest
    PACKAGE=
    PKG_URI=
    
    REGION=$(curl -s http://100.100.100.200/latest/meta-data/region-id)
    DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com
    
    arch=$(uname -m)
    echo "[main] arch = ${arch}"
    
    # Detect whether the system is openSUSE or SLES.
    is_suse_like() {
        if [[ -f /etc/os-release ]]; then
            local os_id
            os_id=$(grep -E "^ID=" /etc/os-release | tr -d '"' | cut -d= -f2)
            local os_version
            os_version=$(grep -E "^VERSION_ID=" /etc/os-release | tr -d '"' | cut -d= -f2 | cut -d. -f1)
            if ([[ "$os_id" == "opensuse"* ]] || [[ "$os_id" == "sles" ]]) && [[ "$os_version" == "16" ]]; then
                return 0
            fi
        fi
        return 1
    }
    
    case $arch in
        "i386"|"i686"|"x86_64"|"amd64")
            if [[ "$arch" == "x86_64" ]] && is_suse_like; then
                PACKAGE="aliyun_assist_${VERSION}_update_x86_64.zip"
            else
                PACKAGE="aliyun_assist_${VERSION}_update.zip"
            fi
            PKG_URI="https://$DOMAIN/linux/$PACKAGE"
            ;;
        *)
            PACKAGE="aliyun_assist_${VERSION}_update_arm.zip"
            PKG_URI="https://$DOMAIN/arm/$PACKAGE"
            ;;
    esac
    
    echo "[main] package = ${PACKAGE}"
    echo "[main] pkg_uri = ${PKG_URI}"
    
    if command -v wget; then
        sudo wget -O "${PACKAGE}" "${PKG_URI}"
    elif command -v curl; then
        sudo curl -o "${PACKAGE}" "${PKG_URI}"
    else
        echo "[WARN] command wget/curl not found, exit"
        exit 1
    fi
    
    TARGET_DIR=/usr/local/share/aliyun-assist
    sudo unzip -o "${PACKAGE}" -d $TARGET_DIR/
    TRUE_VERSION=$(cat $TARGET_DIR/version)
    sudo chmod a+x $TARGET_DIR/$TRUE_VERSION/update_install
    sudo bash $TARGET_DIR/$TRUE_VERSION/update_install
  • Pour les instances gérées (serveurs non Alibaba Cloud)

    #!/bin/bash
    
    VERSION=latest
    PACKAGE=
    PKG_URI=
    
    DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
    
    arch=$(uname -m)
    echo "[main] arch = ${arch}"
    
    # Detect whether the system is openSUSE or SLES.
    is_suse_like() {
        if [[ -f /etc/os-release ]]; then
            local os_id
            os_id=$(grep -E "^ID=" /etc/os-release | tr -d '"' | cut -d= -f2)
            local os_version
            os_version=$(grep -E "^VERSION_ID=" /etc/os-release | tr -d '"' | cut -d= -f2 | cut -d. -f1)
            if ([[ "$os_id" == "opensuse"* ]] || [[ "$os_id" == "sles" ]]) && [[ "$os_version" == "16" ]]; then
                return 0
            fi
        fi
        return 1
    }
    
    case $arch in
        "i386"|"i686"|"x86_64"|"amd64")
            if [[ "$arch" == "x86_64" ]] && is_suse_like; then
                PACKAGE="aliyun_assist_${VERSION}_update_x86_64.zip"
            else
                PACKAGE="aliyun_assist_${VERSION}_update.zip"
            fi
            PKG_URI="https://$DOMAIN/linux/$PACKAGE"
            ;;
        *)
            PACKAGE="aliyun_assist_${VERSION}_update_arm.zip"
            PKG_URI="https://$DOMAIN/arm/$PACKAGE"
            ;;
    esac
    
    echo "[main] package = ${PACKAGE}"
    echo "[main] pkg_uri = ${PKG_URI}"
    
    if command -v wget; then
        sudo wget -O "${PACKAGE}" "${PKG_URI}"
    elif command -v curl; then
        sudo curl -o "${PACKAGE}" "${PKG_URI}"
    else
        echo "[WARN] command wget/curl not found, exit"
        exit 1
    fi
    
    TARGET_DIR=/usr/local/share/aliyun-assist
    sudo unzip -o "${PACKAGE}" -d $TARGET_DIR/
    TRUE_VERSION=$(cat $TARGET_DIR/version)
    sudo chmod a+x $TARGET_DIR/$TRUE_VERSION/update_install
    sudo bash $TARGET_DIR/$TRUE_VERSION/update_install

Code source

L'exemple suivant utilise yum. Pour les autres distributions Linux, utilisez le gestionnaire de packages correspondant.

  1. Installez les prérequis, tels que Git et Go.

    # Install Git
    sudo yum install git -y
    
    # Install Go
    sudo yum install go -y
  2. Téléchargez le code source de l'agent Cloud Assistant.

    sudo git clone https://github.com/aliyun/aliyun_assist_client
  3. Accédez au répertoire du code source et compilez-le.

    # Go to the source code directory.
    cd ./aliyun_assist_client
    
    # Compile the source code.
    sudo go build

    Si la réponse ne contient aucun message d'erreur, l'installation a réussi.