产品概述
天翼云云助手(CT-CA, Cloud Assistant)是专门为云服务器打造的原生自动化运维工具,免密码、免登录、无需使用跳板机,即可批量执行命令(Shell、PowerShell、Bat、Python等),完成运行自动化运维脚本、轮询进程、安装卸载软件、启动或停止服务、安装补丁或安装安全更新等任务。
产品优势
批量执行命令
通过云助手,您能够以安全可靠的方式远程管理大规模的实例,无需登录服务器、使用堡垒主机或 SSH。
提供集成工具
云助手可作为运维部署工具,免费支持 API,可供集成。
查询历史记录
通过云助手执行的操作系统脚本命令,您可以查询到其历史记录信息。
实现自动化
您可以预先创建常用的操作命令,并通过云助手高效完成您的日常任务。例如:注册表编辑、用户管理、软件和补丁安装等。
应用场景
当您涉及以下业务场景时,可通过云助手快速实现需求:
- 上传并运行自动化运维脚本。
- 执行常见操作任务。
- 运行已保存的脚本。
- 批量安装软件或应用。
- 安装补丁或安全更新。
- 上传文件或证书到指定目录。
使用限制
云助手具备以下限制项:
- 2024年6月30日之后使用公共镜像创建的实例,默认已预装云助手客户端。若您的实例于2024年6月30日前购买,请参考 安装云助手客户端 进行安装。
- 单次执行命令实例数量上限为100。
- 云助手仅保存最近三个月的命令执行历史记录,且记录数量最大保存10万条。
- 创建的Bat、PowerShell、Python或者Shell脚本和自定义参数的使用场景与文件大小说明如下:
- 上传文件:文件大小不能超过24 KB。
- 创建命令:命令大小不能超过24 KB。
云主机只能在以下操作系统中运行云助手命令:
- Linux
- Windows
物理机只能在以下操作系统中运行云助手命令:
- Linux
资源占用
主机资源 | Linux操作系统 | Windows操作系统 |
---|---|---|
CPU | 平均CPU使用率不到1% | 平均CPU使用率不到1% |
物理内存 | 小于50 MB | 小于50 MB |
磁盘I/O | 平稳运行时几乎没有I/O,仅在下载升级安装包和保存命令脚本等场景下产生磁盘I/O | 平稳运行时几乎没有I/O,仅在下载升级安装包和保存命令脚本等场景下产生磁盘I/O |
网络I/O | 平稳运行时仅有心跳上报等数据产生的少量I/O | 平稳运行时仅有心跳上报等数据产生的少量I/O |
名词解释
云助手的常用名词及其具体描述如下表所示。
常见名词 | 说明 |
---|---|
云助手 | 云助手官方名称,可以帮您在弹性云主机或物理机实例上自动以及批量执行日常维护任务。 |
云助手Agent | 安装在弹性云主机或物理机实例中的轻量级插件,所有在实例中完成的命令都会通过云助手Agent执行。 |
命令执行路径 | 云助手会将用户的命令内容以文件形式先保存到实例上,然后再执行文件,具体默认保存路径如下: Windows默认保存路径:C:/Windows/System32/ Linux默认保存路径:/tmp/ |
命令 | 需要在实例中执行的具体命令操作,如一份Shell脚本或者PowerShell脚本。 |
单次执行 | 在一台或者多台实例中执行某个命令,即为一次执行(Invocation)。 |
命令执行状态
单条命令执行状态
API状态 | 状态显示 | 描述 |
---|---|---|
Pending | 下发中 | 系统正在校验或发送命令。 |
Running | 执行中 | 命令正在实例上运行。 |
Success | 执行成功 | 执行成功,退出码为0。 |
Failed | 执行失败 | 执行完成,退出码非0。 |
Openapi
欢迎使用云助手openapi,统一的参数风格和公共错误码,给您带来简单快捷的使用体验。
Openapi概览
接口名称 | 接口功能 | 频率限制(次/秒) |
---|---|---|
run-command | 执行命令 | 单用户20次/秒 |
describe-invocation-results | 查询命令执行结果 | 单用户20次/秒 |
create-command | 创建命令 | 单用户20次/秒 |
invoke-command | 触发命令 | 单用户20次/秒 |
get-commands | 查询已创建的或公共的命令 | 单用户20次/秒 |
get-command | 查询命令详情 | 单用户20次/秒 |
modify-command | 修改命令 | 单用户20次/秒 |
delete-command | 删除命令 | 单用户20次/秒 |
get-ca-agent | 查询实例中是否安装了云助手agent | 单用户60次/秒 |
send-file | 上转文件到实例 | 单用户20次/秒 |
describe-send-file-results | 查询文件上传结果 | 单用户20次/秒 |
常见问题
参考 云助手常见问题 。