AWS CodeDeploy
User Guide (API Version 2014-10-06)

Create an EC2/On-Premises Compute Platform Deployment (CLI)

To use the AWS CLI to deploy a revision to the EC2/On-Premises compute platform:

  1. After you have prepared the instances, created the application, and pushed the revision, do one of the following:

  2. Call the create-deployment command, specifying:

    • An application name. To view a list of application names, call the list-applications command.

    • An Amazon EC2 deployment group name. To view a list of deployment group names, call the list-deployment-groups command.

    • Information about the revision to be deployed:

      For revisions stored in Amazon S3:

      • The Amazon S3 bucket name that contains the revision.

      • The name and file type of the uploaded revision.


        The tar and compressed tar archive file formats (.tar and .tar.gz) are not supported for Windows Server instances.

      • (Optional) The Amazon S3 version identifier for the revision. (If the version identifier is not specified, AWS CodeDeploy uses the most recent version.)

      • (Optional) The ETag for the revision. (If the ETag is not specified, AWS CodeDeploy skips object validation.)

      For revisions stored in GitHub:

      • The GitHub user or group name assigned to the repository that contains the revision, followed by a forward slash (/), followed by the repository name.

      • The commit ID for the revision.

    • (Optional) The name of a deployment configuration to use. To view a list of deployment configurations, call the list-deployment-configs command. (If not specified, AWS CodeDeploy uses a specific default deployment configuration.)

    • (Optional) Whether you want the deployment to an instance to continue to the BeforeInstall deployment lifecycle event if the ApplicationStop deployment lifecycle event fails.

    • (Optional) A description for the deployment.

    • For blue/green deployments, information about the instances that belong to the replacement environment in a blue/green deployment, including the names of one or more Auto Scaling groups, or the tag filter key, type, and value used to identify Amazon EC2 instances.


Use this syntax as part of the create-deployment call to specify information about a revision in Amazon S3 directly on the command line. (The version and eTag are optional.)

--s3-location bucket=string,key=string,bundleType=tar|tgz|zip,version=string,eTag=string

Use this syntax as part of the create-deployment call to specify information about a revision in GitHub directly on the command line:

--github-location repository=string,commitId=string

To get information about revisions that have been pushed already, call the list-application-revisions command.

To track the status of your deployment, see View Deployment Details with AWS CodeDeploy.