Rolling Update with AWS CloudFormation

Michael Wittig – 18 Jan 2016

Updating all EC2 instances in an Auto Scaling Group becomes complex and expensive when done manually. If you follow the immutable infrastructure approach you will roll out a new version by creating new EC2 instances. You never change the old instances. But how do you deploy security patches of the OS or a new version of your application automatically? One option is using AWS CloudFormation.

CloudFormation supports the UpdatePolicy attribute for Auto Scaling Groups. You can define that CloudFormation performs a rolling update of instances whenever the Launch Configuration changes. A rolling update will roll out your change in small batches.

Here is an example. Let’s say we have 4 EC2 instances running version A (grey) and a batch size of 2. Now we roll out version B (dark). Have a look at the following animation.

Rolling update animation

  1. Two EC2 instances with version B are started (blue).
  2. Wait until both new EC2 instances running version B are in service (dark). You now have 6 EC2 instances running.
  3. Terminate the two oldest EC2 instances running version A. You now have 4 EC2 instances running.
  4. Two EC2 instances with version B are started (blue).
  5. Wait until both new EC2 instances running version B are in service (dark). You now have 6 EC2 instances running.
  6. Terminate the two oldest EC2 instances running version A. You now have 4 EC2 instances running.
  7. Done.

The following CloudFormation template is enriched with some vocal comments and line highlighting. Press the play button and enjoy the show.

How do you like CloudFormation templates annotated with voice? Let me know!

Try rolling updates with our CloudFormation template:

  1. Launch Stack
  2. Click Next to proceed with the next step of the wizard.
  3. Specify a name and all parameters for the stack. Set VersionParameter to 1.
  4. Click Next to proceed with the next step of the wizard.
  5. Click Next to skip the Options step of the wizard.
  6. Click Create to start the creation of the stack.
  7. Wait until the stack reaches the state CREATE_COMPLETE.
  8. Open the Outputs tab and click on the provided ELB URL. You should see a white page that contains Version 1 text.
  9. In the CloudFormation console, select the stack, click the Actions button at the top, select Update Stack.
  10. Click Next to proceed with the next step of the wizard.
  11. Change the VersionParameter to 2.
  12. Click Next to proceed with the next step of the wizard.
  13. Click Next to skip the Options step of the wizard.
  14. Click Update to update the stack.
  15. Go back to the page (ELB URL) and reload every now and then. After a few minutes it should switch to Version 2.
  16. Don’t forget to delete the CloudFormation stack!
Michael Wittig

Michael Wittig

I’m the author of Amazon Web Services in Action. I work as a software engineer, and independent consultant focused on AWS and DevOps.

You can contact me via Email, Twitter, and LinkedIn.

Briefcase icon
Hire me
Cover of Rapid Docker on AWS

New book: Rapid Docker on AWS

A rapid way to get your web application up and running on AWS. Made for web developers and DevOps engineers who want to dockerize their web applications and run their containers on Amazon Web Services. Prior knowledge of Docker and AWS is not required.

Buy icon
Buy now
Marbot Logo

Incident Management for Slack

Team up to solve incidents with our chatbot marbot. Never miss a critical alert. Escalate alerts from your AWS infrastructure among your team members. Strong integrations with all parts of your AWS infrastructure: CloudWatch, Elastic Beanstalk, RDS, EC2, ...

Slack icon
Try for free