aztfmod/terraform-provider-azurecaf/terraform-mock-test-2

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. Lifecycle consistency check

After terraform test passes, verify plan→apply→plan consistency using a separate lifecycle test:

cd /tmp/azurecaf-test-<resource_name>
TF_CLI_CONFIG_FILE=/tmp/azurecaf-test-<resource_name>/terraform.rc terraform plan -out=tfplan
TF_CLI_CONFIG_FILE=/tmp/azurecaf-test-<resource_name>/terraform.rc terraform apply tfplan
TF_CLI_CONFIG_FILE=/tmp/azurecaf-test-<resource_name>/terraform.rc terraform plan

The final terraform plan must report "No changes". If it shows changes, there is a plan-apply inconsistency that must be fixed before proceeding.

Also verify that result is visible during the first plan (not showing (known after apply)) when random_seed is set.

8. Clean up

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