Run Acceptance Tests

Guide for running acceptance tests for a Terraform provider. Use this when asked to run an acceptance test or to run a test with the prefix `TestAcc`.

lidge-jun Updated 5 repo stars

File contents

An acceptance test is a Go test function with the prefix TestAcc.

To run a focused acceptance test named TestAccFeatureHappyPath:

  1. Run go test -run=TestAccFeatureHappyPath with TF_ACC=1. Default to non-verbose output.
  2. Some providers require additional environment variables. If the test output reports missing variables, suggest secure setup steps.

To diagnose a failing test, apply these options cumulatively (each includes the previous):

  1. Re-run with -count=1 to bypass the Go test cache.
  2. Add -v for verbose output.
  3. Set TF_LOG=debug for debug-level logging.
  4. Set TF_ACC_WORKING_DIR_PERSIST=1 to preserve the Terraform workspace for inspection.

A passing test may be a false negative. To "flip" a passing test:

  1. Edit a TestCheckFunc value in a TestStep of the TestCase.
  2. Run the test — expect failure.
  3. If it fails, undo the edit and report a successful flip. If it passes, keep the edit and report an unsuccessful flip.

lidge-jun/cli-jaw-skills commit e51c1cbef3

Frequently asked questions

npx get-skill add lidge-jun/run-acceptance-tests