Why complex types matter in Terraform - Why It Works

Introduction

Sometimes you need to organize related pieces of information together in your infrastructure code. Complex types let you group values like lists and maps so you can manage them clearly and avoid mistakes.

When you want to pass multiple related settings as one unit to a module.

When you need to store a list of servers with their IP addresses and roles.

When you want to create a map of environment variables for an application.

When you want to avoid repeating the same values in many places by grouping them.

When you want to validate that your input data has the right structure before applying changes.

Config File - main.tf

main.tf

variable "server_configs" {
  description = "List of server configurations with name and IP"
  type = list(object({
    name = string
    ip   = string
  }))
  default = [
    { name = "web-1", ip = "10.0.0.1" },
    { name = "db-1", ip = "10.0.0.2" }
  ]
}

output "server_names" {
  value = [for server in var.server_configs : server.name]
}

This file defines a variable named server_configs which is a list of objects. Each object has a name and an ip string. This groups related data together clearly.

The output server_names extracts just the names from the list, showing how to work with complex types.

Commands

This command sets up Terraform in the current folder by downloading necessary plugins and preparing the environment.

Terminal

terraform init

Expected Output

Initializing the backend...



Initializing provider plugins...

- Finding latest version of hashicorp/random...

- Installing hashicorp/random v3.4.3...

- Installed hashicorp/random v3.4.3 (signed by HashiCorp)



Terraform has been successfully initialized!

This checks if the Terraform files are syntactically correct and the complex types are properly defined.

Terminal

terraform validate

Expected Output

Success! The configuration is valid.

This applies the configuration, creating outputs and showing how complex types are handled in practice.

Terminal

terraform apply -auto-approve

Expected Output

Terraform used the selected providers to generate the following execution plan. Resource actions are indicated with the following symbols:



  + create



No changes. Your infrastructure matches the configuration.



Outputs:



server_names = [

  "web-1",

  "db-1"

]

→

-auto-approve - Automatically approve the apply step without asking for confirmation

Key Concept

If you remember nothing else from this pattern, remember: complex types let you group related data clearly so your infrastructure code is easier to read, reuse, and validate.

Common Mistakes

Defining variables as simple strings or lists when the data has multiple related parts.

This causes confusion and errors because related values are separated and harder to manage.

Use complex types like objects or maps to group related values together.

Not specifying the type for variables and relying on defaults.

Terraform may accept wrong data types, causing errors later during apply.

Always specify the variable type explicitly to catch mistakes early.

Summary

Define variables with complex types like lists of objects to group related data.

Use terraform init to prepare the environment and terraform validate to check your config.

Apply the configuration to see how Terraform handles and outputs complex data structures.