Deployment walkthrough
Updating references to Gruntwork Infrastructure as Code Library
In order to take advantage of the Terraform AWS provider version 3, you need to update your references to the Gruntwork Infrastructure as Code Library to use a compatible version. We (Gruntwork) have gone through all our modules in the library to test and update the code to be compatible with AWS provider version 3. As a customer, you need to update to the proper versions of the Gruntwork IaC Library to pick up the fixes/changes that were made to be compatible. Be sure to read the release notes to know what changes need to be made to update to that version.
Refer to our "Updating to new versions" guide for instructions on how to update the versions in your code.
The following table provides a summary of all the relevant Gruntwork AWS modules and the respective versions that are compatible with AWS provider version 3.
Gruntwork follows semantic
versioning.
For any pre-1.0 modules, this means that version updates to the minor version
are considered backwards incompatible releases for any version updates prior to
1.0.0 release. Make sure to read the release notes for the relevant modules any
time you are updating minor versions! Note that you will want to read the
release notes for each minor version that is updated (e.g., if you are going
from v0.5.x to v0.9.x, you will want to read the notes for v0.6.0,
v0.7.0, v0.8.0, and v0.9.0 to get the full list of backwards incompatible
updates).
Version Compatibility table
Gruntwork Repo | Minimum version with AWS Provider v3 support |
terraform-aws-vpc | |
module-asg | |
module-data-storage | |
module-server | |
package-lambda | |
package-sam | |
module-cache | |
package-messaging | |
package-static-assets | |
terraform-aws-monitoring | |
package-openvpn | |
module-security | |
module-ecs | |
module-ci | |
terraform-aws-eks | |
module-load-balancer | |
terraform-aws-couchbase | |
package-zookeeper | |
package-kafka | |
package-elk | |
terraform-aws-influx | |
terraform-aws-vault | |
terraform-aws-consul | |
terraform-aws-nomad | |
package-terraform-utilities | |
cis-compliance-aws |
Update the Gruntwork Reference Architecture to AWS Provider v3
If you purchased the Gruntwork Reference Architecture, you will have a copy of the infrastructure-live and
infrastructure-modules repositories that contain the infrastructure code for deploying the Reference Architecture. You
will need to update the relevant code in infrastructure-modules to use a compatible version of the
Gruntwork Infrastructure as Code Library, as per the compatibility table above.
To help guide you through the upgrade process, we have updated the Acme Reference Architecture examples to support AWS provider v3. You can refer to the following release notes for detailed information and code patches that you can apply to update your snapshot of the Gruntwork Reference Architecture:
CIS Reference Architecture
Refer to the release notes for
v0.0.1-20201021
of the cis-infrastructure-live-acme repository for instructions on how to
update the CIS components of the Reference Architecture to be compatible with
AWS provider v3. For all other components, refer to the release notes for
v0.0.1-20201021
of the infrastructure-modules-multi-account-acme repository.
Standard Reference Architecture
Refer to the release notes for
v0.0.1-20201021
of the infrastructure-modules-multi-account-acme repository for instructions
on how to update your components to be compatible with AWS provider v3.