Skip to content

Brownfield Migration Kit

Migrate from terraform-aws-modules to compliance.tf with compliance controls enforced automatically. No state surgery, no resource recreation, no workflow changes. Change the source URL, fix any validation errors, and apply.


Quick Start

Migration is three steps:

  1. Change the source URL: terraform-aws-modules/s3-bucket/aws becomes soc2.compliance.tf/terraform-aws-modules/s3-bucket/aws
  2. Run terraform init -upgrade to download the module from the compliance.tf registry
  3. Run terraform plan, fix any validation errors, then terraform apply

For the full walkthrough with authentication setup, bulk find-and-replace, rollback instructions, and team coordination: Full Migration Guide.


Module Playbooks

Step-by-step migration playbooks for individual modules. Each covers before/after configuration, enforced controls, common issues, and rollback.

ModuleDifficultyTime Estimate
S3 BucketMinor fixes15-30 min per instance
RDSMinor fixes15-30 min per instance
VPCUsually clean10-15 min per instance
EC2 InstanceMinor fixes15-30 min per instance

Reference


Other Modules

compliance.tf supports 34 modules from terraform-aws-modules. The four playbooks above cover the most common starting points. All 34 modules follow the same migration pattern: change the source, init, plan, fix, apply.

For the full list of supported modules and their control counts, see the module compatibility page.