Updating the deployment strategy from rolling update to Amazon ECS blue/green

You can migrate from a rolling update deployment to an Amazon ECS blue/green deployment when you want to make and test service changes before implementing them in a production environment.

Prerequisites

Before migrating your service from rolling to blue/green deployments, ensure you have the following:

Wait for any current deployments to complete.
An existing Amazon ECS service using the rolling deployment strategy.
If you have multiple service revisions serving traffic, Amazon ECS attempts to consolidate traffic to a single revision during migration. If this fails, you might need to manually update your service to use a single revision before migrating.
Configure the appropriate permissions.
- For information about Elastic Load Balancing permissions, see Amazon ECS infrastructure IAM role for load balancers.
- For information about Lambda permissions, see Permissions required for Lambda functions in Amazon ECS blue/green deployments.
Depending on configuration, you need to perform one of the following:
- If your service uses Elastic Load Balancing, update your service with the new `advancedConfiguration` and start a rolling deployment.
- If your service uses Service Connect, update your service and start a rolling deployment.
- If your service uses both Elastic Load Balancing and Service Connect, perform both steps above (you can use a single UpdateService request).
- If your service uses none of the above, then no additional operation is needed.
Amazon ECS blue/green deployments require that your service uses one of the following features. Configure the appropriate resources.
- Application Load Balancer - For more information, see Application Load Balancer resources for blue/green, linear, and canary deployments.
- Network Load Balancer - For more information, see Network Load Balancer resources for Amazon ECS blue/green, linear and canary deployments.
- Service Connect - For more information, see Service Connect resources for Amazon ECS blue/green, linear, and canary deployments.

Procedure

Open the Amazon ECS console at https://console.aws.amazon.com/ecs/v2.
In the navigation pane, choose Clusters.
On the Clusters page, choose the cluster that contains the service you want to migrate.

The Cluster details page is displayed.
On the Cluster details page, choose the Services tab.
Choose the service, and then choose Update.

The Update service page is displayed
Expand Deployment options, and then do the following:
For Deployment strategy, choose Blue/green.
Configure the blue/green deployment settings:
1. For Bake time, enter the number of minutes that both the blue and green service revisions will run simultaneously before the blue revision is terminated.
  
  This allows time for verification and testing.
2. (Optional) Configure Lambda functions to run at specific stages of the deployment. Under Deployment lifecycle hooks, configure Lambda functions for the following stages:
  - Pre scale up: Runs before scaling up the green service revision
  - Post scale up: Runs after scaling up the green service revision
  - Test traffic shift: Runs during test traffic routing to the green service revision
  - Post test traffic shift: Runs after test traffic is routed to the green service revision
  - Production traffic shift: Runs during production traffic routing to the green service revision
  - Post production traffic shift: Runs after production traffic is routed to the green service revision
  To add a lifecycle hook:
  1. Choose Add.
  2. For Lambda function, enter the function name or ARN.
  3. For Role, choose the IAM role that has permission to invoke the Lambda function.
  4. For Lifecycle stages, select the stages when the Lambda function should run.
  5. Optional: For Hook details, enter key-value pairs to provide additional information to the hook.
Configure the load balancer settings:
1. Under Load balancing, verify that your service is configured to use a load balancer.
2. For Target group, choose the primary target group for your production (blue) environment.
3. For Alternate target group, choose the target group for your test (green) environment.
4. For Production listener rule, choose the listener rule for routing production traffic.
5. Optional: For Test listener rule, choose a listener rule for routing test traffic to your green environment.
6. For Role, choose the IAM role that allows Amazon ECS to manage your load balancer.
Review your configuration changes, and then choose Update.

Next steps

Update the service to start the deployment. For more information, see Updating an Amazon ECS service.
Monitor the deployment process to ensure it follows the blue/green pattern:
- The green service revision is created and scaled up
- Test traffic is routed to the green revision (if configured)
- Production traffic is shifted to the green revision
- After the bake time, the blue revision is terminated

Warning Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Document Conventions

Update the Amazon ECS deployment strategy

Updating the deployment strategy from Amazon ECS blue/green to rolling update