Terraform test framework (1.6+) - Step-by-Step Execution

Process Flow - Terraform test framework (1.6+)

Write test file with test blocks

↓

Run 'terraform test'

↓

Terraform initializes test environment

↓

Terraform applies test configuration

↓

Terraform runs test assertions

↓

Report test results: pass/fail

↓

Cleanup test environment

The Terraform test framework runs tests by applying configurations and checking assertions, then reports results and cleans up.

Execution Sample

Terraform

test "example" {
  config = "resource \"null_resource\" \"test\" {}"
  check "validate" {
    assert {
      condition = test_resource("null_resource.test").exists
    }
  }
}

This test defines a null resource and checks if it exists after applying.

Process Table

Step	Action	Evaluation	Result
1	Parse test block	Read test name and config	Test 'example' loaded
2	Initialize test environment	terraform init	Environment ready
3	Apply test config	terraform apply	null_resource.test created
4	Run check assertions	Check resource existence	null_resource.test exists: true
5	Report results	All checks passed	Test 'example' PASSED
6	Cleanup	Destroy test resources	Environment cleaned

💡 All test assertions passed, test framework completes successfully

Status Tracker

Variable	Start	After Step 3	After Step 4	Final
null_resource.test	not created	created	exists confirmed	destroyed

Key Moments - 2 Insights

Why does the test framework apply the configuration before checking assertions?

Because the resources must exist in the test environment to verify their state, as shown in steps 3 and 4 of the execution_table.

What happens if a check assertion fails during the test?

The test framework reports a failure at step 5 and stops further checks, indicating which assertion failed.

Visual Quiz - 3 Questions

Look at the execution_table, what is the state of null_resource.test after step 3?

A Not created

B Created

C Destroyed

D Unknown

💡 Hint

Check the 'Evaluation' and 'Result' columns at step 3 in execution_table

At which step does the test framework confirm that the resource exists?

A Step 2

B Step 3

C Step 4

D Step 5

💡 Hint

Look at the 'Action' and 'Evaluation' columns in execution_table for resource existence check

If the resource was not created successfully, how would the execution_table change?

A Step 3 result would show creation failed

B Step 4 would confirm existence

C Step 5 would report test passed

D Step 6 would skip cleanup

💡 Hint

Refer to step 3 and step 5 results in execution_table for success or failure outcomes

Concept Snapshot

Terraform test framework (1.6+):
- Write test blocks with config and checks
- Run 'terraform test' to execute
- Terraform applies config in isolated env
- Checks assert resource states
- Results show pass/fail
- Environment cleans up automatically

Full Transcript

The Terraform test framework lets you write tests as blocks with configuration and checks. When you run 'terraform test', it initializes a test environment, applies the configuration, and runs assertions to verify resource states. It reports whether tests pass or fail and then cleans up the environment. This process ensures your Terraform code works as expected in a safe, repeatable way.