Terraform 测试

Name: Terraform 测试
Author: tomevault-io

运维部署社区

作者仓库星标 0
作者更新于实时读取
作者仓库 skills-registry

流狐档案事实层信息：领域、Agent、信任分、运行环境、权限与网络

领域: 运维部署
兼容 Agent: Claude Code
Cursor
Cline
Codex
Windsurf
Gemini CLI

+20
信任分: 88 / 100 · 社区维护
作者 / 版本 / 许可: @tomevault-io · 未声明 license
Token 消耗评级: 低消耗
接入复杂程度: 需简单配置
是否需要外部 API Key: 不需要
兼容的系统: 未声明（默认跨平台）
底层运行要求: 无特殊要求
文件与系统权限: 只读
允许写入 / 修改
Shell 执行
网络行为: 仅限本地
安装命令数: 26 条

档案由构建时根据 SKILL.md 与安装命令自动衍生，可能与作者实际意图存在差异。

需要注意： 未限定 allowed-tools，默认拥有全部工具权限。

输出预览 terraform-test.preview

---
name: terraform-test
description: **WORKFLOW SKILL** — Write and run Terraform tests (.tftest.hcl). WHEN: "create terraform test"…
category: 运维部署
runtime: 无特殊运行时
---

# terraform-test 输出预览

## PART A: 任务判断
- 适用问题：部署、CI、环境检查、发布或运维排障。
- 输入要求：目标材料、限制条件、期望输出和验收方式。
- 证据边界：围绕“Quick Reference / File Structure / Test File Components”读取原文规则，不把推断写成作者承诺。

## PART B: 执行结果
- **01** 任务判断：确认你的需求是否属于部署、CI、环境检查、发布或运维排障，并标出输入、限制和预期结果。
- **02** 执行计划：优先按“Quick Reference / File Structure / Test File Components”拆成步骤，说明每一步会读取什么、修改什么、产出什么。
- **03** 交付结果：给出可复制的命令、文件改动、检查清单或内容草稿，并说明如何继续迭代。
- **04** 风险边界：结合 读取文件、写入/修改文件、执行终端命令、主要在本地完成、通常不需要额外 API Key 给出执行前确认项。

## Running Rules
- 读取文件、写入/修改文件、执行终端命令；主要在本地完成；通常不需要额外 API Key。
- 先小样例验证，再放大到真实任务。
- 交付时同时给结果、检查口径和下一步迭代建议。

SKILL.md SKILL.md

---
name: terraform-test
description: **WORKFLOW SKILL** — Write and run Terraform tests (.tftest.hcl). WHEN: "create terraform test"…
category: 运维部署
source: tomevault-io/skills-registry
---

# terraform-test

## 什么时候使用
- 用于组织测试、定位失败并形成修复闭环 适合处理部署、CI、发布、回滚、环境检查和运维排障，核心价值是把输入、判断、执行、验证和交付边界固定下来，避免 Agent 泛泛回答。 把任务拆成可执行、可检查、可继续迭代的步骤；通常不需要额外 A…
- 面向部署、CI、环境检查、发布或运维排障，优先处理能明确输入、步骤和验收标准的工作。

## 需要提供什么
- 目标材料、目录范围、期望结果和不可改动内容。
- 是否允许联网、执行命令、读写文件或调用外部服务。

## 执行规则
- 围绕「Quick Reference / File Structure / Test File Components」组织步骤，不把推断写成作者事实。
- 读取文件、写入/修改文件、执行终端命令；主要在本地完成；通常不需要额外 API Key。
- 先跑小样例，确认结果可检查后再扩大任务范围。

## 输出要求
- 给出最终产物、关键证据、验证方式和下一步动作。
- 信息不足时标记 unknown，不编造命令、平台或依赖。

证据边界与执行链路

作者原文负责流程事实；仓库文件负责来源和命令；流狐只补充适用场景、限制和质量判断。

skill "terraform-test" {
  输入层     -> 用户目标 + 目标文件 + 禁止范围 + 验收标准
  上下文层   -> Quick Reference / File Structure / Test File Components
  规则层     -> SKILL.md 触发条件 / 执行顺序 / 输出格式
  运行层     -> 无特殊运行时 | 读取文件、写入/修改文件、执行终端命令 | 主要在本地完成
  安全层     -> 通常不需要额外 API Key + 小任务验证 + diff / 日志复核
  输出层     -> 可复制结果 + 检查清单 + 下一步迭代
}

解读按原文结构重写，命令、链接、术语均保留；右侧可核对作者原始 SKILL.md

先判断是否适合

核心用途：用于组织测试、定位失败并形成修复闭环适合处理部署、CI、发布、回滚、环境检查和运维排障，核心价值是把输入、判断、执行、验证和交付边界固定下来，避免 Agent 泛泛回答。把任务拆成可执行、可检查、可继续迭代的步骤；通常不需要额外 API Key，适合先…
适用任务：更适合部署、CI、发布、回滚、环境检查和运维排障，尤其是输入、步骤、验收口径可以反复复用的场景。
不宜硬套：如果任务只有一次性问答、来源材料很少，或需要作者没有说明的命令和外部服务，应先降级为普通对话。

作者设计意图

触发依据：使用时机、上下文收集、输出格式和失败处理共同决定它是否适合当前任务。
来源边界：作者原文负责事实，仓库文件负责命令和文件证据；Fluxly 只补充用途、限制和使用判断。

作者的方法与取舍

执行主线：任务围绕「Quick Reference / File Structure / Test File Components」组织，把触发条件、必要上下文、执行规则和交付标准连成一条可复核的链路。
设计重点：重点不在重复教程，而在解释作者为什么规定这些步骤、哪些条件不可省略，以及结果偏离时应回到哪一层检查。
使用判断：先确认任务与原文边界一致，再决定是否启用；来源没有说明的命令、平台和依赖保持未知，不由 Fluxly 补写。

边界和复核

依赖条件：通常不需要额外 API Key，适合先用小任务验证触发是否稳定。
权限提醒：会涉及 read / write / shell-exec 权限，执行前要说明可读写范围、命令边界和回退方式。
质量标准：结果应包含明确产物、必要证据和下一步动作；如果只是泛泛解释，需要补充输入和验收条件后重跑。

Terraform Test Skill

Write, organize, and run Terraform's built-in test framework for Azure infrastructure modules.

Reference: Terraform Testing Documentation

Quick Reference

Concept	Description	Min Version
Test file	`.tftest.hcl` in `tests/` directory	1.6
Run block	Single test scenario with assertions	1.6
Assert block	Condition that must be true for test to pass	1.6
Plan mode	`command = plan` — validates logic, no resources created	1.6
Apply mode	`command = apply` (default) — creates real infrastructure	1.6
Mock provider	Simulates provider without real API calls	1.7
Parallel execution	`parallel = true` on independent run blocks	1.9
Expect failures	Verify validation rules reject invalid input	1.6

File Structure

my-module/
├── main.tf
├── variables.tf
├── outputs.tf
└── tests/
    ├── defaults_unit_test.tftest.hcl        # Plan mode (fast)
    ├── validation_unit_test.tftest.hcl      # Plan mode (fast)
    └── full_stack_integration_test.tftest.hcl  # Apply mode (creates resources)

Naming convention: *_unit_test.tftest.hcl (plan mode), *_integration_test.tftest.hcl (apply mode).

Test File Components

0–1 test block (test-wide settings)
1+ run blocks (test scenarios, sequential by default)
0–1 variables block (file-level inputs, highest precedence)
0+ provider blocks (provider configuration)
0+ mock_provider blocks (simulated providers, TF 1.7+)

Canonical Example

See references/test-examples.md for a complete Azure Resource Group test (unit tests, tag validation, expect_failures).

Key Syntax Rules

Run Block Attributes

Attribute	Type	Default	Description
`command`	`plan`/`apply`	`apply`	Test mode
`variables`	block	—	Override file-level variables
`module`	block	—	Test alternate module (local/registry only)
`assert`	block (1+)	—	Validation conditions
`expect_failures`	list	—	Expected validation failures

Assert Syntax

assert {
  condition     = <boolean expression>
  error_message = "Human-readable failure description"
}

Assertions can reference: resource attributes, outputs, run.<name>.<output>, var.*, data sources. Variables precedence: run-block > file-level > all other sources. See references/test-examples.md for module blocks, plan options, and prior run references.

Mock Providers (TF 1.7+)

Simulate Azure provider without API calls — ideal for unit tests. Use mock_provider "azurerm" with mock_resource and mock_data blocks. When to use: Unit tests, CI without Azure credentials, fast local development. When NOT to use: Integration tests, validating actual Azure API behavior. See references/mock-providers.md for full mock patterns and examples.

Common Test Patterns

See references/test-examples.md for: conditional resources, tag validation, resource count with for_each, variables precedence, and prior run references.

Steps

terraform test                              # All tests
terraform test tests/defaults.tftest.hcl    # Specific file
terraform test -verbose                     # Detailed output
terraform test -filter=test_resource_group  # Filter by name
terraform test -no-cleanup                  # Debug: keep resources

Rules

Naming: *_unit_test.tftest.hcl / *_integration_test.tftest.hcl
Plan mode first: Use command = plan for fast, cost-free validation
Clear error messages: Describe what went wrong and expected state
Test isolation: Independent run blocks where possible
Variable coverage: Test multiple combinations for all code paths
Mock for speed: Use mock providers in CI without Azure access
Negative testing: Use expect_failures for validation rule coverage
Sequential only when needed: Only chain run blocks via run.<name> when required

Terraform MCP Integration

Use mcp_terraform_search_providers to validate that resource types used in test assertions exist in the target provider version.

Reference Index

File	Contents
`references/test-examples.md`	Canonical example, common patterns, variables, module blocks
`references/test-patterns.md`	Unit vs integration patterns, CI/CD examples, complex assertions
`references/mock-providers.md`	Mock provider setup, mock resources/data sources, override files
`references/test-execution.md`	CLI commands, parallel execution, verbose/debug, diagnostics

Source: aivandelindt/azure-agentic-infraops — distributed by TomeVault.

安装命令

一键复制安装选择包管理器,点击右侧复制,粘贴到终端回车即可

npx skills add tomevault-io/skills-registry/aivandelindt--azure-agentic-infraops--terraform-test -y

查看通用安装教程

查看 Skill 原文

兼容工具

Claude Code
Cursor
Cline
Codex
Windsurf
Gemini
OpenCode
Roo Code
AAide
+Augment
GitHub Copilot
OpenClaw
KKiro
Junie
WWarp
Goose
Trae
Kilo Code
OpenHands
Amp
Zencoder
CContinue
AIAider
CodeBuddy
CodeGeeX
Replit Agent

安全审计

88 / 100

社区

未声明 license/许可。
未声明 version。
未限定 allowed-tools，默认拥有全部工具权限。

元信息

来源: github
tomevault-io/skills-registry
English

@tomevault-io 的其他技能

分类与标签

分类运维部署