本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# OpsWorks Stacks 代理程式 CLI
<a name="agent"></a>

**重要**  
 AWS OpsWorks Stacks 此服務已於 2024 年 5 月 26 日終止，並已針對新客戶和現有客戶停用。我們強烈建議客戶盡快將其工作負載遷移至其他解決方案。如果您對遷移有任何疑問，請透過 [AWS re：Post](https://repost.aws/) 或透過 [AWS Premium Support](https://aws.amazon.com/support) 聯絡 AWS 支援 團隊。

**注意**  
此功能只適用於 Linux 執行個體。

 OpsWorks Stacks 在每個執行個體上安裝的代理程式會公開命令列界面 (CLI)。如果您[使用 SSH 登入](workinginstances-ssh.md)執行個體，則可以使用 CLI 執行下列作業：
+ 存取 Chef 執行的日誌檔案。
+ 存取 OpsWorks Stacks 命令。
+ 手動執行 Chef 配方。
+ 檢視執行個體報告。
+ 檢視代理程式報告。
+ 檢視一組有限的堆疊組態和部署屬性。

**重要**  
您只能以 root 身分或透過使用 `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)

**activity**  
(選用) 做為某些命令的引數時可指定特定 OpsWorks Stacks 活動：`setup`、`configure`、`deploy`、`undeploy`、`start`、`stop` 或 `restart`。

**date**  
(選用) 做為某些命令的引數時可指定特定 OpsWorks Stacks 命令執行。透過將 **date** 設為執行命令的時間戳記，並使用 *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)