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
Accédez à la page Console ECS - Cloud Assistant.
Dans le coin supérieur gauche de la page, sélectionnez le groupe de ressources et la région des ressources cibles.
-
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
-
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.
-
Vérifiez que l'agent Cloud Assistant est installé.
systemd
systemctl status aliyun.serviceSi la sortie contient le message
Unit aliyun.service could not be found, l'agent n'est pas installé.Upstart
/sbin/initctl status aliyun-serviceSi la sortie contient le message
initctl: Unknown job: aliyun-service, l'agent n'est pas installé.SysVinit
/etc/init.d/aliyun-service statusSi 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
Se connecter à une instance Windows à l'aide d'un client Remote Desktop ou de l'application Windows.
-
Vérifiez l'état du service Cloud Assistant.
Ouvrez le menu Démarrer et recherchez .
Accédez à .
-
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
-
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 -
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.
-
Appelez l'opération DescribeCloudAssistantStatus pour vérifier si l'agent Cloud Assistant est installé sur l'instance ECS cible.
Si le paramètre
CloudAssistantStatusrenvoiefalse, l'agent n'est pas installé. Si l'agent n'est pas installé, appelez l'opération InstallCloudAssistant pour installer l'agent Cloud Assistant.
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.
-
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. -
Appelez l'opération InstallCloudAssistant pour installer l'agent Cloud Assistant.
aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> -
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
Migrer le système d'exploitation : Mettez à niveau ou migrez votre système actuel vers une version prise en charge.
Remplacer le système d'exploitation (changer le disque système) : Utilisez la fonctionnalité Replace OS pour installer un système d'exploitation pris en charge sur l'instance.
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 |
|
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
-
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 -
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.
-
Installez les prérequis, tels que Git et Go.
# Install Git sudo yum install git -y # Install Go sudo yum install go -y -
Téléchargez le code source de l'agent Cloud Assistant.
sudo git clone https://github.com/aliyun/aliyun_assist_client -
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 buildSi la réponse ne contient aucun message d'erreur, l'installation a réussi.