eb appversion - Amazon Elastic Beanstalk
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

eb appversion

Description

The EB CLI appversion command manages your Elastic Beanstalk application versions. You can create a new version of the application without deploying, delete a version of the application, or create the application version lifecycle policy. If you invoke the command without any options, it enters the interactive mode.

Use the --create option to create a new version of the application.

Use the --delete option to delete a version of the application.

Use the lifecycle option to display or create the application version lifecycle policy. For more information, see Configuring application version lifecycle settings.

Syntax

eb appversion

eb appversion [-c | --create]

eb appversion [-d | --delete] version-label

eb appversion lifecycle [-p | --print]

Options

Name

Description

Type: String

-a application-name

or

--application_name application-name

The name of the application. If an application with the specified name isn't found, the EB CLI creates an application version for a new application.

Only applicable with the --create option.

Type: String

-c

or

--create

Create a new version of the application.

-d version-label

or

--delete version-label

Delete the version of the application that is labeled version-label.

-l version_label

or

--label version_label

Specify a label to use for the version that the EB CLI creates. If you don't use this option, the EB CLI generates a new unique label. If you provide a version label, make sure that it's unique.

Only applicable with the --create option.

Type: String

lifecycle

Invoke the default editor to create a new application version lifecycle policy. Use this policy to avoid reaching the application version quota.

lifecycle -p

or

lifecycle --print

Display the current application lifecycle policy.

-m "version_description"

or

--message "version_description"

The description for the application version. It's enclosed in double quotation marks.

Only applicable with the --create option.

Type: String

-p

or

--process

Preprocess and validate the environment manifest and configuration files in the source bundle. Validating configuration files can identify issues. We recommend you do this before deploying the application version to the environment.

Only applicable with the --create option.

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

CodeCommit repository and branch. For more information, see Using the EB CLI with Amazon CodeCommit.

Only applicable with the --create option.

--staged

Use the files staged in the git index, instead of the HEAD commit, to create the application version.

Only applicable with the --create option.

--timeout minutes

The number of minutes before the command times out.

Only applicable with the --create option.

Common options

Using the command interactively

If you use the command without any arguments, the output displays the versions of the application. They're listed in reverse chronological order, with the lastest version listed first. See the Examples section for examples of what the screen looks like. Note that the status line is displayed at the bottom. The status line displays context-sensitive information.

Press d to delete an application version, press l to manage the lifecycle policy for your application, or press q to quit without making any changes.

Note

If the version is deployed to any environment, you can't delete that version.

Output

The command with the --create option displays a message confirming that the application version was created.

The command with the --delete version-label option displays a message confirming that the application version was deleted.

Examples

The following example shows the interactive window for an application with no deployments.

The following example shows the interactive window for an application with the fourth version, with version label Sample Application, deployed.

The following example shows the output from an eb appversion lifecycle -p command, where ACCOUNT-ID is the user's account ID:

Application details for: lifecycle Region: sa-east-1 Description: Application created from the EB CLI using "eb init" Date Created: 2016/12/20 02:48 UTC Date Updated: 2016/12/20 02:48 UTC Application Versions: ['Sample Application'] Resource Lifecycle Config(s): VersionLifecycleConfig: MaxCountRule: DeleteSourceFromS3: False Enabled: False MaxCount: 200 MaxAgeRule: DeleteSourceFromS3: False Enabled: False MaxAgeInDays: 180 ServiceRole: arn:aws-cn:iam::ACCOUNT-ID:role/aws-elasticbeanstalk-service-role