Menu
AWS Elastic Beanstalk
Developer Guide (API Version 2010-12-01)

eb deploy

Description

Deploys the application source bundle from the initialized project directory to the running application.

If git is installed, EB CLI uses the git archive command to create a .zip file from the contents of the most recent git commit command.

Note

You can configure the EB CLI to deploy an artifact from your build process instead of creating a ZIP file of your project folder. See Deploying an Artifact Instead of the Project Folder for details.

Syntax

eb deploy

eb deploy environment_name

Options

Name

Description

-l version_label

or

--label version_label

The version label for the application version that EB CLI deploys. If the version label includes spaces, surround it in double quotes.

Type: String

--env-group-suffix groupname Group name to append to the environment name. Only for use with Compose Environments.

-m "version_description"

or

--message "version_description"

The description for the application version, enclosed in double quotation marks.

Type: String

--modules component-a component-b

List of components to update. Only for use with Compose Environments.

-pr

or

--process

Preprocess and validate the environment manifest and configuration files in the source bundle. Validating configuration files can identify issues prior to deploying the application version to an environment.

--source codecommit/repository-name/branch-name

AWS CodeCommit repository and branch. See Using the EB CLI with AWS CodeCommit.

--staged

Deploy files staged in the git index instead of the HEAD commit.

--timeout minutes

The number of minutes before the command times out.

--version version_label

An existing application version to deploy.

Type: String

Common options

Output

If successful, the command returns the status of the deploy operation.

If you enabled AWS CodeBuild support in your application, eb deploy displays information from AWS CodeBuild as your code is built. Learn more about AWS CodeBuild support in Elastic Beanstalk in the Using the EB CLI with AWS CodeBuild topic.

Example

The following example deploys the current application.

Copy
$ eb deploy INFO: Environment update is starting. INFO: Deploying new version to instance(s). INFO: New application version was deployed to running EC2 instances. INFO: Environment update completed successfully.