Terraform is a powerful tool for infrastructure automation that allows teams to manage infrastructure as code. Learning terraform may seem easy in the beginning but deploying architectures at scale can be a daunting task , even for experienced professionals.
Here are a few tips and tricks we follow at SquareOps , that have proven to be useful in the longer run for managing large Scale infrastructure using terraform.
We try to leverage the true power of terraform local variables. The easiest way to get started is to create a directory for each or your environments in your terraform git repository. e.g. env/staging , env/production. For example , this VPC reference file uses local variables Terraform-eks. Benefit ? you can avoid defining each and every variable , plus you can manage every configuration in one place in git .
modules need to be independent and re-usable piece of code. We create custom modules on top of base modules available publicly. A good example can be our network module. It uses public vpc module published by AWS and then creates an EC2 instance for Pritunl VPN. So the resultant module can create VPC with a VPN appliance. Example —Terraform-aws-vpc
Using a consistent directory structure is essential for maintaining a clean and organized Terraform project. You should structure your Terraform code in a way that is easy to understand and navigate. A common directory structure for Terraform projects includes:
Use flags in modules code to customize your architecture. Referring to same example of Pritunl VPN , we have a variable named — deploy_vpn = true. So that if we are deploying a development vpc or a network just for Proof Of Concept purpose, we do not need to deploy NAT Gateways or VPN appliance, hence we can disable these.
Even if you start as a 2-person team , or one man army , it is advisable to use remote state. Also it makes sense to refer the outputs of other modules from remote state . E.g. when you plan to deploy an RDS instance, you can get the VPC ID and subnet information from remote state of the network module. This way your infrastructure deployment becomes loosely coupled
Git pre-commit hooks are a great saviour when it comes to maintain the coding standards in your IaaC repo . Our pre-commit hook configuration takes care of
terraform fmt
( It’s an obsession )When all the Infrastructure definition is stored in version control, then it becomes easy to implement an infrastructure change management process. For any change, create a branch from mainline branch, make the changes and review these via a Pull request before approve and apply. Refer the Pipeline Workflow section in here for more detailed walkthrough.
Use Terraform Static code analysis tools , like Tfsec to spot potential misconfigurations in code , even before it is used to deploy the resources on cloud.
Cost is paramount to any deployment, and organizations often pay for what they don’t need ( or use )
A tool like Infracost can be integrated in your infrastructure deployment pipeline. It can generate projection for any new deployment , or even changes to existing deployment
Terraform is easy to get started , but not at all easy to do the right way . These techniques are adopted from our real life challenges and experience while building 100+ Architecture deliveries using terraform.
Happy Terraforming !!