Instale e inicie o Cloud Assistant Agent nas suas instâncias ECS para executar comandos e enviar arquivos remotamente.
Aplicabilidade
O Cloud Assistant Agent é compatível com os seguintes sistemas operacionais:
-
Linux: Alibaba Cloud Linux, AlmaLinux 8+, Anolis OS 7+, CentOS 5+, Debian 8+, Ubuntu 12+, RHEL 5+, SUSE 11+, Fedora 33+, CoreOS e OpenSUSE.
-
FreeBSD: 11+.
-
Windows: Server 2012+.
Desde 1º de dezembro de 2017, todas as instâncias ECS criadas a partir de imagens públicas possuem o Cloud Assistant Agent pré-instalado.
Procedimento
Console
-
Acesse a página ECS console - Cloud Assistant.
-
No canto superior esquerdo, selecione a região e o grupo de recursos da instância de destino.
-
Clique na aba ECS Instances para visualizar o status do Cloud Assistant Agent das instâncias na região atual.
-
Normal: O agente está instalado.
-
Não instalado: Clique em Instalar e aguarde a conclusão da instalação. Reinicie a instância e verifique se o status muda para Normal.

-
Anormal: Consulte Resolver exceções do Cloud Assistant.
-
Instância Linux
Verificar a instalação do agente
-
Identifique o tipo de sistema init.
O sistema init gerencia os processos de serviço na inicialização. Os comandos do Cloud Assistant Agent variam de acordo com o sistema init.
-
systemd: Alibaba Cloud Linux, CentOS 7+, RHEL 7+, Fedora 15+, Ubuntu 15.04+, Debian 8+ e outros. -
Upstart: Ubuntu 6.10–14.10, RHEL 6, CentOS 6 e outros. -
SysVinit: RHEL 5, CentOS 5, Debian 6 e outros.
-
-
Verifique se o Cloud Assistant Agent está instalado.
Systemd
systemctl status aliyun.serviceSe a saída contiver
Unit aliyun.service could not be found, o agente não está instalado.Upstart
/sbin/initctl status aliyun-serviceSe a saída contiver
initctl: Unknown job: aliyun-service, o agente não está instalado.Sysvinit
/etc/init.d/aliyun-service statusSe a saída estiver vazia, o agente não está instalado.
Baixar e instalar o agente
Este script é destinado a instâncias Alibaba Cloud ECS e instala a versão mais recente do agente por padrão. Para instalar uma versão específica, modifique a linha VERSION=latest.
#!/bin/bash
VERSION=latest
PACKAGE=
PKG_URI=
REGION=$(curl 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}"
case $arch in
"i386"|"i686"|"x86_64"|"amd64")
if command -v rpm; then
PACKAGE="aliyun_assist_${VERSION}.rpm"
else
PACKAGE="aliyun_assist_${VERSION}.deb"
fi
PKG_URI="https://$DOMAIN/linux/$PACKAGE"
;;
*)
if command -v rpm; then
PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
else
PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb"
fi
PKG_URI="https://$DOMAIN/arm/$PACKAGE"
esac
if command -v wget; then
sudo wget $PKG_URI
elif command -v curl; then
curl -o $PACKAGE $PKG_URI
else
echo "[WARN] command wget/curl not found, exit"
exit 1;
fi;
if command -v rpm; 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
Instância Windows
Verificar a instalação do agente
-
Conecte-se a uma instância Windows usando um cliente de Área de Trabalho Remota ou o Windows App.
-
Verifique o status do serviço Cloud Assistant.
-
Abra o menu Iniciar e pesquise por .
-
Navegue até .
-
Localize Aliyun Assist Service. Se não estiver listado, o agente não está instalado.

-
Baixar e instalar o agente
Método 1: Baixar usando um navegador
-
Baixe o Cloud Assistant Agent.
Substitua
{regionId}pelo ID da região da sua instância e abra a URL em um navegador.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 -
Instale o Cloud Assistant Agent.
Clique duas vezes no arquivo do agente e siga o assistente de instalação. Caminho padrão:
C:\ProgramData\aliyun\assist\.
Método 2: Instalar usando PowerShell
Substitua {regionId} pelo ID da região da sua instância e execute o script no 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
Aplica-se a todos os sistemas operacionais compatíveis.
-
Chame DescribeCloudAssistantStatus para verificar se o Cloud Assistant Agent está instalado na instância de destino.
Se
CloudAssistantStatusforfalse, o agente não está instalado. -
Se o agente não estiver instalado, chame InstallCloudAssistant para instalá-lo.
-
Após a instalação, chame RebootInstance para reiniciar a instância.
CLI
Usa a CLI da Alibaba Cloud. Aplica-se a todos os sistemas operacionais compatíveis. Substitua <YOUR-REGION-ID> pelo ID da região da sua instância ECS e <YOUR-INSTANCE-ID> pelo ID da instância.
A instalação da CLI da Alibaba Cloud não é compatível com Red Hat Enterprise Linux (RHEL).
-
Chame DescribeCloudAssistantStatus para verificar se o Cloud Assistant Agent está instalado na instância de destino.
aliyun ecs DescribeCloudAssistantStatus --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]Se o comando retornar
CloudAssistantStatus=true, o agente já está instalado. -
Chame InstallCloudAssistant para instalar o agente.
aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> -
Chame RebootInstance para reiniciar a instância.
aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>
Perguntas frequentes
Sistemas operacionais não compatíveis
-
Migrar o SO: Atualize ou migre para uma versão compatível.
-
Substituir o SO (disco do sistema): Substitua o disco do sistema por um sistema operacional compatível.
Não é possível instalar a versão mais recente
Alguns kernels limitam as versões do agente que podem ser instaladas.
Execute uname -r para verificar a versão do seu kernel.
|
Versão do kernel da instância |
Versão compatível mais recente |
|
Versão do kernel Linux < 2.6.32 |
|
|
Versão do kernel FreeBSD < 12.x |
2.3.3.529 |
Instalação no FreeBSD
-
Para instâncias Alibaba Cloud ECS
#!/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 -
Para instâncias gerenciadas (servidores não hospedados na 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
Instalação em instâncias gerenciadas
Linux
Instala a versão mais recente do agente por padrão. Para instalar uma versão específica, modifique a linha VERSION=latest.
#!/bin/bash
VERSION=latest
PACKAGE=
PKG_URI=
DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
arch=$(uname -m)
echo "[main] arch = ${arch}"
case $arch in
"i386"|"i686"|"x86_64"|"amd64")
if command -v rpm; then
PACKAGE="aliyun_assist_${VERSION}.rpm"
else
PACKAGE="aliyun_assist_${VERSION}.deb"
fi
PKG_URI="https://$DOMAIN/linux/$PACKAGE"
;;
*)
if command -v rpm; then
PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
else
PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb"
fi
PKG_URI="https://$DOMAIN/arm/$PACKAGE"
esac
if command -v wget; then
sudo wget $PKG_URI
elif command -v curl; then
curl -o $PACKAGE $PKG_URI
else
echo "[WARN] command wget/curl not found, exit"
exit 1;
fi;
if command -v rpm; 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étodo 1: Baixar usando um navegador
-
Abra a seguinte URL em um navegador para baixar o Cloud Assistant Agent.
https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe -
Instale o Cloud Assistant Agent.
Clique duas vezes no arquivo do agente e siga o assistente de instalação. Caminho padrão:
C:\ProgramData\aliyun\assist\.
Método 2: Instalar usando 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
Instalar a partir de binário ou código-fonte
Pacote binário
-
Para instâncias Alibaba Cloud ECS
Instala a versão mais recente do agente por padrão. Para instalar uma versão específica, modifique a linha
VERSION=latest.#!/bin/bash VERSION=latest PACKAGE= PKG_URI= REGION=$(curl 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}" case $arch in "i386"|"i686"|"x86_64"|"amd64") PACKAGE="aliyun_assist_${VERSION}_update.zip" PKG_URI="https://$DOMAIN/linux/$PACKAGE" ;; *) PACKAGE="aliyun_assist_${VERSION}_update_arm.zip" PKG_URI="https://$DOMAIN/arm/$PACKAGE" esac if command -v wget; then sudo wget $PKG_URI elif command -v curl; then 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 -
Para instâncias gerenciadas (servidores não hospedados na Alibaba Cloud)
#!/bin/bash VERSION=latest PACKAGE= PKG_URI= DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com arch=$(uname -m) echo "[main] arch = ${arch}" case $arch in "i386"|"i686"|"x86_64"|"amd64") PACKAGE="aliyun_assist_${VERSION}_update.zip" PKG_URI="https://$DOMAIN/linux/$PACKAGE" ;; *) PACKAGE="aliyun_assist_${VERSION}_update_arm.zip" PKG_URI="https://$DOMAIN/arm/$PACKAGE" esac if command -v wget; then sudo wget $PKG_URI elif command -v curl; then 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
Código-fonte
O exemplo a seguir usa o yum. Para outras distribuições, use o gerenciador de pacotes correspondente.
-
Instale os softwares necessários, como Git e Go.
# Install Git sudo yum install git -y # Install Go sudo yum install go -y -
Baixe o código-fonte do Cloud Assistant Agent.
sudo git clone https://github.com/aliyun/aliyun_assist_client -
Acesse o diretório do código-fonte e compile.
# Go to the source code directory cd ./aliyun_assist_client # Compile the source code sudo go buildSe o comando for executado sem erros, a instalação foi bem-sucedida.
Problemas do agente na rede clássica
Para instâncias ECS na rede clássica, o Cloud Assistant Agent não pode obter automaticamente as informações da região. Você deve criar manualmente um arquivo de configuração de região na instância.
A rede clássica é um tipo de rede legado que não está mais disponível para novas aquisições. Recomendamos que você migre para uma VPC para melhor desempenho e segurança.
Linux
-
No diretório de instalação do agente, crie um arquivo chamado
region-idcontendo o ID da região da instância ECS.Por exemplo, para uma instância na região China (Hangzhou), crie o arquivo
region-idno diretório padrão/usr/local/share/aliyun-assist/.-
Para CoreOS:
sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id' -
Para outros sistemas operacionais (como Alibaba Cloud Linux, Ubuntu, Debian, RedHat, SUSE e OpenSUSE):
sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'
-
-
Inicie o Cloud Assistant Agent.
aliyun-service -d
Windows
-
No diretório de instalação do agente, crie um arquivo chamado region-id (sem extensão como .txt ou .conf).
Por padrão, o Windows oculta as extensões de arquivo. Configure seu sistema para exibir extensões e confirme que o arquivo region-id não possui extensão.
-
No arquivo region-id, insira o ID da região da instância, por exemplo, cn-hangzhou.
Exemplo: Para uma instância Windows Server 2012 R2 na região China (Hangzhou), crie um arquivo region-id contendo cn-hangzhou em C:\ProgramData\aliyun\assist\.