AWS Elastic Beanstalk
Developer Guide

Migrating Your Application from a Legacy Platform Version

If you have deployed an Elastic Beanstalk application that uses a legacy platform version, you should migrate your application to a new environment using a non-legacy platform version so that you can get access to new features. If you are unsure whether you are running your application using a legacy platform version, you can check in the Elastic Beanstalk console. For instructions, see To check if you are using a legacy platform version.

What new features are legacy platform versions missing?

Legacy platforms do not support the following features:

Why are some platform versions marked legacy?

Some older platform versions do not support the latest Elastic Beanstalk features. These versions are marked (legacy) on the environment overview page in the Elastic Beanstalk console.

To check if you are using a legacy platform version

  1. Open the Elastic Beanstalk console.

  2. From the All applications page, choose the environment that you want to verify.

  3. In the Overview section of the environment dashboard, view the Platform name.

    Your application is using a legacy platform version if you see (legacy) next to the platform name.

To migrate your application

  1. Deploy your application to a new environment. For instructions, go to Creating an AWS Elastic Beanstalk Environment.

  2. If you have an Amazon RDS DB Instance, update your database security group to allow access to your EC2 security group for your new environment. For instructions on how to find the name of your EC2 security group using the AWS Management Console, see Security Groups. For more information about configuring your EC2 security group, go to the "Authorizing Network Access to an Amazon EC2 Security Group" section of Working with DB Security Groups in the Amazon Relational Database Service User Guide.

  3. Swap your environment URL. For instructions, go to Blue/Green Deployments with Elastic Beanstalk.

  4. Terminate your old environment. For instructions, go to Terminate an Elastic Beanstalk Environment.

Note

If you use AWS Identity and Access Management (IAM) then you will need to update your policies to include AWS CloudFormation and Amazon RDS (if applicable). For more information, see Using Elastic Beanstalk with AWS Identity and Access Management.