Skip to main content

Local AWS Development

This guide walks through the use of LocalStack for bundle development.

Install localstack and tflocal wrapper CLIs​

pip3 install localstack terraform-local

Start local stack (in detached mode)​

This will run a local version of the entire AWS API in a local docker container.

localstack start -d

Use tflocal wherever you'd use terraform in your workflow​

Behind the scenes this will point any AWS provider API calls at your locally running LocalStack without any terraform code changes.

tflocal init -var-file _params.auto.tfvars.json -var-file _connections.auto.tfvars.json
tflocal plan -var-file _params.auto.tfvars.json -var-file _connections.auto.tfvars.json

Note on connections​

In order for your connections to be set up the same way they would normally, you should still download an AWS IAM artifact from Massdriver and place the details in the aws_authentication portion of your _connections.auto.tfvars.json file. These credentials will essentially be ignored while using local stack.