Run Cloud Assistant common commands - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Contexto

Os comandos comuns são comandos do Cloud Assistant criados e mantidos pela Alibaba Cloud. Eles consistem em scripts ou plugins do Cloud Assistant para tarefas como configuração de servidores, verificações de integridade e segurança, instalação de aplicativos, gerenciamento de arquivos, instalação de patches e gerenciamento de services.

Diferentemente dos comandos personalizados, a Alibaba Cloud gerencia os comandos comuns. Você pode visualizar detalhes, executá-los em instâncias ECS e acompanhar o progresso e os resultados. Por exemplo, é possível atualizar o Cloud Assistant Agent em uma instância Linux, instalar Java ou diagnosticar a necessidade de redimensionamento de disco com um único clique.

Procedimento

Visualize e execute comandos comuns usando um dos métodos a seguir.

ECS console

Acesse o ECS console - Cloud Assistant.
No canto superior esquerdo da página, selecione uma região e um grupo de recursos.
Na página ECS Cloud Assistant, clique na aba Common Commands.

Esta aba lista todos os comandos comuns disponíveis.
Localize o comando desejado e clique em Run.

Nota
Apenas a versão mais recente de cada comando é exibida. Para visualizar ou executar uma versão anterior, clique no ID do comando para abrir a página de detalhes.

No painel Run Command, configure os parâmetros e clique em Run.

Principais parâmetros:

Seção	Parâmetro	Descrição
Command Information	Conteúdo do comando	Clique em View command content para verificar o comando.
	Plano de execução	Selecione um plano de execução. Opções: Immediate execution After the next startup of the system After each system startup Timing execution Consulte Execution plan details.
	Executar como	Conta de usuário usada para executar o comando, por exemplo, root. Por padrão, os comandos são executados como usuário `root` em instâncias Linux e como usuário `System` em instâncias Windows.
	Tempo limite	Tempo limite para execução do comando, em segundos. Valores válidos: 10 a 86.400 (24 horas). Se a execução exceder esse tempo, o Cloud Assistant encerra o processo forçadamente. Padrão: o tempo limite definido no próprio comando.
	Parâmetros do comando	Se a seção Parâmetros do Comando for exibida, insira os valores personalizados. Os parâmetros disponíveis variam conforme o comando. Nota Se o provedor do comando especificar descrições, valores padrão ou valores permitidos para os parâmetros, preencha-os conforme solicitado. Preencha os parâmetros obrigatórios para executar o comando.
Select Instances	-	Selecione uma ou mais instâncias para executar o comando. As instâncias devem estar no status Running e com o Cloud Assistant Agent instalado.
Select Managed Instances	-	Escolha as instâncias gerenciadas para executar o comando. Essas instâncias precisam estar no status Connected e com o Cloud Assistant Agent instalado. Nota Instâncias gerenciadas são servidores fora da Alibaba Cloud administrados pelo Cloud Assistant. Consulte managed instances.

Nota

Para obter detalhes sobre todos os parâmetros, consulte Run a command from the console.

Na aba Command execution result, localize o comando executado e clique em View na coluna Actions.

Se o Status da Execução for Execution complete, você poderá visualizar a saída do comando.

A página de detalhes da execução mostra que o ExitCode é 0 e a saída do comando contém argusagent start success!, indicando que o agente do Cloud Monitor foi instalado com sucesso.

Nota
Se o comando falhar, verifique a mensagem de erro e solucione o problema. Consulte Common errors and troubleshooting.

OpenAPI

Visualize os comandos comuns.

Chame a operação DescribeCommands para listar os comandos comuns. Também é possível consultar pelo nome do comando.

Parâmetros principais:
- Name: Nome do comando. Por exemplo, defina como ACS-ECS-DiskResize-Diagnostic-for-linux.sh para consultar esse comando em uma região específica.
- Provider: Provedor do comando. Defina como AlibabaCloud para retornar todos os comandos comuns.
Execute um comando comum.

Com base no CommandId retornado na Etapa 1, chame a operação InvokeCommand. Você também pode executar um comando comum pelo nome. Os nomes dos comandos são consistentes entre regiões.

Parâmetro principal:

CommandId: O ID do comando. Para comandos comuns, este campo pode ser definido com o nome do comando. Exemplo: ACS-ECS-DiskResize-Diagnostic-for-linux.sh.

Uma chamada bem-sucedida retorna um InvokeId (por exemplo, t-hz02kwqc9pg****), que corresponde ao ID da execução. Chame DescribeInvocations ou DescribeInvocationResults para consultar o resultado.

Também é possível verificar a saída na página de detalhes da execução para confirmar se a instância precisa de redimensionamento de disco.

Alibaba Cloud CLI

Liste comandos comuns com a Alibaba Cloud CLI.

Execute o comando describe-commands para visualizar os comandos comuns.
- Defina --provider como AlibabaCloud para retornar todos os comandos comuns.
- Configure o provedor com um valor específico para retornar apenas os comandos desse fornecedor.
  
  Consulte todos os comandos comuns na região China (Hangzhou):
```
aliyun ecs DescribeCommands \
--region 'cn-hangzhou' \
--Provider 'AlibabaCloud'
```
  Consulte o comando ACS-ECS-DiskResize-Diagnostic-for-linux.sh, que diagnostica se uma instância Linux requer redimensionamento de disco:
```
aliyun ecs DescribeCommands \
--region 'cn-hangzhou' \
--CommandId 'ACS-ECS-DiskResize-Diagnostic-for-linux.sh'
```
Execute um comando comum com a Alibaba Cloud CLI.

Use o comando InvokeCommand para executar um comando comum em uma ou mais instâncias ECS.

Diagnostique se uma instância Linux precisa de redimensionamento de disco:
```
aliyun ecs InvokeCommand --RegionId 'cn-hangzhou' \
--InstanceId.1 'i-bp1f4f6o8lv0wqof****' \
--InstanceId.2 'i-bp137qu6142s3mhm****' \
--CommandId 'ACS-ECS-DiskResize-Diagnostic-for-linux.sh' \
--Timed 'false'
```
Uma chamada bem-sucedida retorna um InvokeId (exemplo: t-hz03rj5u0jx****), que representa o ID da execução. Execute DescribeInvocations ou DescribeInvocationResults para obter o resultado. Exemplo:
```
aliyun ecs DescribeInvocations --RegionId 'cn-hangzhou' \
--InvokeId 't-hz03rj5u0jx****'
```
Alternativamente, visualize a saída na página de detalhes da execução para verificar a necessidade de redimensionamento do disco na instância.

Referências

Use as operações de API a seguir para visualizar e gerenciar comandos do Cloud Assistant:

DescribeCommands: Consulta comandos do Cloud Assistant criados por você ou comandos comuns fornecidos pela Alibaba Cloud.
InvokeCommand: Executa um comando do Cloud Assistant em uma ou mais instâncias ECS.
StartInstance: Inicia uma instância ECS.
DescribeCloudAssistantStatus: Verifica se o Cloud Assistant Agent está instalado em uma ou mais instâncias.
InstallCloudAssistant: Instala o Cloud Assistant Agent em uma ou mais instâncias ECS.
DescribeInvocations: Consulta registros de execução e status de comandos do Cloud Assistant.
DescribeInvocationResults: Visualiza resultados da execução de comandos do Cloud Assistant nas instâncias ECS de destino.