AWS OpsWorks スタックエージェント CLI

重要

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

注記

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

AWS OpsWorks スタックがすべてのインスタンスにインストールするエージェントは、コマンドラインインターフェイス (CLI) を公開します。SSH を使用してインスタンスにログインすると、CLI を使用して次の操作を実行できます。

• Chef 実行のログファイルにアクセスする。

• AWS OpsWorks スタックコマンドにアクセスします。

• Chef レシピを手動で実行する。

• インスタンスレポートを表示する。

• エージェントレポートを表示する。

• スタック設定およびデプロイ属性の制限されたセットを表示する。

重要

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

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

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

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

help (ヘルプ)

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

コマンド

(オプション) エージェント CLI コマンド。次のいずれかに設定する必要があります。

• agent_report

• get_json

• instance_report

• list_commands

• run_command

• show_log

• stack_state

activity

(オプション) 一部のコマンドで引数として使用して、 AWS OpsWorks スタックの特定のアクティビティ (setup、configure、deploy、undeploy、start、stop、restart のいずれか) を指定します。

date

(オプション) 一部のコマンドで引数として使用して、特定の AWS OpsWorks スタックコマンドの実行を指定します。単一引用符を含む yyyy-mm-ddThh:mm:ss 形式でコマンドが実行されたタイムスタンプに日付を設定して、コマンドの実行を指定します。たとえば、2013 年 2 月 5 日火曜日 10 時 31 分 55 秒の場合、'2013-02-05T10:31:55' を使用します。特定の AWS OpsWorks Stacks コマンドがいつ実行されたかを確認するには、 を実行します list_commands。

注記

エージェントが同じ AWS OpsWorks スタックアクティビティを複数回実行した場合は、アクティビティと実行時刻の両方を指定して、特定の実行を選択できます。アクティビティを指定し、時刻を省略すると、エージェント CLI コマンドはそのアクティビティの最新の実行に適用されます。両方の引数を省略すると、エージェント CLI コマンドは最新のアクティビティに適用されます。

以下のセクションでは、各コマンドと関連する引数について説明します。簡潔に示すために、構文セクションでは、どのコマンドでも使用できる省略可能な --help オプションを省略しています。

トピック

• agent_report
• get_json
• instance_report
• list_commands
• run_command
• show_log
• stack_state