1. 课程导论与目标：理解 Terraform Provider 的作用，明确本课程目标——为服务目录创建自定义 Provider

1.1 为什么需要理解 Terraform Provider？

Terraform 的核心能力在于通过声明式配置管理基础设施。而 Provider 正是连接 Terraform 与目标基础设施的桥梁。没有 Provider，Terraform 无法感知云平台、SaaS 服务或内部系统的存在。

在服务目录（Service Catalog）场景中，企业通常维护一个标准化的基础设施服务清单，例如“创建 PostgreSQL 实例”、“开通 VPC 网络”、“部署 Kubernetes 集群”。这些服务往往封装了内部合规、安全与运维策略。直接使用公有云 Provider 无法满足这些定制化需求，因此需要构建 自定义 Provider 来将服务目录暴露为 Terraform 资源。

1.2 Terraform Provider 架构概览

下图展示了 Terraform 核心、Provider 与目标基础设施之间的交互关系。理解这一架构是定制 Provider 的前提。

1.3 本课程核心目标

通过本课程，你将掌握构建生产级 Terraform Provider 的完整技能。课程围绕服务目录场景展开，最终交付一个可运行的 Provider 插件。

1.4 服务目录场景：为什么需要自定义 Provider？

服务目录（Service Catalog）是企业内部 IT 服务治理的核心组件。直接使用公有云 Provider 存在以下痛点：

• 合规策略缺失： 公有云 Provider 允许用户自由配置参数，无法强制绑定内部安全基线（如磁盘加密、网络隔离）。
• 审批流程断裂： 服务目录通常包含工单审批、成本中心校验等前置流程，原生 Provider 无法感知。
• 资源封装不足： 一个“创建 PostgreSQL”服务可能涉及 RDS、安全组、参数组、监控告警等多个云资源，原生 Provider 需要用户逐一配置。
• 多环境一致性： 服务目录屏蔽底层差异，自定义 Provider 可以统一开发、测试、生产环境的资源定义。

1.5 课程技术栈与前置要求

本课程基于 Terraform Plugin Framework（推荐用于 Terraform 1.0+），使用 Go 语言开发。以下是技术栈概览：

1.6 课程学习路径图

下图展示了从基础到进阶的完整学习路径，帮助你定位当前章节在整个课程中的位置。

1.7 课程产出物

完成本课程后，你将获得以下可交付成果：

• 一个完整的自定义 Provider 项目： 包含 Provider 注册、资源定义、数据源、CRUD 实现、认证逻辑。
• 服务目录资源类型： 至少实现 catalog_postgres、catalog_vpc 两个核心资源。
• 测试套件： 单元测试覆盖核心逻辑，验收测试验证端到端流程。
• 文档与发布配置： 自动生成 Terraform Registry 兼容文档，Provider 可本地安装使用。

1.8 开始之前：环境检查清单

请确保你的开发环境满足以下条件，后续章节将不再重复说明环境搭建步骤。