AWS Elastic Beanstalk
Developer Guide (API Version 2010-12-01)
AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Managing Application Versions

Elastic Beanstalk creates an application version whenever you upload source code. This usually occurs when you create a new environment or upload and deploy code using the environment management console or EB CLI. You can also upload a source bundle without deploying it from the application management console.

To create a new application version

  1. Open the Elastic Beanstalk console.

  2. Choose an application.

  3. In the navigation pane, choose Application Versions.

  4. Choose Upload.

  5. Enter a label for this version in the Version label field.

  6. (Optional) Enter a brief description for this version in the Description field.

  7. Choose Browse to specify the location of the source bundle.

    Note

    The file size limit is 512 MB.

  8. Choose Upload.

The file you specified is associated with your application. You can deploy the application version to a new or existing environment.

Over time, your application can accumulate a large number of application versions. To save storage space and avoid hitting the application version limit, you can configure Elastic Beanstalk to delete old versions automatically.

Note

Deleting an application version does not have any affect on environments currently running that version.

To delete an application version

  1. Open the Elastic Beanstalk console.

  2. Choose an application.

  3. In the navigation pane, choose Application versions.

  4. In the list of application versions, select the check box next to the application version that you want to delete, and then click Delete.

  5. (Optional) To leave the application source bundle for this application version in your Amazon S3 bucket, uncheck Delete versions from Amazon S3.

  6. Choose Apply.

Lifecycle settings are applied when you create new application versions. For example, if you configure a maximum of 25 application versions, Elastic Beanstalk deletes the oldest version when you upload a 26th version. If you set a maximum age of 90 days, any versions more than 90 days old are deleted when you upload a new version.

If you don't choose to delete the source bundle from Amazon S3, Elastic Beanstalk deletes the version from it's records, but the source bundle is left if your Elastic Beanstalk storage bucket. The application version limit only applies to versions Elastic Beanstalk tracks, so you can delete versions to stay within the limit, but retain all source bundles in Amazon S3 if needed.