Tuple type definition in Terraform - Mini Project: Build & Apply

Tuple type definition in Terraform

📖 Scenario: You are setting up a Terraform configuration to manage cloud resources. You want to define a variable that holds a fixed list of values with specific types, like a tuple. This helps ensure your configuration is clear and predictable.

🎯 Goal: Create a Terraform variable with a tuple type definition that holds exactly three elements: a string, a number, and a boolean. Then use this variable in a resource configuration.

📋 What You'll Learn

Define a variable called my_tuple with a tuple type of [string, number, bool]

Set a default value for my_tuple as ["example", 42, true]

Create a local value called tuple_values that references the variable my_tuple

Use the tuple_values local in a resource argument (e.g., a tag or name)

💡 Why This Matters

🌍 Real World

Cloud engineers often need to define fixed sets of values with specific types to configure resources predictably. Tuples help enforce this structure in Terraform.

💼 Career

Understanding tuple types in Terraform is important for writing robust infrastructure as code, which is a key skill for cloud and DevOps roles.

1

Define the tuple variable

Create a Terraform variable called my_tuple with the type tuple([string, number, bool]) and set its default value to ["example", 42, true].

Terraform

# Define the variable my_tuple with tuple type and default value
# Your code here

Hint

Use variable "my_tuple" {} block with type = tuple([...]) and default = [...].

2

Create a local value referencing the tuple variable

Add a local value called tuple_values that references the variable my_tuple.

Terraform

variable "my_tuple" {
  type    = tuple([string, number, bool])
  default = ["example", 42, true]
}

# Define local tuple_values referencing var.my_tuple
# Your code here

Hint

Use a locals block and assign tuple_values = var.my_tuple.

3

Use the tuple local in a resource

Create a resource null_resource named example and set its triggers argument to use the first element of local.tuple_values as name and the second element as number.

Terraform

variable "my_tuple" {
  type    = tuple([string, number, bool])
  default = ["example", 42, true]
}

locals {
  tuple_values = var.my_tuple
}

resource "null_resource" "example" {
  # Use local.tuple_values elements in triggers
  # Your code here
}

Hint

Use local.tuple_values[index] to access tuple elements inside triggers.

4

Add a condition using the boolean tuple element

Inside the null_resource example, add a lifecycle prevent_destroy argument set to the third element of local.tuple_values (the boolean).

Terraform

variable "my_tuple" {
  type    = tuple([string, number, bool])
  default = ["example", 42, true]
}

locals {
  tuple_values = var.my_tuple
}

resource "null_resource" "example" {
  triggers = {
    name   = local.tuple_values[0]
    number = local.tuple_values[1]
  }

  # Add lifecycle block with prevent_destroy using local.tuple_values[2]
  # Your code here
}

Hint

Use a lifecycle block with prevent_destroy = local.tuple_values[2].

Practice

1. What is a tuple type in Terraform?

easy

A. A fixed list of values where each value has a specific type

B. A list of values all having the same type

C. A map with keys and values of any type

D. A variable that can hold any type of data

Solution

1. Step 1: Understand tuple definition

   A tuple in Terraform is a collection of values with a fixed number and specific types for each position.

2. Step 2: Compare with other types

   Unlike lists, tuples have fixed length and types per position, not all the same type.

3. Final Answer:

   A fixed list of values where each value has a specific type -> Option A

4. Quick Check:

   Tuple = fixed types and order [OK]

Hint: Remember: tuple = fixed order and types [OK]

Common Mistakes:

• Confusing tuple with list (all same type)
• Thinking tuple can have variable length
• Mixing tuple with map types

2. Which of the following is the correct syntax to define a tuple type with a string and a number in Terraform?

easy

A. tuple([string, number])

B. tuple[string, number]

C. list([string, number])

D. tuple(string, number)

Solution

1. Step 1: Recall tuple syntax

   Terraform tuple types are defined as tuple([type1, type2, ...]), using square brackets inside parentheses.

2. Step 2: Check options

   The correct syntax is tuple([string, number]). Options B and D are invalid syntax. list([string, number]) is a list, not a tuple.

3. Final Answer:

   tuple([string, number]) -> Option A

4. Quick Check:

   Tuple syntax = tuple([type1, type2]) [OK]

Hint: Use tuple([type1, type2]) syntax with square brackets inside parentheses [OK]

Common Mistakes:

• Using parentheses without square brackets
• Using square brackets without parentheses
• Confusing tuple syntax with list syntax

3. Given this variable definition in Terraform:

variable "example" {
  type = tuple([string, number, bool])
  default = ["hello", 42, true]
}

What will be the value of var.example[1]?

medium

A. "hello"

B. true

C. Error: invalid index

D. 42

Solution

1. Step 1: Understand tuple indexing

   Tuple elements are indexed starting at 0. The second element is at index 1.

2. Step 2: Identify value at index 1

   The tuple is ["hello", 42, true], so index 1 is 42.

3. Final Answer:

   42 -> Option D

4. Quick Check:

   Index 1 in tuple = 42 [OK]

Hint: Tuple index starts at 0, so second item is index 1 [OK]

Common Mistakes:

• Confusing index 1 with index 0
• Expecting string instead of number at index 1
• Thinking tuple elements are unordered

4. What is wrong with this Terraform tuple type definition?

variable "bad_tuple" {
  type = tuple([string, number])
  default = ["text", "not a number"]
}

medium

A. The tuple type syntax is incorrect

B. The default value does not match the tuple types

C. Tuple cannot have string and number types together

D. Default value must be a map, not a list

Solution

1. Step 1: Check tuple type syntax

   The syntax tuple([string, number]) is correct for a tuple with two elements.

2. Step 2: Validate default values

   The default is ["text", "not a number"]. The second element should be a number but is a string, causing a type mismatch.

3. Final Answer:

   The default value does not match the tuple types -> Option B

4. Quick Check:

   Tuple types must match default values [OK]

Hint: Check default values match tuple types exactly [OK]

Common Mistakes:

• Assuming tuple syntax is wrong
• Ignoring type mismatch in default values
• Thinking tuples can't mix types

5. You want to define a Terraform variable that holds a tuple with three elements: a string, a list of numbers, and a boolean. Which is the correct type definition?

hard

A. tuple(string, list[number], bool)

B. tuple(string, list, bool)

C. tuple([string, list(number), bool])

D. tuple[string, list(number), bool]

Solution

1. Step 1: Understand tuple element types

   The tuple has three elements: a string, a list of numbers, and a boolean.

2. Step 2: Use correct syntax for list of numbers

   In Terraform, list of numbers is written as list(number). So the tuple type is tuple([string, list(number), bool]).

3. Step 3: Check options

   tuple([string, list(number), bool]) matches the correct syntax. Others use invalid syntax like list[number] or brackets.

4. Final Answer:

   tuple([string, list(number), bool]) -> Option C

5. Quick Check:

   List type inside tuple uses list(type) [OK]

Hint: Use list(type) inside tuple for lists [OK]

Common Mistakes:

• Using square brackets instead of parentheses for list
• Omitting type inside list
• Using tuple with square brackets incorrectly