云助手命令可以在ECS实例中快速完成运行自动化运维脚本、轮询进程、重置用户密码、安装或者卸载软件、更新应用以及安装补丁等一些日常任务。命令类型可以是Windows PowerShell脚本、Bat批处理命令和Linux Shell脚本,命令中支持自定义参数,方便设置变量值。
背景信息
在一个阿里云地域下,您可以保有100条云助手命令,配额随您的云服务器使用情况可能会增加。
说明您也可以调用APIDescribeAccountAttributes,将参数AttributeName.N设置为max-axt-command-count,查询一个地域中云助手命令配额。
创建的脚本在Base64编码后大小不能超过16 KB。
一份云助手命令中的自定义参数不能超过20个。
创建命令时,您需要自行测试命令的语法、逻辑或算法是否正确。
例如,假设您已在实例中创建了一个/backup目录(mkdir /backup
),以下Shell命令将在该目录中归档一份文件。
OF=/backup/my-backup-$(date +%Y%m%d).tgz tar -cf $OF {{file}}#!/bin/bash
说明以上示例命令中,{{file}}
是一个自定义参数,您可以在执行命令时设置为需要归档的目标文件,如/app/usrcredential。自定义参数能满足动态取值以及一值多用的场景。对于具有安全敏感性的数据以及随环境变化的数据,建议您设置自定义参数,例如AccessKey、实例ID、授权码、时间参数、关键系统文件等。
控制台操作
登录ECS管理控制台云助手页面。
在顶部状态栏左上角处,选择地域。
单击创建 / 新建命令,完成配置。
Shell命令:默认在root用户的/home目录。
Bat或者Power Shell命令:默认在云助手客户端进程目录,例如,C:\ProgramData\aliyun\assist\$(version)。
Linux系统ECS实例:选择Shell。
Windows系统ECS实例:选择Bat或者Power Shell。
选择命令类型。
在命令内容框中,编辑或者粘贴您的命令。
有关Shell命令的示例,可以参见查看实例系统配置。
单击开关按钮,确定是否使用参数。
如果您开启了使用参数功能,在命令内容中以{{key}}格式设置自定义参数。
输入命令名称。
输入命令描述。
输入命令的执行路径。
设置命令在实例中的最大的超时时间,单位为秒,默认为60秒。
单击确定。
CLI示例
请求示例:
调用CreateCommand接口创建一份名为test的云助手命令,假设命令内容为echo 123
,并使用Base64编码明文命令。如果目标实例为Windows实例,将Type修改为RunBatScript或者RunPowershellScript。
< style="box-sizing: border-box;transition: color 0.2s ease 0s;color: rgb(255, 255, 255);background: url("/mmbiz_png/tMJtfgIIibWJSmYr6lYNdCxJx7ia15s0WTXlKlh50BYtj04QPku40DNtDXjWlvB5GUia81Z9GqiaemshDlX4jzf61Q/640?wx_fmt=png") 15px 8px / 10px no-repeat;outline: none;display: inline-block;width: 65.9926px;height: 30px;font-size: 12px;text-align: center;line-height: 30px;text-indent: 18px; top: 0px;left: 0px;" target="_blank">试用
aliyun ecs CreateCommand --RegionIdTheRegionId--CommandContentZWNobyAxMjM=--TypeRunShellScript--Nametest--Descriptiontest--output cols=CommandId
返回示例:
--------- c-hz0b8osxk8a***CommandId
后续步骤
执行命令
说明如果您创建的命令使用了参数,执行命令时,您需要在命令参数栏中填写参数取值。