

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# OpsWorks スタックエージェント CLI
<a name="agent"></a>

**重要**  
この AWS OpsWorks Stacks サービスは 2024 年 5 月 26 日にサポート終了となり、新規および既存のお客様の両方で無効になっています。できるだけ早くワークロードを他のソリューションに移行することを強くお勧めします。移行についてご質問がある場合は、[AWS re:Post](https://repost.aws/) または[AWS プレミアムサポート](https://aws.amazon.com/support)を通じて AWS サポート チームにお問い合わせください。

**注記**  
この機能は、Linux インスタンスでのみご利用いただけます。

 OpsWorks スタックがすべてのインスタンスにインストールするエージェントは、コマンドラインインターフェイス (CLI) を公開します。[SSH を使用してインスタンスにログイン](workinginstances-ssh.md)すると、CLI を使用して次の操作を実行できます。
+ Chef 実行のログファイルにアクセスする。
+  OpsWorks スタックコマンドにアクセスします。
+ Chef レシピを手動で実行する。
+ インスタンスレポートを表示する。
+ エージェントレポートを表示する。
+ スタック設定およびデプロイ属性の制限されたセットを表示する。

**重要**  
エージェント CLI コマンドは、root として実行するか、`sudo` を使用して実行します。

基本的なコマンド構文は次のとおりです。

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

4 つの引数は次のとおりです。

**help**  
(オプション) 単独で使用した場合は、使用可能なコマンドの簡単な概要が表示されます。コマンドと共に `help` を使用した場合は、そのコマンドの説明が表示されます。

**コマンド**  
(オプション) エージェント 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 スタックの特定のアクティビティ (`setup`、`configure`、`deploy`、`undeploy`、`start`、`stop`、`restart` のいずれか) を指定します。

**date**  
(オプション) 一部のコマンドで引数として使用して、特定の OpsWorks スタックコマンドの実行を指定します。コマンドの実行を指定するには、**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 スタックアクティビティを複数回実行した場合は、アクティビティと実行時刻の両方を指定して、特定の実行を選択できます。アクティビティを指定し、時刻を省略すると、エージェント 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)