{"id":518148,"date":"2024-11-18T16:16:19","date_gmt":"2024-11-18T15:16:19","guid":{"rendered":"https:\/\/www.devoteam.com\/expert-view\/terragrunt-keep-terraform-dry\/"},"modified":"2025-05-07T12:18:53","modified_gmt":"2025-05-07T10:18:53","slug":"terragrunt-keep-terraform-dry","status":"publish","type":"expert-view","link":"https:\/\/devoteam.info\/en-nl\/expert-view\/terragrunt-keep-terraform-dry\/","title":{"rendered":"Terragrunt: Keep Terraform DRY With A Clean and Efficient Code"},"content":{"rendered":"\n

In this article, we will explore Terragrunt, a popular tool that promotes DRY (Don’t Repeat Yourself) practices and helps you use Terraform more effectively. DRY practices aim to reduce repetitive patterns and ensure<\/strong><\/span> that every piece of knowledge in your system has a single, unambiguous representation<\/strong>. We will also see how to use Terragrunt to set up resources on Google Cloud (GCP).<\/p>\n\n\n\n

By walking through a practical example, you will learn how to streamline your Terraform configurations, improve code maintainability, and efficiently manage your cloud infrastructure in Google Cloud.<\/a><\/p>\n\n\n\n

Terragrunt: Make the most of Terraform<\/h2>\n\n\n\n
\"\"<\/figure>\n\n\n\n

Note:<\/strong> Before we start, make sure you have a basic understanding of Terraform.<\/p>\n\n\n\n

Terraform is an Infrastructure as Code (IAC) tool that provisions and manages infrastructure (resources) in any cloud or data centre. It\u2019s a powerful tool for IAC, but it can encounter many challenges as projects grow. For example, Terraform configurations can become repetitive and duplicated, especially when handling multiple environments and components. Which can lead to maintenance difficulties.<\/p>\n\n\n\n

Additionally, Terraform modules can depend on each other, complicating management and increasing the risk of errors due to manual oversight.<\/p>\n\n\n\n

Managing a remote state can also become complex and challenging in large projects, especially when working with multiple environments and different teams. Similarly, provisioning and managing resources across multiple environments and reusing the same components can be tedious and difficult.<\/p>\n\n\n\n

Terragrunt offers solutions to all of these challenges.<\/p>\n\n\n\n

Terragrunt’s Core Benefits<\/strong><\/h2>\n\n\n\n

Eliminate Repetition with Terragrunt<\/strong><\/h3>\n\n\n\n

Abstractions or the “Don’t Repeat Yourself” (DRY) principle is a well-known software engineering pattern that aims to reduce duplicated code. This helps avoid managing extra configurations and simplifies system changes.<\/p>\n\n\n\n

Terragrunt allows you to share configurations across multiple Terraform modules or environments by defining, for example, the backend configurations, provider configurations, and variables at the root level. This way, all child modules can inherit these settings, eliminating repetition and promoting reusability.<\/p>\n\n\n\n

Effortless State Management with Terragrunt<\/strong><\/h3>\n\n\n\n

Terragrunt stores state files remotely, automatically creating and enabling locking resources (bucket) automatically to manage states. This helps avoid manual errors, state overwrites, and shares states across teams. As a result, you ensure that you are using the correct state configuration without any manual configuration of your modules.<\/p>\n\n\n\n

Simplify Dependencies Between Modules<\/strong><\/h3>\n\n\n\n

Usually, terraform modules depend on each other. For example, a database or computer instance may depend on the network, requiring you to manage the order in which modules are deployed. Terragrunt allows you to manage dependencies between modules explicitly, ensuring resources are provisioned in the correct order. Additionally, the outputs of modules can be passed to others, streamlining the process.<\/p>\n\n\n\n

Terragrunt: Manage Multiple Environments with Ease<\/strong><\/h3>\n\n\n\n

Managing multiple environments with Terraform requires additional configuration and management through workspaces and variables. This can be tedious and error-prone. Terragrunt simplifies this process by allowing you to define separate configuration files for each environment, reducing code duplication and minimising errors.<\/p>\n\n\n\n

Streamline Your Terraform Workflow<\/strong><\/h3>\n\n\n\n

In large projects with many teams, modules, and resources, Terraform can make it challenging to manage the workflow (init, plan, apply, etc.) across different environments, teams, and modules.  Terragrunt simplifies this by automatically running Terraform commands in the correct order across modules, eliminating the need for manual execution and keeping files organised.<\/p>\n\n\n\n

Practical Terragrunt Use Cases: Deploying on Google Cloud<\/strong><\/h2>\n\n\n\n

This example is not intended for production use; it demonstrates key features of Terragrunt. It helps keep your terraform code DRY, remote state configuration DRY, and Terragrunt architecture DRY.<\/p>\n\n\n\n

This project deploys (a GCE, a MySQL database, an Instance Template, and a VPC) in three environments (dev, stage, and prod)<\/p>\n\n\n\n

This project utilises public Terraform modules for GCP and is inspired by the official Terragrunt documentation.<\/p>\n\n\n\n

Source code<\/h3>\n\n\n\n
\"\"
GitHub – Moncif1\/hello_terragrunt<\/strong><\/a><\/figcaption><\/figure>\n\n\n\n

This project organises and manages different environments and modules, using Terragrunt to simplify the configuration and promote DRY principles.<\/p>\n\n\n\n

The configuration is designed to be modular and reusable, with a central configuration inherited across different environments or modules.<\/p>\n\n\n\n

This setup allows for centralising configurations, making it easier to manage and maintain common settings across multiple environments and modules. Any variables, remote state configurations, or other settings defined in the parent `terra grunt.hcl` will be applied to the module.<\/p>\n\n\n\n

Keep Your Terraform Dry<\/h2>\n\n\n\n
\"\"<\/figure>\n\n\n\n

This architecture manages different environments (development, stageand production) and various components (db, gce, template, vpc).<\/p>\n\n\n\n