操作场景
本文介绍如何使用自动化助手执行命令，实现实例管理。
操作步骤：
命令执行完成后，在命令列表页面单击命令所在行右侧的日志，进入日志详情页面查看命令执行结果。
查看命令执行状态步骤：
操作步骤：
步骤1：登录控制台
登录 轻量应用服务器控制台，在左侧导航栏选择自动化助手 > 命令列表。
步骤2：创建命令
在命令列表页面中，单击创建命令。
在弹出的创建命令窗口中，参考下表设置参数。
说明：
每个地域下最多可创建500个命令。窗口顶部会显示当前已创建命令数量及上限。
|
参数
|
说明
|
|
命令名称
|
设置命令名称。名称仅支持中文、英文、数字、下划线、分隔符
-、小数点，最大长度不超过60个字符。 |
|
命令类型
|
按需选择命令类型。可选项：
|
SHELL：适用于 Linux 实例。
POWERSHELL：适用于 Windows 实例。
|
BAT：适用于 Windows 实例。
|
|
|
执行路径
|
自定义命令的执行路径。
|
Linux 实例默认路径为 root 用户的
/home 目录。|
Windows 实例默认路径为 System 权限的
C:\Program Files\qcloud\tat_agent\workdir 目录。 |
|
|
执行用户
|
自定义执行命令的用户。
|
Linux 实例默认为 root 用户。
|
Windows 实例默认为 System 用户。
|
|
|
超时时间
|
设置命令在实例中的超时时间，当执行命令的任务超时后，自动化助手将强制终止任务进程。单位为秒，默认为60秒，取值范围为
[1, 86400]。 |
|
执行记录上传
|
开启后，命令执行记录将上传至对象存储 COS。上传功能本身免费，但 COS 可能产生费用，详情请参见 对象存储 COS 计费说明。
|
|
命令内容
|
编辑或者粘贴您的命令。您也可单击试试用 AI 帮助生成命令，通过 AI 辅助生成命令内容。
|
|
使用参数
|
开启后，可在命令中设置变量值，以
{{key}} 的形式表示。执行命令时，可为变量传入实际值。 |
|
标签
|
可选。为命令添加标签，便于分类管理。支持输入键值对或从键值粘贴板选择。
|
单击确定即可创建命令。
步骤3：执行命令
说明：
使用自动化助手在实例上执行命令，指定的实例需要处于 VPC 网络。
在命令列表页面中，选择所需执行命令所在行右侧的执行。
在执行命令界面的选择执行实例下拉列表中选择需执行命令的实例。
单击执行命令即可执行命令。
命令执行完成后，在命令列表页面单击命令所在行右侧的日志，进入日志详情页面查看命令执行结果。
查看命令执行状态步骤：
操作场景
本文介绍通过登录实例或轻量应用服务器控制台两种查看自动化助手命令执行状态的方法，您可按需选择一种方法查看命令的执行状态信息。命令的所有执行状态信息，请参考以下表格。
|
API 返回信息
|
状态显示
|
描述
|
|
PENDING
|
等待下发
|
命令正在等待系统下发。
|
|
DELIVERING
|
下发中
|
命令正在下发给选择执行的实例。
|
|
DELIVER_DELAYED
|
延时下发
|
命令下发延时。
|
|
DELIVER_FAILED
|
下发失败
|
命令下发失败。
|
|
RUNNING
|
执行中
|
命令正在被执行。
|
|
TIMEOUT
|
命令超时
|
命令未在设置超时时间内执行完成。
|
|
SUCCESS
|
命令成功
|
命令执行完成，执行完成仅表示自动化助手已经执行完所有任务，不代表所有命令执行结果都符合预期，您需要根据命令执行结果中的实际输出信息（Output）及退出码（ExitCode）查看命令是否按预期执行。
|
|
TASK_TIMEOUT
|
命令超时
|
命令执行超时自动终止持续执行的任务。
|
|
FAILED
|
命令失败
|
命令无法被执行，或者执行失败。
|
操作步骤
方法1：登录实例查看
请根据您实际使用的操作系统，进行查看：
Linux 系统：
登录实例，详情请参见 使用 OrcaTerm 登录 Linux 实例（推荐）。
执行以下命令，获取 agent 运行日志。
vim /usr/local/qcloud/tat_agent/log/tat_agent.log
Windows 系统：
登录实例，详情请参见 使用 VNC 方式登录 Windows 实例。
在 C:\Program Files\QCloud\tat_agent\log 下，查看 agent 的运行日志。
对比 命令执行状态，获取当前的命令执行状态信息。
方法2：通过控制台查看
登录 轻量应用服务器控制台。
在服务器列表中，找到并进入目标实例的详情页。
选择执行命令页签，并单击命令所在行右侧的查看执行详情。如下图所示：
