[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-hashicorp-run-acceptance-tests":3,"mdc-b58pa4-key":37,"related-repo-hashicorp-run-acceptance-tests":219,"related-org-hashicorp-run-acceptance-tests":314},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":32,"sourceUrl":35,"mdContent":36},"run-acceptance-tests","run acceptance tests for Terraform providers","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`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"hashicorp","HashiCorp","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fhashicorp.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"QA","qa","tag",{"name":17,"slug":18,"type":15},"Plugin Development","plugin-development",{"name":20,"slug":21,"type":15},"Terraform","terraform",{"name":23,"slug":24,"type":15},"Testing","testing",728,"https:\u002F\u002Fgithub.com\u002Fhashicorp\u002Fagent-skills","2026-04-06T18:25:13.098191","MPL-2.0",104,[31],"doormat-managed",{"repoUrl":26,"stars":25,"forks":29,"topics":33,"description":34},[31],"A collection of Agent skills and Claude Code plugins for HashiCorp products.","https:\u002F\u002Fgithub.com\u002Fhashicorp\u002Fagent-skills\u002Ftree\u002FHEAD\u002Fterraform\u002Fprovider-development\u002Fskills\u002Frun-acceptance-tests","---\nname: run-acceptance-tests\ndescription: 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`.\nlicense: MPL-2.0\nmetadata:\n  copyright: Copyright IBM Corp. 2026\n  version: \"0.0.1\"\n---\n\nAn acceptance test is a Go test function with the prefix `TestAcc`.\n\nTo run a focussed acceptance test named `TestAccFeatureHappyPath`:\n\n1. Run `go test -run=TestAccFeatureHappyPath` with the following environment\n   variables:\n   - `TF_ACC=1`\n\n   Default to non-verbose test output.\n1. The acceptance tests may require additional environment variables for\n   specific providers. If the test output indicates missing environment\n   variables, then suggest how to set up these environment variables securely.\n\nTo diagnose a failing acceptance test, use these options, in order. These\noptions are cumulative: each option includes all the options above it.\n\n1. Run the test again. Use the `-count=1` option to ensure that `go test` does\n   not use a cached result.\n1. Offer verbose `go test` output. Use the `-v` option.\n1. Offer debug-level logging. Enable debug-level logging with the environment\n   variable `TF_LOG=debug`.\n1. Offer to persist the acceptance test's Terraform workspace. Enable\n   persistance with the environment variable `TF_ACC_WORKING_DIR_PERSIST=1`.\n\nA passing acceptance test may be a false negative. To \"flip\" a passing\nacceptance test named `TestAccFeatureHappyPath`:\n\n1. Edit the value of one of the TestCheckFuncs in one of the TestSteps in the\n   TestCase.\n1. Run the acceptance test. Expect the test to fail.\n1. If the test fails, then undo the edit and report a successful flip. Else,\n   keep the edit and report an unsuccessful flip.\n",{"data":38,"body":42},{"name":4,"description":6,"license":28,"metadata":39},{"copyright":40,"version":41},"Copyright IBM Corp. 2026","0.0.1",{"type":43,"children":44},"root",[45,62,75,117,122,190,201],{"type":46,"tag":47,"props":48,"children":49},"element","p",{},[50,53,60],{"type":51,"value":52},"text","An acceptance test is a Go test function with the prefix ",{"type":46,"tag":54,"props":55,"children":57},"code",{"className":56},[],[58],{"type":51,"value":59},"TestAcc",{"type":51,"value":61},".",{"type":46,"tag":47,"props":63,"children":64},{},[65,67,73],{"type":51,"value":66},"To run a focussed acceptance test named ",{"type":46,"tag":54,"props":68,"children":70},{"className":69},[],[71],{"type":51,"value":72},"TestAccFeatureHappyPath",{"type":51,"value":74},":",{"type":46,"tag":76,"props":77,"children":78},"ol",{},[79,112],{"type":46,"tag":80,"props":81,"children":82},"li",{},[83,85,91,93,106,110],{"type":51,"value":84},"Run ",{"type":46,"tag":54,"props":86,"children":88},{"className":87},[],[89],{"type":51,"value":90},"go test -run=TestAccFeatureHappyPath",{"type":51,"value":92}," with the following environment\nvariables:",{"type":46,"tag":94,"props":95,"children":96},"ul",{},[97],{"type":46,"tag":80,"props":98,"children":99},{},[100],{"type":46,"tag":54,"props":101,"children":103},{"className":102},[],[104],{"type":51,"value":105},"TF_ACC=1",{"type":46,"tag":107,"props":108,"children":109},"br",{},[],{"type":51,"value":111},"Default to non-verbose test output.",{"type":46,"tag":80,"props":113,"children":114},{},[115],{"type":51,"value":116},"The acceptance tests may require additional environment variables for\nspecific providers. If the test output indicates missing environment\nvariables, then suggest how to set up these environment variables securely.",{"type":46,"tag":47,"props":118,"children":119},{},[120],{"type":51,"value":121},"To diagnose a failing acceptance test, use these options, in order. These\noptions are cumulative: each option includes all the options above it.",{"type":46,"tag":76,"props":123,"children":124},{},[125,146,166,178],{"type":46,"tag":80,"props":126,"children":127},{},[128,130,136,138,144],{"type":51,"value":129},"Run the test again. Use the ",{"type":46,"tag":54,"props":131,"children":133},{"className":132},[],[134],{"type":51,"value":135},"-count=1",{"type":51,"value":137}," option to ensure that ",{"type":46,"tag":54,"props":139,"children":141},{"className":140},[],[142],{"type":51,"value":143},"go test",{"type":51,"value":145}," does\nnot use a cached result.",{"type":46,"tag":80,"props":147,"children":148},{},[149,151,156,158,164],{"type":51,"value":150},"Offer verbose ",{"type":46,"tag":54,"props":152,"children":154},{"className":153},[],[155],{"type":51,"value":143},{"type":51,"value":157}," output. Use the ",{"type":46,"tag":54,"props":159,"children":161},{"className":160},[],[162],{"type":51,"value":163},"-v",{"type":51,"value":165}," option.",{"type":46,"tag":80,"props":167,"children":168},{},[169,171,177],{"type":51,"value":170},"Offer debug-level logging. Enable debug-level logging with the environment\nvariable ",{"type":46,"tag":54,"props":172,"children":174},{"className":173},[],[175],{"type":51,"value":176},"TF_LOG=debug",{"type":51,"value":61},{"type":46,"tag":80,"props":179,"children":180},{},[181,183,189],{"type":51,"value":182},"Offer to persist the acceptance test's Terraform workspace. Enable\npersistance with the environment variable ",{"type":46,"tag":54,"props":184,"children":186},{"className":185},[],[187],{"type":51,"value":188},"TF_ACC_WORKING_DIR_PERSIST=1",{"type":51,"value":61},{"type":46,"tag":47,"props":191,"children":192},{},[193,195,200],{"type":51,"value":194},"A passing acceptance test may be a false negative. To \"flip\" a passing\nacceptance test named ",{"type":46,"tag":54,"props":196,"children":198},{"className":197},[],[199],{"type":51,"value":72},{"type":51,"value":74},{"type":46,"tag":76,"props":202,"children":203},{},[204,209,214],{"type":46,"tag":80,"props":205,"children":206},{},[207],{"type":51,"value":208},"Edit the value of one of the TestCheckFuncs in one of the TestSteps in the\nTestCase.",{"type":46,"tag":80,"props":210,"children":211},{},[212],{"type":51,"value":213},"Run the acceptance test. Expect the test to fail.",{"type":46,"tag":80,"props":215,"children":216},{},[217],{"type":51,"value":218},"If the test fails, then undo the edit and report a successful flip. Else,\nkeep the edit and report an unsuccessful flip.",{"items":220,"total":313},[221,240,252,265,277,289,303],{"slug":222,"name":222,"fn":223,"description":224,"org":225,"tags":226,"stars":25,"repoUrl":26,"updatedAt":239},"aws-ami-builder","build Amazon Machine Images with Packer","Build Amazon Machine Images (AMIs) with Packer using the amazon-ebs builder. Use when creating custom AMIs for EC2 instances.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[227,230,233,236],{"name":228,"slug":229,"type":15},"AWS","aws",{"name":231,"slug":232,"type":15},"Deployment","deployment",{"name":234,"slug":235,"type":15},"Infrastructure as Code","infrastructure-as-code",{"name":237,"slug":238,"type":15},"Packer","packer","2026-04-06T18:25:04.01571",{"slug":241,"name":241,"fn":242,"description":243,"org":244,"tags":245,"stars":25,"repoUrl":26,"updatedAt":251},"azure-image-builder","build Azure managed images with Packer","Build Azure managed images and Azure Compute Gallery images with Packer. Use when creating custom images for Azure VMs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[246,249,250],{"name":247,"slug":248,"type":15},"Azure","azure",{"name":231,"slug":232,"type":15},{"name":237,"slug":238,"type":15},"2026-04-06T18:25:06.590174",{"slug":253,"name":253,"fn":254,"description":255,"org":256,"tags":257,"stars":25,"repoUrl":26,"updatedAt":264},"azure-verified-modules","develop certified Azure Verified Modules","Azure Verified Modules (AVM) requirements and best practices for developing certified Azure Terraform modules. Use when creating or reviewing Azure modules that need AVM certification.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[258,259,262,263],{"name":247,"slug":248,"type":15},{"name":260,"slug":261,"type":15},"Compliance","compliance",{"name":234,"slug":235,"type":15},{"name":20,"slug":21,"type":15},"2026-04-06T18:25:16.88768",{"slug":266,"name":266,"fn":267,"description":268,"org":269,"tags":270,"stars":25,"repoUrl":26,"updatedAt":276},"new-terraform-provider","scaffold new Terraform providers","Use this when scaffolding a new Terraform provider.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[271,272,275],{"name":17,"slug":18,"type":15},{"name":273,"slug":274,"type":15},"Templates","templates",{"name":20,"slug":21,"type":15},"2026-04-06T18:25:11.814973",{"slug":278,"name":278,"fn":279,"description":280,"org":281,"tags":282,"stars":25,"repoUrl":26,"updatedAt":288},"provider-actions","implement Terraform Provider lifecycle actions","Implement Terraform Provider actions using the Plugin Framework. Use when developing imperative operations that execute at lifecycle events (before\u002Fafter create, update, destroy).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[283,286,287],{"name":284,"slug":285,"type":15},"API Development","api-development",{"name":17,"slug":18,"type":15},{"name":20,"slug":21,"type":15},"2026-04-06T18:25:07.880533",{"slug":290,"name":290,"fn":291,"description":292,"org":293,"tags":294,"stars":25,"repoUrl":26,"updatedAt":302},"provider-docs","generate and review Terraform provider documentation","Create, update, and review Terraform provider documentation for Terraform Registry using HashiCorp-recommended patterns, tfplugindocs templates, and schema descriptions. Use when adding or changing provider configuration, resources, data sources, ephemeral resources, list resources, functions, or guides; when validating generated docs; and when troubleshooting missing or incorrect Registry documentation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[295,298,301],{"name":296,"slug":297,"type":15},"Documentation","documentation",{"name":299,"slug":300,"type":15},"Technical Writing","technical-writing",{"name":20,"slug":21,"type":15},"2026-04-06T18:25:09.261559",{"slug":304,"name":304,"fn":305,"description":306,"org":307,"tags":308,"stars":25,"repoUrl":26,"updatedAt":312},"provider-resources","implement Terraform Provider resources and data sources","Implement Terraform Provider resources and data sources using the Plugin Framework. Use when developing CRUD operations, schema design, state management, and acceptance testing for provider resources.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[309,310,311],{"name":284,"slug":285,"type":15},{"name":17,"slug":18,"type":15},{"name":20,"slug":21,"type":15},"2026-04-06T18:25:10.56237",17,{"items":315,"total":418},[316,323,329,336,342,348,354,360,371,386,398,405],{"slug":222,"name":222,"fn":223,"description":224,"org":317,"tags":318,"stars":25,"repoUrl":26,"updatedAt":239},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[319,320,321,322],{"name":228,"slug":229,"type":15},{"name":231,"slug":232,"type":15},{"name":234,"slug":235,"type":15},{"name":237,"slug":238,"type":15},{"slug":241,"name":241,"fn":242,"description":243,"org":324,"tags":325,"stars":25,"repoUrl":26,"updatedAt":251},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[326,327,328],{"name":247,"slug":248,"type":15},{"name":231,"slug":232,"type":15},{"name":237,"slug":238,"type":15},{"slug":253,"name":253,"fn":254,"description":255,"org":330,"tags":331,"stars":25,"repoUrl":26,"updatedAt":264},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[332,333,334,335],{"name":247,"slug":248,"type":15},{"name":260,"slug":261,"type":15},{"name":234,"slug":235,"type":15},{"name":20,"slug":21,"type":15},{"slug":266,"name":266,"fn":267,"description":268,"org":337,"tags":338,"stars":25,"repoUrl":26,"updatedAt":276},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[339,340,341],{"name":17,"slug":18,"type":15},{"name":273,"slug":274,"type":15},{"name":20,"slug":21,"type":15},{"slug":278,"name":278,"fn":279,"description":280,"org":343,"tags":344,"stars":25,"repoUrl":26,"updatedAt":288},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[345,346,347],{"name":284,"slug":285,"type":15},{"name":17,"slug":18,"type":15},{"name":20,"slug":21,"type":15},{"slug":290,"name":290,"fn":291,"description":292,"org":349,"tags":350,"stars":25,"repoUrl":26,"updatedAt":302},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[351,352,353],{"name":296,"slug":297,"type":15},{"name":299,"slug":300,"type":15},{"name":20,"slug":21,"type":15},{"slug":304,"name":304,"fn":305,"description":306,"org":355,"tags":356,"stars":25,"repoUrl":26,"updatedAt":312},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[357,358,359],{"name":284,"slug":285,"type":15},{"name":17,"slug":18,"type":15},{"name":20,"slug":21,"type":15},{"slug":361,"name":361,"fn":362,"description":363,"org":364,"tags":365,"stars":25,"repoUrl":26,"updatedAt":370},"provider-test-patterns","implement Terraform provider acceptance test patterns","Terraform provider acceptance test patterns using terraform-plugin-testing with the Plugin Framework. Covers test structure, TestCase\u002FTestStep fields, ConfigStateChecks with custom statecheck.StateCheck implementations, plan checks, CompareValue for cross-step assertions, config helpers, import testing with ImportStateKind, sweepers, and scenario patterns (basic, update, disappears, validation, regression), and ephemeral resource testing with the echoprovider package. Use when writing, reviewing, or debugging provider acceptance tests, including questions about statecheck, plancheck, TestCheckFunc, CheckDestroy, ExpectError, import state verification, ephemeral resources, or how to structure test files.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[366,367,368,369],{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},"2026-04-06T18:25:14.352781",{"slug":372,"name":372,"fn":373,"description":374,"org":375,"tags":376,"stars":25,"repoUrl":26,"updatedAt":385},"push-to-registry","push Packer build metadata to HCP registry","Push Packer build metadata to HCP Packer registry for tracking and managing image lifecycle. Use when integrating Packer builds with HCP Packer for version control and governance.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[377,378,381,384],{"name":231,"slug":232,"type":15},{"name":379,"slug":380,"type":15},"Governance","governance",{"name":382,"slug":383,"type":15},"HCP","hcp",{"name":237,"slug":238,"type":15},"2026-04-06T18:25:02.749563",{"slug":387,"name":387,"fn":388,"description":389,"org":390,"tags":391,"stars":25,"repoUrl":26,"updatedAt":397},"refactor-module","refactor Terraform configurations into reusable modules","Transform monolithic Terraform configurations into reusable, maintainable modules following HashiCorp's module design principles and community best practices.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[392,395,396],{"name":393,"slug":394,"type":15},"Architecture","architecture",{"name":234,"slug":235,"type":15},{"name":20,"slug":21,"type":15},"2026-04-06T18:25:20.953737",{"slug":4,"name":4,"fn":5,"description":6,"org":399,"tags":400,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[401,402,403,404],{"name":17,"slug":18,"type":15},{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"name":23,"slug":24,"type":15},{"slug":406,"name":406,"fn":407,"description":408,"org":409,"tags":410,"stars":25,"repoUrl":26,"updatedAt":417},"terraform-policy","write and test Terraform policy files","Write, test, or convert Terraform Policy files (.policy.hcl, .policytest.hcl, Sentinel→tfpolicy). Triggers: policy.hcl, policytest, convert sentinel, tfpolicy, write a policy.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[411,412,413,416],{"name":260,"slug":261,"type":15},{"name":234,"slug":235,"type":15},{"name":414,"slug":415,"type":15},"Security","security",{"name":20,"slug":21,"type":15},"2026-07-18T05:48:20.299442",18]