terraform-test

To write Terraform tests, create a tests/ directory and add a .tftest.hcl or .tftest.json file with at least one run block. You can define variables, assert outputs, and execute tests using the terraform test command to validate plan and apply scenarios.

Terraform unit testing validates the plan phase using mock providers to simulate infrastructure without deploying changes. Integration testing executes the apply phase to verify actual infrastructure behavior, ensuring dependencies and outputs function correctly in real scenarios.

Use the mock_provider block within your .tftest.hcl files to simulate infrastructure dependencies and isolate Terraform configurations. This allows you to assert planned outcomes and outputs without provisioning real cloud resources during unit tests.

Yes, run blocks in .tftest.hcl files execute specific modules or configuration files, allowing you to pass variables and assert outputs. This verifies that module dependencies and infrastructure behave as intended across different testing scenarios.

Yes, the terraform test command supports both .tftest.hcl and .tftest.json file formats. You can define test scenarios, run blocks, variables, and mock providers in either format to validate your infrastructure configurations.

If tests fail to catch regressions, ensure your .tftest.hcl files include comprehensive assertions for outputs and behaviors. Properly configure run blocks, variables, and mock providers to accurately simulate both plan and apply workflows.