terraform-test

terraform-test 技能總覽

terraform-test 是一套 Terraform 測試技能，專門用來撰寫 .tftest.hcl 情境、檢查模組行為，並在不靠猜 syntax 或工作流程的情況下驗證基礎設施設定邏輯。它特別適合想找一份實用 terraform-test 指南的人，用來處理 test files、run blocks、assertions 與 mocks，尤其當目標是在合併前把 Terraform 變更做得更安全。

terraform-test 適合做什麼

當你需要驗證 outputs、resource arguments、conditional logic 或環境相關行為時，就該用 terraform-test 技能。對 module 作者、平台團隊與審查者來說，它尤其有用，因為它提供的是可重複執行的檢查，而不是手動看 plan。

terraform-test 在 Terraform 工作流程中的位置

這個技能適合放在 terraform init 和 terraform validate 之後、CI 執行之前或同時使用。它能把原本模糊的配置意圖轉成明確的測試案例，並依你要證明的內容，選擇用 plan mode 或 apply mode 執行。

terraform-test 的主要差異化

terraform-test 的核心價值，在於它聚焦的是 Terraform 原生測試，而不是泛用的提示詞建議。它涵蓋測試結構、assertion 寫法、Terraform 1.7+ 的 mock provider 用法，以及適合 CI 的執行方式，讓使用者能更快從「我想應該可行」走到具體可用的 test file。

如何使用 terraform-test 技能

安裝並開啟正確的檔案

先用 npx skills add hashicorp/agent-skills --skill terraform-test 安裝。接著先讀 SKILL.md，再看 references/EXAMPLES.md 了解完整的 test suite 模式；需要 mocked unit tests 時看 references/MOCK_PROVIDERS.md；要做 pipeline 執行時則看 references/CI_CD.md。

給技能一個可測試的目標

好的提示詞會直接點出 module、行為，以及預期結果。例如：「為一個 VPC module 寫一個 .tftest.hcl 檔，檢查 public subnet 數量、private subnet routing，並在 plan mode 驗證 output values。」這會比單純說「加測試」更有效，因為技能可以立刻把需求對應到 run blocks 與 assertions。

使用正確的輸入格式

這個技能最適合在你提供 Terraform 版本、provider constraints、module inputs，以及必須被證明的內容時使用。如果你要用 mock providers，請明確說出來並確認是 Terraform 1.7+；如果你要做真實整合覆蓋，則要包含目標雲端、任何 credentials，或 CI 假設條件。

先從工作流程開始，不要先空白建檔

實際可行的 terraform-test 使用流程是：先確認要驗證的行為，選擇 plan 或 apply，再決定是否允許 mocks，最後為每個情境寫一個 run block。先讀 references/EXAMPLES.md 看整體測試版型，再依你的 repository 慣例調整變數、assertions 與檔名。

terraform-test 技能 FAQ

terraform-test 只適合測試模組嗎？

不是。它對 module 最強，但也同樣能幫助 root configurations、output validation、provider 行為檢查，以及 CI 測試執行。如果你需要的是 Terraform 原生驗證，這個技能很合適。

什麼時候不該用 terraform-test？

如果你只是想要一次性的 terraform plan 說明，或你的 stack 無法在 CI 中執行 Terraform tests，就可以先不要用它。另外，如果你使用的是 Terraform 1.7 之前的版本，也不要套用 mock-provider 的做法，因為那部分工作流程不適用。

terraform-test 會比手寫提示詞更容易嗎？

通常會，因為它把任務收斂到 Terraform 真正的 test syntax 與 file structure。一般提示詞可能只產生泛泛建議；terraform-test 技能的重點是產出可直接使用的 test cases，尤其適合 run blocks 和 assertions。

terraform-test 可用於 Code Generation 任務嗎？

可以。當你想產生符合某個 module interface 與預期行為的 test files 時，terraform-test for Code Generation 很有幫助。主要界線在於：生成出來的 tests 仍然需要真實 inputs、合理的 assertions，以及明確決定要涵蓋 plan 還是 apply。

如何改進 terraform-test 技能

提供具體的 module 資訊

輸入越具體，測試通常越好。請提供 variable names、必要的 outputs、resource names、provider aliases，以及你在意的不變條件，例如「public subnets 必須是 2 個」或「instance type 預設必須是 t3.micro」。

明確告訴技能哪些可以被 mock

最常見的品質提升，就是說清楚 provider calls 應該用 mocked 還是 real。對 terraform-test 的安裝與採用決策來說，這很重要，因為 mocks 可以減少 credentials 需求並加快 unit tests，但它們只適用於 plan mode，也可能掩蓋 provider-specific behavior。

將 unit、integration 與 regression case 分開

當行為彼此不同時，請要求分開的 test scenarios，不要把所有內容塞進同一個大檔案。清楚的 terraform-test 指南通常會把快速的 plan-mode 檢查與較慢的 integration 檢查分開，這樣 CI 會更簡潔，失敗訊號也更容易讀。

根據失敗結果迭代，不要根據假設調整

第一次執行後，請回頭修正那些太弱、太寬，或綁在不穩定值上的 assertions。如果測試失敗是因為 computed attributes，請改成更穩定的檢查；如果 module 的變更是刻意的，就更新預期條件，不要把測試放寬到最後失去意義。