1. 模块仓库概述：什么是 Terraform 模块仓库、模块仓库的价值、服务目录的概念与目标

1.1 什么是 Terraform 模块仓库

Terraform 模块仓库是一个集中存储、版本管理和分发 Terraform 模块的中央化平台。它不仅仅是存放代码的 Git 仓库，更是一套包含模块注册、版本控制、依赖解析和文档自动生成的完整基础设施。

在 Terraform 生态中，模块是封装了特定基础设施资源（如 VPC、ECS 集群、RDS 实例）的可复用代码单元。模块仓库将这些模块从零散的本地目录提升为组织级的共享资产。

1.2 模块仓库的价值

模块仓库为团队和平台工程带来四个关键价值维度：

1.3 服务目录的概念与目标

服务目录（Service Catalog）是模块仓库的更高阶抽象。它不再只提供原始模块代码，而是将模块包装成“服务产品”，附带预定义的输入参数、合规策略、定价模型和自助服务门户。

服务目录的核心目标可以归纳为以下五点：

1. 自助服务： 开发者无需了解 Terraform 语法，通过 Web 界面或 API 即可申请基础设施。
2. 治理嵌入： 在模板层强制绑定 IAM 策略、加密配置、网络隔离等安全基线。
3. 成本管控： 预定义资源规格（如仅允许 t3.medium 以下实例），防止资源超配。
4. 生命周期管理： 支持服务产品的发布、弃用、退役全流程。
5. 多环境一致性： 开发、测试、生产环境使用同一服务目录版本，消除环境差异。

1.4 模块仓库与服务目录的关系

下图展示了从模块仓库到服务目录的演进路径，以及两者在组织中的定位：

1.5 典型模块仓库架构

一个生产级的 Terraform 模块仓库通常包含以下组件：

• 模块存储层： Git 仓库（GitHub/GitLab/Bitbucket），每个模块独立仓库或 monorepo 子目录。
• 版本管理层： 语义化版本标签（v1.2.3），配合 Git tag 或 GitHub Release。
• 注册表层： Terraform Registry（公有或私有），提供模块搜索、版本浏览、输入输出文档。
• 测试层： Terratest / Kitchen-Terraform 自动化测试，确保模块质量。
• 文档层： terraform-docs 自动生成 README，保持文档与代码同步。

1.6 服务目录的典型工作流

服务目录在组织中的典型使用流程如下：

1. 平台团队 编写并测试 Terraform 模块，发布到模块仓库。
2. 平台团队 将模块包装为服务产品，配置默认参数、合规策略、配额限制。
3. 应用团队 通过服务目录门户选择所需服务（如“创建标准 VPC”），填写业务参数。
4. 服务目录引擎 自动生成 Terraform 配置，触发 CI/CD 流水线执行部署。
5. 部署完成后，资源信息回写至 CMDB 或成本管理平台。

下表对比了传统方式与服务目录方式的关键差异：