本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# OpsWorks Stacks Agent CLI
<a name="agent"></a>

**重要**  
该 AWS OpsWorks Stacks 服务于 2024 年 5 月 26 日终止，新客户和现有客户均已禁用。我们强烈建议客户尽快将其工作负载迁移到其他解决方案。如果您对迁移有疑问，请通过 re [AWS : Post 或通过 Pre](https://repost.aws/) mium Su [AWS pp](https://aws.amazon.com/support) ort 与 AWS 支持 团队联系。

**注意**  
此功能仅适用于 Linux 实例。

 OpsWorks Stacks 在每个实例上安装的代理会公开命令行界面 (CLI)。如果您[使用 SSH 登录](workinginstances-ssh.md)到实例，就可以使用该 CLI 完成以下工作：
+ 访问 Chef run 的日志文件。
+ 访问 OpsWorks 堆栈命令。
+ 手动运行 Chef 配方。
+ 查看实例报告。
+ 查看代理报告。
+ 查看一组有限的堆栈配置和部署属性。

**重要**  
只能以根用户身份或使用 `sudo` 运行代理 CLI 命令。

基本的命令语法是：

```
sudo opsworks-agent-cli [--help] [command [activity] [date]]
```

四个参数如下：

**help**  
(可选) 单独使用时显示可用命令的简短概要。与一条命令结合使用时，`help` 显示该命令的说明。

**command**  
(可选) 代理 CLI 命令，必须设置为以下值之一：  
+ [agent\$1report](agent-report.md)
+ [get\$1json](agent-json.md)
+ [instance\$1report](agent-instance.md)
+ [list\$1commands](agent-list.md)
+ [run\$1command](agent-run.md)
+ [show\$1log](agent-show.md)
+ [stack\$1state](agent-stack.md)

**活动**  
（可选）用作某些命令的参数来指定特定的 OpsWorks Stacks 活动：`setup`、`configure`、`deploy`、`undeploy`、`start`、`stop` 或 `restart`。

**date**  
(可选) 用作某些命令的参数来指定特定的 OpsWorks Stacks 命令执行。通过将**日期**设置为以*yyyy-mm-ddThh:mm:ss*格式（包括单引号）执行命令的时间戳来指定命令的执行。例如，对于 2013 年 2 月 5 日星期二 10:31:55，使用：`'2013-02-05T10:31:55'`。要确定何时执行特定 OpsWorks Stacks 命令，请运行[list\$1commands](agent-list.md)。

**注意**  
如果代理多次执行同一 OpsWorks Stacks 活动，则可以通过指定活动及其执行时间来选择特定的执行。如果您指定了活动而省略了时间，则代理 CLI 命令作用于活动的最近一次执行。如果同时省略这两个参数，则代理 CLI 命令作用于最近的活动。

下列部分描述命令以及其相关参数。为简便起见，语法部分省略了可选的 `--help` 选项，该选项可与任何命令结合使用。

**Topics**
+ [agent\$1report](agent-report.md)
+ [get\$1json](agent-json.md)
+ [instance\$1report](agent-instance.md)
+ [list\$1commands](agent-list.md)
+ [run\$1command](agent-run.md)
+ [show\$1log](agent-show.md)
+ [stack\$1state](agent-stack.md)