style: apply global formatting fixes (struct, spacing, zhlint)

2026-03-11 04:14:38 +00:00 · 2026-02-21 11:08:52 -08:00
parent ad68b2d973
commit 79ac9c639a
159 changed files with 1708 additions and 882 deletions
--- a/15_cases/README.md
+++ b/15_cases/README.md
@@ -1,4 +1,4 @@
-# 第十五章 实战案例
+# 第十五章实战案例

 本章将介绍 Docker 在不同场景下的实战案例。

--- a/15_cases/ci/README.md
+++ b/15_cases/ci/README.md
@@ -1,6 +1,6 @@
 # CI/CD

-**持续集成（Continuous integration）**是一种软件开发实践，每次集成都通过自动化的构建（包括编译，发布，自动化测试）来验证，从而尽早地发现集成错误。**持续部署（continuous deployment）** 是通过自动化的构建、测试和部署循环来快速交付高质量的产品。
+**持续集成 (Continuous integration)**是一种软件开发实践，每次集成都通过自动化的构建 (包括编译，发布，自动化测试) 来验证，从而尽早地发现集成错误。**持续部署 (continuous deployment)** 是通过自动化的构建、测试和部署循环来快速交付高质量的产品。


 与 `Jenkins` 不同的是，基于 Docker 的 CI/CD 每一步都运行在 Docker 容器中，所以理论上支持所有的编程语言。
--- a/15_cases/ci/actions/README.md
+++ b/15_cases/ci/actions/README.md
@@ -23,6 +23,10 @@ jobs:
          args: go version
 ```

+## 概述
+
+总体概述了以下内容。
+
 ## 参考资料

 * [Actions Docs](https://docs.github.com/en/actions)
--- a/15_cases/ci/devops_workflow.md
+++ b/15_cases/ci/devops_workflow.md
@@ -1,20 +1,22 @@
 ## DevOps 工作流完整示例

-本章将演示一个基于 Docker, Kubernetes 和 Jenkins/GitLab CI 的完整 DevOps 工作流。
+本章将演示一个基于 Docker，Kubernetes 和 Jenkins/GitLab CI 的完整 DevOps 工作流。

 ### 工作流概览

-1. **Code**: 开发人员提交代码到 GitLab。
-2. **Build**: GitLab CI 触发构建任务。
-3. **Test**: 运行单元测试和集成测试。
-4. **Package**: 构建 Docker 镜像并推送到 Harbor/Registry。
-5. **Deploy (Staging)**: 自动部署到测试环境 Kubernetes 集群。
-6. **Verify**: 人工或自动化验证。
-7. **Release (Production)**: 审批后自动部署到生产环境。
+1. **Code**：开发人员提交代码到 GitLab。
+2. **Build**：GitLab CI 触发构建任务。
+3. **Test**：运行单元测试和集成测试。
+4. **Package**：构建 Docker 镜像并推送到 Harbor/Registry。
+5. **Deploy (Staging)**：自动部署到测试环境 Kubernetes 集群。
+6. **Verify**：人工或自动化验证。
+7. **Release (Production)**：审批后自动部署到生产环境。

 ### 关键配置示例

-#### 1. Dockerfile 多阶段构建
+本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
+
+#### 1。Dockerfile 多阶段构建

 使用 Docker 多阶段构建可以有效减小镜像体积。

@@ -37,9 +39,9 @@ COPY --from=builder /app/main .
 CMD ["./main"]
 ```

-#### 2. GitLab CI 配置
+#### 2。GitLab CI 配置

-GitLab CI（.gitlab-ci.yml）配置如下：
+GitLab CI (。gitlab-ci.yml) 配置如下：


 ```yaml
@@ -79,6 +81,6 @@ deploy_staging:

 ### 最佳实践

-1. **不可变基础设施**: 一旦镜像构建完成，在各个环境（Dev, Staging, Prod）中都应该使用同一个镜像 tag (通常是 commit hash)，而不是重新构建。
-2. **配置分离**: 使用 ConfigMap 和 Secret 管理环境特定的配置，不要打包进镜像。
-3. **GitOps**: 考虑引入 ArgoCD，将部署配置也作为代码存储在 Git 中，实现 Git 驱动的部署同步。
+1. **不可变基础设施**：一旦镜像构建完成，在各个环境 (Dev，Staging，Prod) 中都应该使用同一个镜像 tag (通常是 commit hash)，而不是重新构建。
+2. **配置分离**：使用 ConfigMap 和 Secret 管理环境特定的配置，不要打包进镜像。
+3. **GitOps**：考虑引入 ArgoCD，将部署配置也作为代码存储在 Git 中，实现 Git 驱动的部署同步。
--- a/15_cases/ci/drone/README.md
+++ b/15_cases/ci/drone/README.md
@@ -10,7 +10,7 @@

 在 Github 新建一个名为 `drone-demo` 的仓库。

-打开我们已经 [部署好的 Drone 网站](install.md) 或者 [Drone Cloud](https://cloud.drone.io)，使用 GitHub 账号登录，在界面中关联刚刚新建的 `drone-demo` 仓库。
+打开我们已经[部署好的 Drone 网站](install.md)或者 [Drone Cloud](https://cloud.drone.io)，使用 GitHub 账号登录，在界面中关联刚刚新建的 `drone-demo` 仓库。

 ## 编写项目源代码

--- a/15_cases/ci/drone/demo/README.md
+++ b/15_cases/ci/drone/demo/README.md
@@ -4,9 +4,9 @@

 ## 目录结构

-*   `app.go`: 简单的 Go Web 服务器代码。
-*   `.drone.yml`: Drone CI 的配置文件，定义了构建和测试流程。
-*   `Dockerfile`: 定义了如何将该应用构建为 Docker 镜像。
+*   `app.go`：简单的 Go Web 服务器代码。
+*   `.drone.yml`：Drone CI 的配置文件，定义了构建和测试流程。
+*   `Dockerfile`：定义了如何将该应用构建为 Docker 镜像。

 ## 如何运行

--- a/15_cases/ci/drone/install.md
+++ b/15_cases/ci/drone/install.md
@@ -1,5 +1,7 @@
 ## 部署 Drone

+本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
+
 ### 要求

 * 拥有公网 IP、域名 (如果你不满足要求，可以尝试在本地使用 Gogs + Drone)
@@ -22,7 +24,7 @@

 ### 配置 Drone

-我们通过使用 `Docker Compose` 来启动 `Drone`，编写 `compose.yaml`（或 `docker-compose.yml`）文件。
+我们通过使用 `Docker Compose` 来启动 `Drone`，编写 `compose.yaml` (或 `docker-compose.yml`) 文件。

 ```yaml
 services:
@@ -80,6 +82,10 @@ DRONE_GITHUB_CLIENT_ID=
 DRONE_GITHUB_CLIENT_SECRET=
 ```

+#### 概述
+
+总体概述了以下内容。
+
 #### 启动 Drone

 运行以下命令：
--- a/15_cases/ide/vsCode.md
+++ b/15_cases/ide/vsCode.md
@@ -1,5 +1,11 @@
 ## VS Code 中使用 Docker

+本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
+
+### 概述
+
+总体概述了以下内容。
+
 ### 将 Docker 容器作为远程开发环境

-无需本地安装开发工具，直接将 Docker 容器作为开发环境，具体参考 [官方文档](https://code.visualstudio.com/docs/remote/containers)。
+无需本地安装开发工具，直接将 Docker 容器作为开发环境，具体参考[官方文档](https://code.visualstudio.com/docs/remote/containers)。
--- a/15_cases/os/alpine.md
+++ b/15_cases/os/alpine.md
@@ -1,16 +1,20 @@
 ## Alpine

+本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
+
 ### 简介

+下图直观地展示了本节内容：
+
 ![Alpine Linux 操作系统](../../_images/alpinelinux-logo.png)


 `Alpine` 操作系统是一个面向安全的轻型 `Linux` 发行版。它不同于通常 `Linux` 发行版，`Alpine` 采用了 `musl libc` 和 `busybox` 以减小系统的体积和运行时资源消耗，但功能上比 `busybox` 又完善的多，因此得到开源社区越来越多的青睐。在保持瘦身的同时，`Alpine` 还提供了自己的包管理工具 `apk`，可以通过 [Alpine Packages](https://pkgs.alpinelinux.org/packages) 网站上查询包信息，也可以直接通过 `apk` 命令直接查询和安装各种软件。


-`Alpine` 由非商业组织维护的，支持广泛场景的 `Linux`发行版，它特别为资深/重度`Linux`用户而优化，关注安全，性能和资源效能。`Alpine` 镜像可以适用于更多常用场景，并且是一个优秀的可以适用于生产的基础系统/环境。
+`Alpine` 由非商业组织维护的，支持广泛场景的 `Linux` 发行版，它特别为资深/重度 `Linux` 用户而优化，关注安全，性能和资源效能。`Alpine` 镜像可以适用于更多常用场景，并且是一个优秀的可以适用于生产的基础系统/环境。

-`Alpine` Docker 镜像也继承了 `Alpine Linux` 发行版的这些优势。相比于其他 `Docker` 镜像，它的容量非常小，仅仅只有 **5 MB** 左右（对比 `Ubuntu` 系列镜像接近 `200 MB`），且拥有非常友好的包管理机制。官方镜像来自 `docker-alpine` 项目。
+`Alpine` Docker 镜像也继承了 `Alpine Linux` 发行版的这些优势。相比于其他 `Docker` 镜像，它的容量非常小，仅仅只有 **5 MB** 左右 (对比 `Ubuntu` 系列镜像接近 `200 MB`)，且拥有非常友好的包管理机制。官方镜像来自 `docker-alpine` 项目。

 目前 Docker 官方已开始推荐使用 `Alpine` 替代之前的 `Ubuntu` 做为基础镜像环境。这样会带来多个好处。包括镜像下载速度加快，镜像安全性提高，主机之间的切换更方便，占用更少磁盘空间等。

--- a/15_cases/os/busybox.md
+++ b/15_cases/os/busybox.md
@@ -1,13 +1,17 @@
 ## Busybox

+本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
+
 ### 简介

+下图直观地展示了本节内容：
+
 ![Busybox - Linux 瑞士军刀](../../_images/busybox-logo.png)


-`BusyBox` 是一个集成了一百多个最常用 Linux 命令和工具（如 `cat`、`echo`、`grep`、`mount`、`telnet` 等）的精简工具箱，它只需要几 MB 的大小，很方便进行各种快速验证，被誉为“Linux 系统的瑞士军刀”。
+`BusyBox` 是一个集成了一百多个最常用 Linux 命令和工具 (如 `cat`、`echo`、`grep`、`mount`、`telnet` 等) 的精简工具箱，它只需要几 MB 的大小，很方便进行各种快速验证，被誉为 “Linux 系统的瑞士军刀”。

-`BusyBox` 可运行于多款 `POSIX` 环境的操作系统中，如 `Linux`（包括 `Android`）、`Hurd`、`FreeBSD` 等。
+`BusyBox` 可运行于多款 `POSIX` 环境的操作系统中，如 `Linux` (包括 `Android`)、`Hurd`、`FreeBSD` 等。

 ### 获取官方镜像

--- a/15_cases/os/centos.md
+++ b/15_cases/os/centos.md
@@ -1,5 +1,7 @@
 ## CentOS 和 Fedora

+本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
+
 ### CentOS 系统简介

 `CentOS` 和 `Fedora` 都是基于 `Redhat` 的常见 Linux 分支。`CentOS` 是目前企业级服务器的常用操作系统；`Fedora` 则主要面向个人桌面用户。
@@ -7,14 +9,18 @@
 ![CentOS 操作系统](../../_images/centos-logo.png)


-CentOS（Community Enterprise Operating System，中文意思是：社区企业操作系统），它是基于 `Red Hat Enterprise Linux` 源代码编译而成。由于 `CentOS` 与 `Redhat Linux` 源于相同的代码基础，所以很多成本敏感且需要高稳定性的公司就使用 `CentOS` 来替代商业版 `Red Hat Enterprise Linux`。`CentOS` 自身不包含闭源软件。
+CentOS (Community Enterprise Operating System，中文意思是：社区企业操作系统)，它是基于 `Red Hat Enterprise Linux` 源代码编译而成。由于 `CentOS` 与 `Redhat Linux` 源于相同的代码基础，所以很多成本敏感且需要高稳定性的公司就使用 `CentOS` 来替代商业版 `Red Hat Enterprise Linux`。`CentOS` 自身不包含闭源软件。
+
+#### 概述
+
+总体概述了以下内容。

 #### 使用 CentOS 官方镜像

 CentOS 官方镜像的使用非常简单。


-**注意：CentOS 8 已于 2021 年 12 月 31 日停止维护（EOL）。对于新部署，推荐使用 CentOS Stream，或 Rocky Linux、AlmaLinux 等替代发行版。**
+**注意：CentOS 8 已于 2021 年 12 月 31 日停止维护 (EOL)。对于新部署，推荐使用 CentOS Stream，或 Rocky Linux、AlmaLinux 等替代发行版。**

 使用 `docker run` 直接运行 `CentOS 7` 镜像，并登录 `bash`。

@@ -31,11 +37,17 @@ CentOS Linux release 7.9.2009 (Core)

 ### Fedora 系统简介

+下图直观地展示了本节内容：
+
 ![Fedora 操作系统](../../_images/fedora-logo.png)


 `Fedora` 由 `Fedora Project` 社区开发，红帽公司赞助的 `Linux` 发行版。它的目标是创建一套新颖、多功能并且自由和开源的操作系统。`Fedora` 的功能对于用户而言，它是一套功能完备的，可以更新的免费操作系统，而对赞助商 `Red Hat` 而言，它是许多新技术的测试平台。被认为可用的技术最终会加入到 `Red Hat Enterprise Linux` 中。

+#### 概述
+
+总体概述了以下内容。
+
 #### 使用 Fedora 官方镜像

 使用 `docker run` 命令直接运行 `Fedora` 官方镜像，并登录 `bash`。
--- a/15_cases/os/debian.md
+++ b/15_cases/os/debian.md
@@ -1,18 +1,24 @@
 ## Debian Ubuntu

-`Debian` 和 `Ubuntu` 都是目前较为流行的 **Debian 系** 的服务器操作系统，十分适合研发场景。`Docker Hub` 上提供了官方镜像，国内各大容器云服务也基本都提供了相应的支持。
+`Debian` 和 `Ubuntu` 都是目前较为流行的 **Debian 系**的服务器操作系统，十分适合研发场景。`Docker Hub` 上提供了官方镜像，国内各大容器云服务也基本都提供了相应的支持。

 ### Debian 系统简介

+下图直观地展示了本节内容：
+
 ![Debian 操作系统](../../_images/debian-logo.png)


-`Debian` 是由 `GPL` 和其他自由软件许可协议授权的自由软件组成的操作系统，由 **Debian 计划（Debian Project）**组织维护。**Debian 计划** 是一个独立的、分散的组织，由 `3000` 人志愿者组成，接受世界多个非盈利组织的资金支持，`Software in the Public Interest` 提供支持并持有商标作为保护机构。`Debian` 以其坚守 `Unix` 和自由软件的精神，以及其给予用户的众多选择而闻名。现时 `Debian` 包括了超过 `25,000` 个软件包并支持 `12` 个计算机系统结构。
+`Debian` 是由 `GPL` 和其他自由软件许可协议授权的自由软件组成的操作系统，由 **Debian 计划 (Debian Project)**组织维护。**Debian 计划**是一个独立的、分散的组织，由 `3000` 人志愿者组成，接受世界多个非盈利组织的资金支持，`Software in the Public Interest` 提供支持并持有商标作为保护机构。`Debian` 以其坚守 `Unix` 和自由软件的精神，以及其给予用户的众多选择而闻名。现时 `Debian` 包括了超过 `25,000` 个软件包并支持 `12` 个计算机系统结构。

 `Debian` 作为一个大的系统组织框架，其下有多种不同操作系统核心的分支计划，主要为采用 `Linux` 核心的 `Debian GNU/Linux` 系统，其他还有采用 `GNU Hurd` 核心的 `Debian GNU/Hurd` 系统、采用 `FreeBSD` 核心的 `Debian GNU/kFreeBSD` 系统，以及采用 `NetBSD` 核心的 `Debian GNU/NetBSD` 系统。甚至还有利用 `Debian` 的系统架构和工具，采用 `OpenSolaris` 核心构建而成的 `Nexenta OS` 系统。在这些 `Debian` 系统中，以采用 `Linux` 核心的 `Debian GNU/Linux` 最为著名。

 众多的 `Linux` 发行版，例如 `Ubuntu`、`Knoppix` 和 `Linspire` 及 `Xandros` 等，都基于 `Debian GNU/Linux`。

+#### 概述
+
+总体概述了以下内容。
+
 #### 使用 Debian 官方镜像

 Debian 是一个也是一个常用的基础镜像。
@@ -30,10 +36,16 @@ Debian GNU/Linux 8

 ### Ubuntu 系统简介

+下图直观地展示了本节内容：
+
 ![Ubuntu 操作系统](../../_images/ubuntu-logo.jpg)


-`Ubuntu` 是一个以桌面应用为主的 `GNU/Linux` 操作系统，其名称来自非洲南部祖鲁语或豪萨语的“ubuntu”一词（官方译名“友帮拓”，另有“吾帮托”、“乌班图”、“有奔头”或“乌斑兔”等译名）。`Ubuntu` 意思是“人性”以及“我的存在是因为大家的存在”，是非洲传统的一种价值观，类似华人社会的“仁爱”思想。 `Ubuntu` 基于 `Debian` 发行版和 `GNOME/Unity` 桌面环境，与 `Debian` 的不同在于它每 6 个月会发布一个新版本，每 2 年推出一个长期支持 **（Long Term Support，LTS）** 版本，一般支持 3 年时间。
+`Ubuntu` 是一个以桌面应用为主的 `GNU/Linux` 操作系统，其名称来自非洲南部祖鲁语或豪萨语的 “ubuntu” 一词 (官方译名 “友帮拓”，另有 “吾帮托”、“乌班图”、“有奔头” 或 “乌斑兔” 等译名)。`Ubuntu` 意思是 “人性” 以及 “我的存在是因为大家的存在”，是非洲传统的一种价值观，类似华人社会的 “仁爱” 思想。`Ubuntu` 基于 `Debian` 发行版和 `GNOME/Unity` 桌面环境，与 `Debian` 的不同在于它每 6 个月会发布一个新版本，每 2 年推出一个长期支持 **(Long Term Support，LTS)** 版本，一般支持 3 年时间。
+
+#### 概述
+
+总体概述了以下内容。

 #### 使用 Ubuntu 官方镜像

--- a/15_cases/os/summary.md
+++ b/15_cases/os/summary.md
@@ -6,6 +6,6 @@

 读者可以根据具体情况来选择。一般来说：

-* 官方镜像体积都比较小，只带有一些基本的组件。 精简的系统有利于安全、稳定和高效的运行，也适合进行个性化定制。
+* 官方镜像体积都比较小，只带有一些基本的组件。精简的系统有利于安全、稳定和高效的运行，也适合进行个性化定制。

 * 出于安全考虑，几乎所有官方制作的镜像都没有安装 SSH 服务，无法通过用户名和密码直接登录到容器中。