terraform-mock-test - SKILL.md Agent Skill

name: terraform-mock-test description: "Validate a resource definition end-to-end using terraform test with mock_provider azurerm. Proves the CAF-generated name is accepted by the azurerm provider schema without Azure credentials. Use after provider-build-test succeeds to run the mocked azurerm integration test."

Terraform Mock Test

Prerequisites

Successfully built terraform-provider-azurecaf binary (from provider-build-test skill)
Resource entry in resourceDefinition.json with known min_length, max_length, validation_regex

Procedure

1. Install provider locally

GOOS=$(go env GOOS) GOARCH=$(go env GOARCH)
LOCAL_PLUGIN_DIR=~/.terraform.d/plugins/aztfmod.com/arnaudlh/azurecaf/1.0.0/${GOOS}_${GOARCH}
mkdir -p "$LOCAL_PLUGIN_DIR"
cp ./terraform-provider-azurecaf "$LOCAL_PLUGIN_DIR/"

2. Look up azurerm resource attributes

Use Terraform MCP get_provider_details (provider_name: azurerm, provider_namespace: hashicorp, provider_document_type: resources, resource_name: <resource_name>).

Extract only Required arguments and Required nested blocks. Do NOT use Context7.

3. Create test directory

mkdir -p /tmp/azurecaf-test-<resource_name>/tests

4. Create test files

See references/test-templates.md for the main.tf, terraform.rc, and tests/validate_name.tftest.hcl templates.

Key rules:

Use aztfmod/azurecaf as provider source (not aztfmod.com/arnaudlh/azurecaf)
Use hardcoded fake Azure resource IDs for parent references — do NOT chain azurerm resources
The azurerm resource MUST set name = azurecaf_name.test.result

5. Run test

cd /tmp/azurecaf-test-<resource_name>
terraform init   # downloads azurerm provider schema
TF_CLI_CONFIG_FILE=/tmp/azurecaf-test-<resource_name>/terraform.rc terraform test -verbose

Always use -verbose to show generated name, resource state, and output values.

6. Validate results

The Outputs: section must show non-empty result and result_length. If empty, assertions are not using output.result — fix them.

7. Clean up

rm -rf /tmp/azurecaf-test-<resource_name>