Upgrading to Version 4.4

In ufo version 4.4, the environment name gets appends to the end of the CloudFormation stack name. Previous versions prepended the environment name to the stack name. This means a new stack gets created if you’re going from version 4.3 to 4.4. For example:

Version Stack Name
4.3 and below development-demo-web
4.4 and above demo-web-development

You must upgrade to using the new stack and delete the old stack manually. You can delete the old stack with the CloudFormation console by selecting the old stack, clicking Actions, and Delete Stack.

Upgrading Instructions

To upgrade from version 4.3 to 4.4 you can run:

ufo upgrade v43to44

This updates your .ufo/settings.yml file to include stack_naming: append_env which removes a warning message and 20 second delay when you deploy. Example:

.ufo/settings.yml:

base:
  stack_naming: append_env

If you would still like to keep the old behavior, you can use stack_naming: prepend_env for now. However, support for prepend_env will be removed in future versions.

Reasoning

CloudFormation names the resources it creates with the beginning portion of the stack name. When the stack name prepends the environment then resources like ELBs a little bit harder to identify since they might be named something like this product-Elb-K0LFFQ9LK50W. It makes it harder to distinguish ELBs from different apps created by ufo.

Pro tip: Use the <- and -> arrow keys to move back and forward.

Edit this page

See a typo or an error? You can improve this page. This website is available on GitHub and contributions are encouraged and welcomed. We love pull requests from you!