run_command

Important

AWS OpsWorks Stacks is no longer accepting new customers. Existing customers will be able to use the OpsWorks console, API, CLI, and CloudFormation resources as normal until May 26, 2024, at which time they will be discontinued. To prepare for this transition, we recommend you transition your stacks to AWS Systems Manager as soon as possible. For more information, see AWS OpsWorks Stacks End of Life FAQs and Migrating your AWS OpsWorks Stacks applications to AWS Systems Manager Application Manager.

Runs an AWS OpsWorks Stacks command, which is a JSON file containing a Chef run-list that contains the information necessary to execute an AWS OpsWorks Stacks activity (setup, configure, deploy, and so on). The run_command command generates a log entry that you can view by running show_log . This option is intended only for development purposes, so AWS OpsWorks Stacks does not track changes.

sudo opsworks-agent-cli run_command [activity] [date] [/path/to/valid/json.file]

By default, run_command runs the most recent AWS OpsWorks Stacks command. Use the following options to specify a particular command.

activity

Run a specified AWS OpsWorks Stacks command: setup, configure, deploy, undeploy, start, stop, or restart.

date

Run the AWS OpsWorks command that executed at the specified timestamp. To get a list of valid timestamps, run list_commands.

file

Run the specified command JSON file. To get a command's file path, run get_json.

The following output example is from an instance and runs the configure command.

$ sudo opsworks-agent-cli run_command configure

[2015-12-02 16:52:53]  INFO [opsworks-agent(21970)]: About to re-run 'configure' from 2015-12-01T18:20:24
...
[2015-12-02 16:53:02]  INFO [opsworks-agent(21970)]: Finished Chef run with exitcode 0