Meta Arguments

Meta-arguments in Terraform allow you to modify the behavior of resource blocks, enabling advanced configurations such as creating multiple instances of a resource and managing dependencies. In previous tutorials, we demonstrated how to create single resources, for example, a local file or a random pet resource. In this guide, we will explain meta-arguments in detail and illustrate how they can be used to enhance your Terraform configurations.

Creating a Single Resource

Consider the following Terraform configuration that creates a single resource—a local file:

resource "local_file" "pet" {
  filename = var.filename
  content  = var.content
}

The accompanying variable definitions are:

variable "filename" {
  default = "/root/pets.txt"
}

variable "content" {
  default = "I love pets!"
}

Traditional Loop Approach

In traditional scripting, such as with bash, you might use a loop to create multiple files. The example below creates three empty files (pet1, pet2, and pet3) in the /root directory:

#!/bin/bash
for i in {1..3}
do
    touch /root/pet${i}
done

After running the above script, listing the directory contents may produce:

$ ls -ltr /root/
-rw-r--r-- 1 root root 0 Sep  9 02:04 pet2
-rw-r--r-- 1 root root 0 Sep  9 02:04 pet1
-rw-r--r-- 1 root root 0 Sep  9 02:04 pet3

While Terraform does not directly support loop constructs within a resource block like traditional shell scripts, its meta-arguments provide mechanisms to achieve equivalent outcomes.

Utilizing Meta-Arguments

Terraform’s meta-arguments can be applied to any resource block to modify its behavior. Two important meta-arguments include:

depends_on: Defines explicit dependencies between resources to control the order of resource creation.
lifecycle: Provides rules that control how resources are created, updated, and destroyed.

Example: Enforcing Dependencies

In the following configuration, the depends_on meta-argument is used to ensure that the local file resource is created only after the random pet resource:

resource "local_file" "pet" {
  filename   = var.filename
  content    = var.content
  depends_on = [
    random_pet.my_pet
  ]
}

resource "random_pet" "my_pet" {
  prefix    = var.prefix
  separator = var.separator
  length    = var.length
}

Example: Using Lifecycle Rules

The lifecycle meta-argument can be used to manage resource replacement. For instance, you can ensure that a new resource is created before the old one is destroyed by setting create_before_destroy to true:

resource "local_file" "pet" {
  filename        = "/root/pets.txt"
  content         = "We love pets!"
  file_permission = "0700"
  
  lifecycle {
    create_before_destroy = true
  }
}

Next Steps

In the upcoming sections, we will explore additional meta-arguments in Terraform, including those related to looping and iterating over resources, to further enhance your infrastructure automation workflows.

Additional Resources

By understanding and utilizing meta-arguments, you can significantly enhance your Terraform configurations, making them both robust and flexible. Happy coding!

Watch Video

Datasources

Count

Introduction

Introduction to Infrastructure as Code

Getting Started with Terraform

Terraform Basics

Terraform State

Working with Terraform

Terraform with AWS

Remote State

Terraform Provisioners

Terraform Import, Tainting Resources and Debugging

Terraform Modules

Terraform Functions and Conditional Expressions

Creating a Single Resource

Traditional Loop Approach

Utilizing Meta-Arguments

Example: Enforcing Dependencies

Example: Using Lifecycle Rules

Next Steps

Additional Resources

Watch Video

​Creating a Single Resource

​Traditional Loop Approach

​Utilizing Meta-Arguments

​Example: Enforcing Dependencies

​Example: Using Lifecycle Rules

​Next Steps

​Additional Resources

Watch Video

Creating a Single Resource

Traditional Loop Approach

Utilizing Meta-Arguments

Example: Enforcing Dependencies

Example: Using Lifecycle Rules

Next Steps

Additional Resources