1. 课程导论：服务网格与边车模式概述、Gin框架在微服务中的定位、本课程学习目标与前置知识
1.1 服务网格：微服务通信的专属基础设施层
服务网格（Service Mesh）是云原生架构中用于处理服务间通信的专用基础设施层。它将原本嵌入在业务代码中的熔断、限流、负载均衡、服务发现、可观测性等能力，剥离到独立的代理进程中，使开发者可以专注于业务逻辑。
核心思想：服务网格将“网络通信”从业务代码中解耦，形成独立的数据平面与控制平面。
服务网格的典型架构包含两个核心平面：
| 平面 | 组件 | 职责 |
|---|---|---|
| 数据平面 | 边车代理（Sidecar Proxy） | 拦截所有进出服务的流量，执行路由、重试、熔断、遥测采集 |
| 控制平面 | Pilot / Mixer / Citadel（以 Istio 为例） | 下发配置、管理证书、聚合遥测数据、提供服务发现 |
主流服务网格产品包括 Istio、Linkerd、Consul Connect 等。本课程以 Istio 作为边车部署的参考实现，因为它在 Kubernetes 生态中拥有最广泛的社区支持和最完整的边车注入机制。
1.2 边车模式：非侵入式增强服务能力
边车模式（Sidecar Pattern）是服务网格的核心部署模式。它将辅助功能（如日志、监控、代理）以独立容器的形式附加到主服务容器旁边，共享同一个 Pod 的网络命名空间和存储卷。
边车模式的关键特征：
- 非侵入：主服务无需感知边车存在，代码零改动。
- 语言无关：边车代理（如 Envoy）与主服务语言栈无关。
- 独立升级：边车版本迭代不影响业务容器。
- 资源隔离：边车与主服务各自拥有独立的资源限制。
在 Go 微服务项目中，边车模式最常见的落地场景是：
- 将 Gin 服务的 HTTP 流量全部劫持到 Envoy 边车代理。
- 由边车统一处理 mTLS 加密、请求重试、灰度路由。
- Gin 服务只关注业务路由和 API 响应。
1.3 Gin 框架在微服务中的定位
Gin 是 Go 语言生态中最流行的 HTTP Web 框架，以高性能和极简 API著称。在微服务架构中，Gin 通常扮演以下角色：
- API 网关后端：作为业务服务的 HTTP 入口，处理路由、参数校验、中间件编排。
- BFF（Backend For Frontend）：为前端聚合多个下游 gRPC 或 HTTP 服务的数据。
- 边车代理的业务容器：在服务网格中，Gin 服务只负责业务逻辑，网络通信完全交给边车。
注意：在服务网格环境下，Gin 服务不应再自行实现熔断、重试、服务发现等能力。这些功能由边车代理统一接管，否则会导致策略冲突和资源浪费。
Gin 与服务网格的边界划分原则：
| 能力维度 | Gin 服务负责 | 边车代理负责 |
|---|---|---|
| 路由 | 业务路由（如 /api/v1/users） | 流量路由（如版本灰度、金丝雀发布） |
| 安全 | 业务鉴权（JWT、OAuth） | 传输安全（mTLS、证书轮换） |
| 可观测性 | 业务日志、业务指标 | 网络指标、分布式追踪、访问日志 |
| 容错 | 业务降级、缓存降级 | 熔断、重试、超时、限流 |
1.4 本课程学习目标
完成本课程后，你将能够：
- 理解服务网格边车模式的核心原理及其与 Gin 框架的协作边界。
- 搭建一个基于 Kubernetes + Istio 的边车注入环境，并将 Gin 服务无缝接入。
- 配置边车代理的流量路由、熔断、重试、超时策略，且不修改一行 Gin 代码。
- 采集边车层面的可观测性数据（链路追踪、指标、日志），并与 Gin 业务日志关联。
- 实践灰度发布、蓝绿部署、故障注入等高级流量管理场景。
课程产出：一个完整的 Gin 微服务项目，配备生产级别的边车配置模板、可观测性仪表盘和 CI/CD 流水线示例。
1.5 前置知识要求
为了获得最佳学习体验，建议你具备以下基础：
| 领域 | 具体要求 |
|---|---|
| Go 语言 | 熟悉 Go 语法、HTTP 处理、结构体与接口；有 Gin 框架基本使用经验 |
| 容器与编排 | 理解 Docker 镜像构建、Kubernetes Pod/Service/Deployment 基本概念 |
| 微服务基础 | 了解 RESTful API 设计、服务注册与发现、负载均衡等常见模式 |
| 网络基础 | 理解 HTTP/1.1、HTTP/2、TCP 代理、TLS 握手基本流程 |
提示：如果你对 Kubernetes 或 Istio 尚不熟悉，不必担心。本课程第 2-3 章会提供快速上手指南，帮助你搭建实验环境。
1.6 课程章节概览
本课程共 30 章，分为五个阶段：
| 阶段 | 章节范围 | 核心内容 |
|---|---|---|
| 基础篇 | 第 1-5 章 | 服务网格概念、环境搭建、Gin 服务容器化与边车注入 |
| 流量管理篇 | 第 6-12 章 | 路由规则、灰度发布、熔断重试、超时限流配置 |
| 可观测性篇 | 第 13-18 章 | 链路追踪、指标采集、日志聚合、告警配置 |
| 安全与韧性篇 | 第 19-24 章 | mTLS 配置、故障注入、多集群通信、安全策略 |
| 生产实践篇 | 第 25-30 章 | CI/CD 集成、性能调优、排错指南、项目总结 |
学习建议：每章都包含可运行的代码示例和配置清单。建议你按照章节顺序搭建实验环境，边学边练。遇到问题时，优先查看第 29 章的排错指南。