Mock providers in tests in Terraform - Step-by-Step Execution

Process Flow - Mock providers in tests

Write Terraform config

↓

Define mock provider

↓

Run terraform test

↓

Terraform uses mock provider

↓

Test resource creation & outputs

↓

Verify expected behavior

↓

Test passes or fails

This flow shows how Terraform tests use mock providers to simulate real providers, allowing tests to run without actual cloud resources.

Execution Sample

Terraform

terraform {
  required_providers {
    mock = {
      source = "hashicorp/mock"
      version = "~> 0.1"
    }
  }
}

provider "mock" {}

resource "mock_resource" "test" {
  name = "example"
}

This Terraform code sets up a mock provider and a mock resource to test resource creation without real cloud calls.

Process Table

Step	Action	Terraform State	Mock Provider Behavior	Test Outcome
1	Initialize Terraform with mock provider	No resources created	Mock provider ready to simulate	No test result yet
2	Apply configuration	Resource 'mock_resource.test' planned	Simulates resource creation	Resource creation simulated
3	Terraform creates mock_resource.test	Resource state stored in memory	Returns fake ID and attributes	Resource appears created
4	Run test assertions	Resource state accessible	Mock provider returns expected outputs	Assertions pass if outputs match
5	Test completes	State unchanged	No real cloud calls made	Test passes if all assertions succeed
6	Exit	Test environment cleaned	Mocks reset	Testing ends

💡 Test ends after assertions pass or fail; no real infrastructure is created due to mock provider

Status Tracker

Variable	Start	After Step 2	After Step 3	After Step 4	Final
terraform_state	empty	planned resource mock_resource.test	resource created in memory	resource state accessible	cleaned
mock_provider	initialized	ready to simulate	returns fake resource ID	returns expected outputs	reset

Key Moments - 3 Insights

Why does the test not create real cloud resources?

Because the mock provider simulates resource creation and returns fake data, as shown in execution_table steps 2 and 3.

How does Terraform know to use the mock provider during tests?

The Terraform configuration specifies the mock provider source and version, so Terraform uses it instead of a real provider (see execution_table step 1).

What happens if the mock provider returns unexpected outputs?

Test assertions will fail during step 4, causing the test to fail, since outputs do not match expected values.

Visual Quiz - 3 Questions

Look at the execution_table, what is the Terraform state after step 3?

A Resource state stored in memory

B No resources created

C Resource state cleaned

D Resource planned but not created

💡 Hint

Check the 'Terraform State' column in row for step 3

At which step does the mock provider simulate resource creation?

A Step 1

B Step 4

C Step 2

D Step 5

💡 Hint

Look at the 'Mock Provider Behavior' column for when resource creation is simulated

If the mock provider returned wrong outputs, what would happen in the test?

A Test assertions would pass

B Test assertions would fail

C Terraform would create real resources

D Terraform would skip resource creation

💡 Hint

Refer to key_moments about unexpected outputs and execution_table step 4

Concept Snapshot

Mock providers in Terraform tests simulate real providers.
They let you test resource creation without real cloud calls.
Define mock provider in Terraform config.
Terraform uses mock provider during tests.
Tests check resource state and outputs.
No real infrastructure is created.

Full Transcript

This visual execution shows how Terraform uses mock providers in tests. First, Terraform config defines the mock provider. When tests run, Terraform initializes with the mock provider, which simulates resource creation by returning fake IDs and attributes. The Terraform state updates in memory without creating real cloud resources. Tests then assert expected outputs from the mock resource. If outputs match, tests pass; otherwise, they fail. After tests, the mock environment resets. This approach allows safe, fast testing of Terraform code without real infrastructure changes.