**To deploy apps and run stack commands**

The following examples show how to use ``create-deployment`` to deploy apps and run stack commands.  Notice that the
quote (``"``) characters in the JSON object that specifies the command are all escaped. Otherwise, the command might
return an invalid JSON error.

**Deploy an App**

The following ``create-deployment`` command deploys an app to a specified stack::

  aws opsworks --region us-east-1 create-deployment --stack-id cfb7e082-ad1d-4599-8e81-de1c39ab45bf --app-id 307be5c8-d55d-47b5-bd6e-7bd417c6c7eb --command "{\"Name\":\"deploy\"}"

**Note**: OpsWorks CLI commands should set the region to *us-east-1*, regardless of the stack's location.

Output::

  {
    "DeploymentId": "5746c781-df7f-4c87-84a7-65a119880560"
  }

**Deploy a Rails App and Migrate the Database**

The following ``create-deployment`` command deploys a Ruby on Rails app to a specified stack, and also migrates the
database::

  aws opsworks --region us-east-1 create-deployment --stack-id cfb7e082-ad1d-4599-8e81-de1c39ab45bf --app-id 307be5c8-d55d-47b5-bd6e-7bd417c6c7eb --command "{\"Name\":\"deploy\", \"Args\":{\"migrate\":[\"true\"]}}"

**Note**: OpsWorks CLI commands should set the region to us-east-1, regardless of the stack's location.

Output::

  {
    "DeploymentId": "5746c781-df7f-4c87-84a7-65a119880560"
  }

For more information on deployment, see `Deploying Apps`_ in the *OpsWorks User Guide*.

**Execute a Recipe**

The following ``create-deployment`` command runs a custom recipe, ``phpapp::appsetup``, on the instances in a specified
stack.::

  aws opsworks --region us-east-1 create-deployment --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --command "{\"Name\":\"execute_recipes\", \"Args\":{\"recipes\":[\"phpapp::appsetup\"]}}

Output::

  {
    "DeploymentId": "5cbaa7b9-4e09-4e53-aa1b-314fbd106038"
  }

For more information, see `Run Stack Commands`_ in the *OpsWorks User Guide*.

**Install Dependencies**

The following ``create-deployment`` command installs dependencies such as packages or Ruby gems on the instances in a
specified stack.::

  aws opsworks --region us-east-1 create-deployment --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --command "{\"Name\":\"install_dependencies\"}"

Output::

  {
    "DeploymentId": "aef5b255-8604-4928-81b3-9b0187f962ff"
  }

For more information, see `Run Stack Commands`_ in the *OpsWorks User Guide*.

.. _`Deploying Apps`: http://docs.aws.amazon.com/opsworks/latest/userguide/workingapps-deploying.html
.. _`Run Stack Commands`: http://docs.aws.amazon.com/opsworks/latest/userguide/workingstacks-commands.html

