Crie comandos reutilizáveis do Cloud Assistant para automatizar tarefas de O&M em instâncias ECS sem precisar fazer login.
Tipos de comando compatíveis:
|
SO |
Tipos compatíveis |
|
Linux |
Shell, Python, Perl |
|
Windows |
Bat, PowerShell |
Limitações
|
Recurso |
Limite |
|
Comandos por região |
500–50.000 (cota por conta; pode aumentar conforme o uso do ECS) |
|
Tamanho máximo do script codificado em Base64 |
18 KB |
|
Parâmetros personalizados por comando |
20 |
Para visualizar ou aumentar sua cota, consulte Gerenciar cotas. Inclua uma justificativa detalhada na solicitação para aumentar as chances de aprovação.
Pré-requisitos
Verifique os seguintes requisitos:
Uma conta Alibaba Cloud com acesso ao ECS.
(Opcional) Um grupo de recursos para gerenciar permissões de comando no nível do grupo de recursos com o RAM.
Criar um comando no console ECS
Não inclua informações confidenciais — como pares AccessKey, senhas ou códigos de autorização — como texto simples nos comandos. Use parâmetros personalizados no formato {{key}} e forneça os valores durante a execução.
Acesse a página do Cloud Assistant do ECS.
-
Na barra de navegação superior, selecione uma região e um grupo de recursos.
Os grupos de recursos permitem gerenciar permissões de comando com políticas do RAM. Consulte Exemplos de políticas personalizadas específicas para comandos do Cloud Assistant e Classificar recursos em grupos de recursos e conceder permissões nos grupos de recursos .

Na página ECS Cloud Assistant, clique em Create/Run Command.
-
Na seção Command Information, configure o comando. Command type: Selecione o tipo correspondente ao SO da instância de destino. Command content: Insira ou cole o comando. Verifique a sintaxe, a lógica e o algoritmo antes de salvar. Exemplo: arquivar um arquivo em
/backupem uma instância Linux:Run at Fixed Interval: Defina um intervalo (de 60 segundos a 7 dias) usando uma expressão de taxa. O intervalo representa o tempo entre execuções consecutivas, não a duração da execução. Por exemplo, um intervalo de 5 minutos com uma execução de 2 minutos significa que a próxima execução começa 3 minutos após o término da anterior. A primeira execução inicia após o intervalo decorrido desde a criação da tarefa. > Note: O intervalo deve ser maior que o tempo limite do comando.
Run Only Once at Specified Time: Defina data, hora e fuso horário. Exemplo: May 17, 2022, 17:30:50 com (GMT+08:00) Asia/Shanghai.
Run on Clock-based Schedule Cron Expression: Especifique uma expressão cron (com precisão de segundos) e um fuso horário. Intervalo mínimo: 10 segundos (deve exceder o período de tempo limite). Exemplo:
0 0 12 ? * WED 2022com (GMT+08:00) Asia/Shanghai executa todas as quartas-feiras às 12:00:00 em 2022. Consulte Expressões Cron.
Requisitos de versão: -
{{ACS::InstanceId}}e{{ACS::InstanceName}}: Cada instância de destino deve executar a versão mínima do Cloud Assistant Agent listada acima. -{{ACS::InvokeId}}: Requer a versão mínima do Agent listada acima. -{{ACS::CommandId}}: Ao chamar a API RunCommand , requer a versão mínima do Agent listada acima. Para atualizar, consulte Instalar o Cloud Assistant Agent .Command source
Opção
Descrição
Enter Command Content
Escreva um novo comando.
Select Saved Command
Use um comando salvo existente.
Parâmetro
Descrição
Versão mínima do Cloud Assistant Agent
{{ACS::RegionId}}ID da região
—
{{ACS::AccountId}}UID da conta Alibaba Cloud
—
{{ACS::InstanceId}}ID da instância
Linux >= 2.2.3.309, Windows >= 2.1.3.309
{{ACS::InstanceName}}Nome da instância
Linux >= 2.2.3.344, Windows >= 2.1.3.344
{{ACS::InvokeId}}ID da tarefa de comando
Linux >= 2.2.3.309, Windows >= 2.1.3.309
{{ACS::CommandId}}ID do comando
Linux >= 2.2.3.309, Windows >= 2.1.3.309
Execution plan
Opção
Comportamento
Immediate execution
Executado ao clicar em Run ou Run and Save.
After the next startup of the system
Executado na próxima inicialização das instâncias associadas.
After each system startup
Executado sempre que as instâncias associadas forem iniciadas.
Run on Schedule
Executado conforme um cronograma definido. Veja as opções abaixo.
Other parameters
Parâmetro
Descrição
Command Name
Nome para identificar o comando.
Command Description
Descrição da finalidade do comando.
Username
Usuário do SO que executará o comando. Padrão:
root(Linux),system(Windows). Use os privilégios mínimos necessários. Consulte Executar comandos do Cloud Assistant como um usuário comum.Execution Path
Diretório de trabalho. Padrão:
/home(Linux),C:\Windows\system32(Windows).Timeout
Tempo máximo de execução em segundos. Padrão: 60. Mínimo: 10 (valores inferiores a 10 são ajustados para 10).
Tag
Par chave-valor para classificação. A opção Run and Save aplica a tag tanto ao comando quanto à tarefa de execução. A opção Run aplica a tag apenas ao comando.
#!/bin/bash OF=/backup/my-backup-$(date +%Y%m%d).tgz tar -cf $OF {{file}}{{file}}é um parâmetro personalizado. Defina-o durante a execução (por exemplo,/app/usrcredential). Consulte Visualizar as configurações do sistema das instâncias ECS. Use parameters: Ative Use Parameters para definir parâmetros personalizados no formato{{key}}. São permitidos até 20 parâmetros personalizados por comando. O Cloud Assistant também fornece parâmetros de ambiente integrados resolvidos em tempo de execução. Opções de Run on Schedule: -
Em Select Instance e Select Managed Instances, selecione as instâncias de destino.
Uma instância gerenciada é um servidor não-ECS administrado pelo Cloud Assistant. Consulte Instâncias gerenciadas pela Alibaba Cloud .
Clique em Save.
Criar um comando usando a Alibaba Cloud CLI
Chame CreateCommand para criar um comando. O exemplo a seguir cria um comando chamado update que atualiza o SO em instâncias Linux.
aliyun ecs CreateCommand --RegionId 'cn-hangzhou' \
--CommandContent 'eXVtIHVwZGF0ZSAteQ==' \
--Type 'RunShellScript' \
--Name 'update' \
--Description 'update' \
--output cols=CommandId
Substitua os valores entre aspas simples pelos seus valores reais.
Principais parâmetros:
|
Parâmetro |
Exemplo |
Descrição |
|
|
|
A região. |
|
|
|
O nome do comando. |
|
|
|
O tipo de comando: |
|
|
|
O conteúdo do comando codificado em Base64. |
|
|
|
A descrição do comando. |
Para a referência completa de parâmetros, consulte CreateCommand.
Resposta de exemplo:
CommandId
---------
c-hz018qng4on****
Próximos passos
Após criar um comando, visualize-o na aba My Commands. Para executá-lo em instâncias específicas, consulte Executar um comando.
Se você ativou a opção Use Parameters , insira os valores dos parâmetros em Command Parameters ao executar o comando.