Recursos, cenários e operações comuns do Cloud Assistant - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Recursos

Operações em lote: Execute comandos em várias instâncias simultaneamente. O Cloud Assistant isola a execução por instância — uma falha em uma não afeta as demais.
Envio de arquivos: Envie arquivos de configuração, scripts ou outros ativos para as instâncias.
Comandos públicos: Scripts e plugins prontos para tarefas comuns, como auditorias de segurança, aplicação de patches no sistema operacional e instalação de aplicativos.
Comandos parametrizados: Defina parâmetros personalizados ou integrados para criar modelos de comandos reutilizáveis. Um único modelo atende a vários cenários com a injeção de valores diferentes em tempo de execução.
Segurança e controle: O Cloud Assistant nunca inicia ações por conta própria — você mantém controle total sobre cada operação.

Casos de uso

Implantação de software: Envie código de aplicativos, atualizações de configuração ou hotfixes para um conjunto de instâncias em uma única operação.
Aplicação de patches de segurança: Distribua patches do sistema operacional ou atualizações de segurança em todas as instâncias sem fazer login individualmente.
Gerenciamento do ciclo de vida de software: Gerencie o ciclo de vida de desenvolvimento de software nas instâncias.
Configuração de instâncias: Modifique nomes de host ou redefina credenciais de usuário em lote.
Monitoramento de processos: Consulte o status de processos ou a integridade do serviço nas instâncias e colete os resultados de forma centralizada.
Gerenciamento de pacotes: Busque e atualize pacotes a partir de repositórios OSS ou YUM.

Operações comuns

A tabela a seguir relaciona tarefas comuns às suas respectivas documentações e referências de API.

Tarefa	Documentação	API
Instale o agente	Install Cloud Assistant Agent	InstallCloudAssistant, DescribeCloudAssistantStatus
Usar o SDK	Run commands using an SDK	--
Crie um comando	Create a command	RunCommand, CreateCommand
Execute um comando	Run a command	RunCommand, InvokeCommand
Verifique resultados	View execution results and troubleshoot common issues	DescribeInvocations, DescribeInvocationResults
Modifique um comando	Modify a command	--
Clonar um comando	Clone a command	--
Parar um comando	Stop a command	StopInvocation
Exclua um comando	Delete a command	DeleteCommand

Nota

O Cloud Assistant Agent vem pré-instalado em instâncias ECS criadas a partir de imagens públicas após 1º de dezembro de 2017.

Requisitos da instância

As instâncias devem estar no status Running.
O Cloud Assistant Agent deve estar instalado. O agente vem pré-instalado em instâncias criadas a partir de imagens públicas após 1º de dezembro de 2017. Para imagens personalizadas ou imagens do Alibaba Cloud Marketplace, verifique a compatibilidade e instale o Cloud Assistant Agent manualmente, se necessário.

Sistemas operacionais compatíveis

Linux

Alibaba Cloud Linux
CentOS 6, 7, 8 e posteriores
CoreOS
Debian 8, 9, 10 e posteriores
OpenSUSE
Red Hat 5, 6, 7 e posteriores

Nota
O Red Hat requer a instalação manual do RPM, portanto consulte Install Cloud Assistant Agent.
SUSE Linux Enterprise Server 11, 12, 15 e posteriores
Ubuntu 12, 14, 16, 18 e posteriores
FreeBSD 11, 12, 13, 14 e posteriores

Windows

Windows Server 2012, 2016, 2019 e posteriores

Limites de payload e parâmetros

Todos os tamanhos referem-se ao payload codificado em Base64.

Operação	Tamanho máximo
Crie comando	18 KB
Execute imediatamente (salve comando)	18 KB
Execute imediatamente (não salve)	24 KB
Enviar arquivo	32 KB

Cada comando suporta até 20 parâmetros personalizados.

Matriz de compatibilidade de recursos

Alguns recursos exigem uma versão mínima do Cloud Assistant Agent.

Recurso	Versão mínima (Linux)	Versão mínima (Windows)
Relatório de heartbeat do agente	1.0.2.458	1.0.0.149
Distribuição de arquivos	1.0.2.569	1.0.0.149
Execute como usuário específico	2.2.0.106	2.1.0.50
Execute na próxima inicialização	2.2.0.46	2.1.0.50
Execute em todas as inicializações	2.2.0.46	2.1.0.50
Suporte ao Session Manager	2.2.3.196	2.1.3.196
Tarefas agendadas (expressões Rate/At)	2.2.3.282	2.1.3.282
Tarefas agendadas (Cron com ano/fuso horário)	2.2.3.282	2.1.3.282
Parâmetros de ambiente integrados	2.2.3.309	2.1.3.309
Nomes de instâncias como parâmetro	2.2.3.344	2.1.3.344
Parar ou reiniciar via código de saída	2.2.3.317	2.1.3.317
Execução em contêiner (por nome)	2.2.3.344	2.1.3.344
Execução em contêiner (por ID)	2.2.3.344	2.1.3.344

Faturamento

O Cloud Assistant em si é gratuito. O faturamento aplica-se apenas aos recursos de ECS (computação, rede, armazenamento) consumidos durante a execução da tarefa; consulte Visão geral do faturamento.

Consumo de recursos

O Cloud Assistant Agent tem impacto mínimo no desempenho da instância.

Recurso	Linux	Windows
CPU	< 1% de uso médio	< 1% de uso médio
Memória física	~20 MB	~30 MB
I/O de disco	Desprezível (picos apenas durante atualizações ou gravação de scripts)	Desprezível (picos apenas durante atualizações ou gravação de scripts)
I/O de rede	Mínimo (tráfego de heartbeat)	Mínimo (tráfego de heartbeat)

Status de execução de comandos

O Cloud Assistant rastreia a execução em dois níveis: nível da instância (status por instância) e nível da invocação (status agregado de todas as instâncias de destino em um lote).

Relationship between invocation status and instance-level status

Status no nível da instância

Esses status correspondem ao campo InvocationStatus em InvokeInstance na API DescribeInvocations, ou ao campo InvocationStatus na API DescribeInvocationResults.

Código de status	Descrição
`Pending`	O sistema está verificando ou enviando o comando.
`Invalid`	Tipo de comando ou parâmetro inválido.
`Aborted`	Falha no envio. A instância deve estar `Running` e o comando deve ser entregue em até 1 minuto.
`Running`	O comando está em execução na instância.
`Success`	Concluído com código de saída 0. Para tarefas agendadas, a última execução terminou com código de saída 0 e o agendamento foi encerrado.
`Failed`	Concluído com um código de saída diferente de zero. Para tarefas agendadas, um código de saída diferente de zero na última execução aborta a tarefa.
`Error`	Ocorreu uma exceção.
`Timeout`	Excedeu o tempo limite especificado.
`Cancelled`	Cancelado antes do início da execução.
`Stopping`	Solicitação de parada enviada; a execução está em processo de interrupção.
`Stopped`	Parado manualmente.
`Terminated`	Encerrado durante a execução.
`Scheduled`	Aguardando a próxima janela de execução agendada.

Status no nível da invocação

Para comandos em lote, o Cloud Assistant agrega os status das instâncias em um único status de invocação retornado no campo InvocationStatus da API DescribeInvocations.

Código de status	Regra de agregação
`Pending`	Pelo menos uma instância está `Pending`.
`Scheduled`	Pelo menos uma instância está `Scheduled`.
`Running`	Pelo menos uma instância está `Running`.
`Success`	Todas as instâncias concluíram a execução. Pelo menos uma relatou `Success`. Para tarefas imediatas, conclusão com código de saída 0. Para tarefas agendadas, a última execução terminou com código de saída 0 e o agendamento foi encerrado.
`Failed`	Todas as instâncias concluíram a execução, mas nenhuma obteve sucesso. Uma instância é considerada com falha se relatar `Invalid`, `Aborted`, `Failed`, `Timeout` ou `Error`.
`Stopping`	Pelo menos uma instância está `Stopping`.
`Stopped`	Todas as instâncias relatam `Stopped` — todas as tarefas foram canceladas (`Cancelled`) ou encerradas (`Terminated`).
`PartialFailed`	Todas as instâncias concluíram a execução com resultados mistos: algumas obtiveram sucesso, enquanto outras falharam ou foram interrompidas.

Permissões (RAM)

A conta Alibaba Cloud tem acesso total ao Cloud Assistant por padrão. Para uso em produção, crie um usuário RAM e conceda apenas as permissões necessárias. Consulte Grant permissions to a RAM user to use Cloud Assistant.

Arquitetura do agente e estrutura de diretórios

Linux

O Cloud Assistant Agent fica instalado em /usr/local/share/aliyun-assist/.

/usr/local/share/aliyun-assist/
- 2.x.x.xxx/ — Diretório específico da versão (por exemplo, 2.2.4.965/).
  - aliyun-service — Binário principal do agente.
  - assist_daemon — Daemon (watchdog) que monitora o aliyun-service e o reinicia em caso de falha.
  - acs-plugin-manager — Utilitário de gerenciamento de plugins.
  - aliyun_assist_update — Utilitário de atualização automática.
  - aliyun_installer — Descontinuado. Substituído pelo acs-plugin-manager.
  - config/
    - GlobalSignRootCA.crt — Certificado raiz para comunicação HTTPS.
    - hash_file — Hashes criptográficos para verificação de integridade.
  - init/
    - install, uninstall, clean — Scripts de instalação, desinstalação e limpeza.
    - version — Versão atual do agente.
  - log/
    - aliyun_assist_main.log — Arquivo de log ativo (dia atual).
    - aliyun_assist_main.log.YYYYMMDD — Logs arquivados (com rotação diária).
  - plugin/
    - ACS-ECS-SysInfoGatherer — Plugin pré-instalado para coleta de informações do sistema.
- cache/
  - state_configs.json — Configuração em cache para coleta de inventário do CloudOps Orchestration Service (OOS).
- config/
  - task_sign_certs/ — Chaves públicas para verificação de assinatura digital de tarefas.
- hybrid/
  - hardwareHash — Impressão digital de hardware para registro de instância gerenciada.
- plugin/
  - installed_plugins.db — Banco de dados de plugins instalados.
- work/
  - script/ — Diretório de preparação para scripts de execução.
    
    Nota
    A partir da versão 2.x.3.704, o Cloud Assistant não salva mais scripts de execução no disco por padrão; ative manualmente o recurso de salvamento de scripts e visualize os arquivos executados neste diretório.
- region-id — ID da região da instância.

Windows

O Cloud Assistant Agent fica instalado em C:\ProgramData\aliyun\assist\.

C:\ProgramData\aliyun\assist\
- 2.x.x.xxx/ — Diretório específico da versão (por exemplo, 2.1.4.965).
  - aliyun_assist_service.exe — Binário principal do agente.
  - acs-plugin-manager.exe — Utilitário de gerenciamento de plugins.
  - aliyun_assist_update.exe — Utilitário de atualização automática.
  - aliyun_installer.exe — Programa de instalação.
  - install.bat, install.exe — Scripts de instalação.
  - PatchGo.dll — Patch de runtime para o Windows Server 2008 que mitiga o desvio de relógio do Go.
  - version.ini — Configuração da versão do agente.
  - config/
    - GlobalSignRootCA.crt — Certificado raiz para comunicação HTTPS.
    - hash_file — Hashes criptográficos para verificação de integridade.
  - log/
    - aliyun_assist_main.log — Arquivo de log ativo (dia atual).
    - aliyun_assist_main.log.YYYYMMDD — Logs arquivados (com rotação diária).
  - plugin/
    - ACS-ECS-SysInfoGatherer — Plugin de coleta de informações do sistema.
    - SessionManager — Plugin de gerenciamento de sessões sem senha.
    - installed_plugins.db — Banco de dados de plugins instalados.
- cache/
  - state_configs.json — Configuração em cache para coleta de inventário do OOS.
- config/
  - task_sign_certs/ — Chaves públicas para verificação de assinatura de tarefas.
- hybrid/ — Dados de registro de instância gerenciada.
- plugin/
  - installed_plugins.db — Banco de dados de plugins.
- work/
  - script/ — Diretório de preparação para scripts de execução.
    
    Nota
    A partir da versão 2.x.3.704, o Cloud Assistant não salva mais scripts de execução no disco por padrão; ative manualmente o recurso de salvamento de scripts e visualize os arquivos executados neste diretório.
- config.ini — Configuração global, incluindo a versão atual do agente.
- region-id — ID da região da instância.
- version — Versão atual do agente.

Termos

Termo	Descrição
Cloud Assistant	O serviço. Disponível em todas as regiões da Alibaba Cloud.
Cloud Assistant Agent	O binário cliente em cada instância. Nome do processo: `aliyun-service` (Linux) ou `aliyun_assist_service` (Windows).
AssistDaemon	Um watchdog que monitora e reinicia o agente em caso de falha. Apenas Linux. Nome do serviço: `AssistDaemon`. Caminho: `/usr/local/share/assist-daemon/assist_daemon`.
Diretório de trabalho	O caminho onde os scripts são armazenados temporariamente (se o salvamento de scripts estiver ativado). Linux: `/tmp`. Windows: `<Cloud Assistant installation path>/work/script`.
Comando	O payload de operação enviado para uma instância. Tipos: Shell, PowerShell e Bat.
Parâmetro personalizado	Uma variável definida com a sintaxe `{{key}}`. Os valores são injetados em tempo de execução usando `{{"key":"value"}}`. Use parâmetros personalizados e crie modelos de comandos reutilizáveis para otimizar o uso em relação às cotas regionais. O Cloud Assistant também fornece parâmetros de ambiente integrados, preenchidos automaticamente em tempo de execução.
Execução única	Um único evento de execução em uma ou mais instâncias (também chamado de invocação).
Execução agendada	Um comando configurado para execução periódica com