Why is my Elastic Beanstalk environment in the invalid state?

Short description

When you receive this error, make sure that there is no ongoing operation in the environment. If there is an ongoing operation, then you must either wait for the update to complete or cancel the in-progress updates according to your requirements. You can start your updates over when the environment becomes ready again. If there is no ongoing operation in the environment and you are still receiving the error, then your environment might be in an Unrecoverable state. This state prevents further operations from being performed in the environment. If you need further help returning the environment to the Available state, contact AWS Support. However, there are things you can check before you contact AWS Support.

Resolution

Elastic Beanstalk creates an AWS CloudFormation stack in the backend to manage the resources associated with the environment. You can check this stack in the CloudFormation console with the name awseb-(env-ID)-stack.

When the Elastic Beanstalk environment goes into anUnrecoverable state, the CloudFormation stack shows a *_FAILED status. Before the AWS Support team can change the environment to Available, the stack must show a *_COMPLETE status.

To correct the *_FAILED status of your CloudFormation stack, do the following steps according to the stack status:

"UPDATE_ROLLBACK_FAILED" status

1.    Navigate to the CloudFormation console. Then, identify the resource that failed to update during the rollback from the respective stack events.

2.    Bring the stack to the UPDATE_ROLLBACK_COMPLETE status by selecting the Continue Update Rollback option from the CloudFormation console.

3.    In the Continue update rollback dialog box, expand Advanced troubleshooting. In the Resources to skip - optional section, select the resource that failed to update.

4.    Choose Continue update rollback. The stack now shows the UPDATE_ROLLBACK_COMPLETE status.

5.    Contact the AWS Support team to change the environment to an Available state.

6.    When the environment is in Available status, you can perform further updates on the environment.

"DELETE_FAILED" status

1.    Navigate to the CloudFormation console. Then identify the resource that failed to delete from the respective stack events.

2.    Manually delete the resource that failed to delete. For example, if the resource that failed to delete is a security group, then delete it from the Amazon Elastic Compute Cloud (Amazon EC2) console.

3.    Delete the CloudFormation stack from the CloudFormation console. The stack now shows a DELETE_COMPLETE status.

4.    Contact the Elastic Beanstalk support team to change the environment to an Available state.

5.    When the environment is the Available state, you can rebuild or terminate the environment.

"CREATE_FAILED" status

If your stack has this status, it's a best practice to create a new Elastic Beanstalk environment, and then terminate the current one. This is because the state of the stack isn't stable enough perform a rollback. It's a best practice to not perform further updates on the current environment.

Before terminating the current environment, try the following:

• Leverage saved configurations if you want to have similar configurations for your new environment.
• Perform blue/green deployments and when the new environment is working correctly, perform the CNAME Swap between the URLs of the two environments.