Preconditions and postconditions in Terraform - Step-by-Step Execution

Process Flow - Preconditions and postconditions

Start Terraform Apply

↓

Check Preconditions

↓

Stop with Error

↓

Create/Update Resources

↓

Check Postconditions

↓

Stop with Error

↓

Finish Apply Successfully

Terraform first checks preconditions before creating resources. After creation, it checks postconditions to ensure success.

Execution Sample

Terraform

terraform {
  required_version = ">= 1.3"
}

resource "null_resource" "example" {
  provisioner "local-exec" {
    command = "echo Hello"
  }

  lifecycle {
    precondition {
      condition     = length("Hello") > 0
      error_message = "String must not be empty"
    }
    postcondition {
      condition     = true
      error_message = "Postcondition failed"
    }
  }
}

This Terraform resource uses precondition to check a string is not empty before creation, and a postcondition that always passes after creation.

Process Table

Step	Action	Condition Checked	Result	Next Step
1	Start terraform apply	N/A	N/A	Check preconditions
2	Check precondition: length("Hello") > 0	length("Hello") > 0	True	Create resource
3	Create resource null_resource.example	N/A	Resource created	Check postconditions
4	Check postcondition: true	true	True	Finish apply
5	Finish terraform apply	N/A	Success	End

💡 All preconditions and postconditions passed, apply finishes successfully.

Status Tracker

Variable	Start	After Precondition	After Resource Creation	After Postcondition	Final
length("Hello")	N/A	5	5	5	5
precondition result	N/A	True	True	True	True
postcondition result	N/A	N/A	N/A	True	True
resource state	Not created	Not created	Created	Created	Created

Key Moments - 2 Insights

Why does Terraform stop if a precondition fails?

Terraform stops immediately on a failed precondition to prevent creating resources with invalid inputs, as shown in execution_table step 2 where a false condition would stop the process.

What happens if a postcondition fails after resource creation?

Terraform stops the apply with an error after resource creation if a postcondition fails, preventing a false success state, as indicated in execution_table step 4.

Visual Quiz - 3 Questions

Look at the execution_table, what is the result of the precondition check at step 2?

A Error

B True

C False

D Not evaluated

💡 Hint

Check the 'Result' column in row for step 2 in execution_table.

At which step does Terraform create the resource?

A Step 3

B Step 2

C Step 1

D Step 4

💡 Hint

Look for the 'Create resource' action in execution_table.

If the precondition was false, what would happen?

A Terraform would continue to create the resource

B Terraform would ignore the precondition and check postcondition

C Terraform would stop with an error before creating the resource

D Terraform would skip postcondition checks

💡 Hint

Refer to the concept_flow where 'No' from precondition leads to stopping with error.

Concept Snapshot

Terraform Preconditions and Postconditions:
- Preconditions run before resource creation to validate inputs.
- Postconditions run after creation to verify success.
- If any condition fails, Terraform stops apply with an error.
- Use lifecycle blocks with precondition and postcondition.
- Helps catch errors early and ensure resource correctness.

Full Transcript

Terraform applies resources by first checking preconditions to ensure inputs are valid. If preconditions fail, Terraform stops and shows an error to avoid creating bad resources. If preconditions pass, Terraform creates or updates the resource. After creation, postconditions run to verify the resource state is as expected. If postconditions fail, Terraform stops with an error to avoid false success. This process ensures safe and correct infrastructure deployment.