run-acceptance-tests

Execute and debug Terraform provider acceptance tests written in Go.

5|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/lidge-jun/cli-jaw-skills --skill run-acceptance-tests-lidge-jun
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-acceptance-tests
Source: https://github.com/lidge-jun/cli-jaw-skills/tree/main/terraform/provider-development/skills/run-acceptance-tests
Command: npx skills add https://github.com/lidge-jun/cli-jaw-skills --skill run-acceptance-tests-lidge-jun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured guide for running and debugging acceptance tests for Terraform providers, ensuring the reliability and correctness of infrastructure code.

Core Features & Use Cases

  • Focused Test Execution: Run specific acceptance tests using Go's testing framework.
  • Debugging Assistance: Offers progressive steps for diagnosing failing tests, including verbose output and debug logging.
  • Workspace Persistence: Option to keep the Terraform workspace for deeper inspection.
  • Use Case: When a Terraform provider's acceptance test fails, use this Skill to systematically identify the root cause and fix the issue.

Quick Start

Run the acceptance test named TestAccFeatureHappyPath with the environment variable TF_ACC=1.

Frequently Asked Questions about run-acceptance-tests

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Terraform provider acceptance tests using Go?

Run Terraform provider acceptance tests by executing Go's testing framework with the environment variable TF_ACC=1 to activate the acceptance test mode for your provider code.

Can I execute a focused Terraform acceptance test instead of the full suite?

Yes, focused test execution allows you to run specific acceptance tests using Go's testing framework, targeting individual test cases like TestAccFeatureHappyPath rather than the entire provider suite.

How do I debug a failing Terraform provider acceptance test?

Debug failing Terraform provider acceptance tests by enabling verbose output and activating debug logging to systematically diagnose the root cause and inspect the test execution details.

Can I keep the Terraform workspace after an acceptance test run for inspection?

Yes, you can persist the Terraform workspace after acceptance test execution to keep the generated infrastructure state files for deeper diagnostic inspection and troubleshooting.

Why do my Terraform provider acceptance tests fail to run without TF_ACC set?

Terraform provider acceptance tests require the TF_ACC=1 environment variable to run because it explicitly opts into the potentially destructive operations needed to validate real infrastructure changes.

What environment setup is required to run Terraform provider acceptance tests?

Running Terraform provider acceptance tests requires a Go development environment with the provider source code, alongside valid cloud provider credentials to provision and destroy real infrastructure resources.