Use a better structure

2026-03-11 12:21:17 +00:00 · 2026-02-09 09:32:05 -08:00
parent fdb879dcf2
commit e669ee0fe8
167 changed files with 2462 additions and 2462 deletions
--- a/04_image/dockerfile/cmd.md
+++ b/04_image/dockerfile/cmd.md
@@ -1,6 +1,6 @@
-# CMD 容器启动命令
+## CMD 容器启动命令

-## 什么是 CMD
+### 什么是 CMD

 `CMD` 指令用于指定容器启动时默认执行的命令。它定义了容器的"主进程"。

@@ -8,7 +8,7 @@

 ---

-## 语法格式
+### 语法格式

 CMD 有三种格式：

@@ -18,7 +18,7 @@ CMD 有三种格式：
 | **shell 格式** | `CMD 命令 参数1 参数2` | ⚠️ 简单场景 |
 | **参数格式** | `CMD ["参数1", "参数2"]` | 配合 ENTRYPOINT |

-### exec 格式（推荐）
+#### exec 格式（推荐）

 ```docker
 CMD ["nginx", "-g", "daemon off;"]
@@ -31,7 +31,7 @@ CMD ["node", "server.js"]
 - 正确接收信号（如 SIGTERM）
 - 无需 shell 解析

-### shell 格式
+#### shell 格式

 ```docker
 CMD echo "Hello World"
@@ -41,10 +41,10 @@ CMD nginx -g "daemon off;"
 **实际执行**：会被包装为 `sh -c`

 ```docker
-# 你写的
+## 你写的
 CMD echo $HOME

-# 实际执行的
+## 实际执行的
 CMD ["sh", "-c", "echo $HOME"]
 ```

@@ -53,7 +53,7 @@ CMD ["sh", "-c", "echo $HOME"]

 ---

-## exec 格式 vs shell 格式
+### exec 格式 vs shell 格式

 | 特性 | exec 格式 | shell 格式 |
 |------|----------|-----------|
@@ -62,27 +62,27 @@ CMD ["sh", "-c", "echo $HOME"]
 | 环境变量 | ❌ 需要 shell 包装 | ✅ 自动解析 |
 | 推荐使用 | ✅ 大多数场景 | 需要 shell 特性时 |

-### 信号传递问题示例
+#### 信号传递问题示例

 ```docker
-# ❌ shell 格式：docker stop 会超时
+## ❌ shell 格式：docker stop 会超时
 CMD node server.js
-# 实际是 sh -c "node server.js"
-# SIGTERM 发给 sh，不会传递给 node
+## 实际是 sh -c "node server.js"
+## SIGTERM 发给 sh，不会传递给 node

-# ✅ exec 格式：docker stop 正常工作
+## ✅ exec 格式：docker stop 正常工作
 CMD ["node", "server.js"]
-# SIGTERM 直接发给 node
+## SIGTERM 直接发给 node
 ```

 ---

-## 运行时覆盖 CMD
+### 运行时覆盖 CMD

 `docker run` 后的命令会覆盖 Dockerfile 中的 CMD：

 ```bash
-# ubuntu 默认 CMD 是 /bin/bash
+## ubuntu 默认 CMD 是 /bin/bash
 $ docker run -it ubuntu        # 进入 bash
 $ docker run ubuntu cat /etc/os-release  # 覆盖为 cat 命令
 ```
@@ -98,16 +98,16 @@ CMD ["/bin/bash"]   +    cat /etc/os-release

 ---

-## 经典错误：容器立即退出
+### 经典错误：容器立即退出

-### 错误示例
+#### 错误示例

 ```docker
-# ❌ 容器启动后立即退出
+## ❌ 容器启动后立即退出
 CMD service nginx start
 ```

-### 原因分析
+#### 原因分析

 ```
 1. CMD service nginx start
@@ -123,26 +123,26 @@ CMD service nginx start
 6. 容器主进程（sh）退出 → 容器停止
 ```

-### 正确做法
+#### 正确做法

 ```docker
-# ✅ 让 nginx 在前台运行
+## ✅ 让 nginx 在前台运行
 CMD ["nginx", "-g", "daemon off;"]
 ```

 ---

-## CMD vs ENTRYPOINT
+### CMD vs ENTRYPOINT

 | 指令 | 用途 | 运行时行为 |
 |------|------|-----------|
 | **CMD** | 默认命令 | `docker run` 参数会**覆盖**它 |
 | **ENTRYPOINT** | 入口点 | `docker run` 参数会**追加**到它后面 |

-### 单独使用 CMD
+#### 单独使用 CMD

 ```docker
-# Dockerfile
+## Dockerfile
 CMD ["curl", "-s", "http://example.com"]
 ```

@@ -151,10 +151,10 @@ $ docker run myimage              # 执行默认命令
 $ docker run myimage curl -v ...  # 完全覆盖
 ```

-### 搭配 ENTRYPOINT
+#### 搭配 ENTRYPOINT

 ```docker
-# Dockerfile
+## Dockerfile
 ENTRYPOINT ["curl", "-s"]
 CMD ["http://example.com"]
 ```
@@ -168,57 +168,57 @@ $ docker run myimage http://other.com  # curl -s http://other.com（参数覆盖

 ---

-## 最佳实践
+### 最佳实践

-### 1. 优先使用 exec 格式
+#### 1. 优先使用 exec 格式

 ```docker
-# ✅ 推荐
+## ✅ 推荐
 CMD ["python", "app.py"]

-# ⚠️ 仅在需要 shell 特性时使用
+## ⚠️ 仅在需要 shell 特性时使用
 CMD ["sh", "-c", "echo $PATH && python app.py"]
 ```

-### 2. 确保应用在前台运行
+#### 2. 确保应用在前台运行

 ```docker
-# ✅ 前台运行
+## ✅ 前台运行
 CMD ["nginx", "-g", "daemon off;"]
 CMD ["apache2ctl", "-D", "FOREGROUND"]
 CMD ["java", "-jar", "app.jar"]

-# ❌ 不要使用后台服务命令
+## ❌ 不要使用后台服务命令
 CMD service nginx start
 CMD systemctl start nginx
 ```

-### 3. 使用双引号
+#### 3. 使用双引号

 ```docker
-# ✅ 正确：双引号
+## ✅ 正确：双引号
 CMD ["node", "server.js"]

-# ❌ 错误：单引号（JSON 不支持）
+## ❌ 错误：单引号（JSON 不支持）
 CMD ['node', 'server.js']
 ```

-### 4. 配合 ENTRYPOINT 使用
+#### 4. 配合 ENTRYPOINT 使用

 ```docker
-# 用于可配置参数的场景
+## 用于可配置参数的场景
 ENTRYPOINT ["python", "app.py"]
 CMD ["--port", "8080"]

-# 运行时可以覆盖端口
+## 运行时可以覆盖端口
 $ docker run myapp --port 9000
 ```

 ---

-## 常见问题
+### 常见问题

-### Q: CMD 可以写多个吗？
+#### Q: CMD 可以写多个吗？

 不可以。多个 CMD 只有最后一个生效：

@@ -227,31 +227,31 @@ CMD ["echo", "first"]
 CMD ["echo", "second"]  # 只有这个生效
 ```

-### Q: 如何在 CMD 中使用环境变量？
+#### Q: 如何在 CMD 中使用环境变量？

 ```docker
-# 方法1：使用 shell 格式
+## 方法1：使用 shell 格式
 CMD echo "Port is $PORT"

-# 方法2：显式使用 sh -c
+## 方法2：显式使用 sh -c
 CMD ["sh", "-c", "echo Port is $PORT"]
 ```

-### Q: 为什么我的容器不响应 Ctrl+C？
+#### Q: 为什么我的容器不响应 Ctrl+C？

 可能是使用了 shell 格式，信号被 sh 吃掉了：

 ```docker
-# ❌ 信号无法传递
+## ❌ 信号无法传递
 CMD python app.py

-# ✅ 信号正确传递
+## ✅ 信号正确传递
 CMD ["python", "app.py"]
 ```

 ---

-## 本章小结
+### 本章小结

 | 要点 | 说明 |
 |------|------|
@@ -261,8 +261,8 @@ CMD ["python", "app.py"]
 | **与 ENTRYPOINT** | CMD 作为 ENTRYPOINT 的默认参数 |
 | **核心原则** | 应用必须在前台运行 |

-## 延伸阅读
+### 延伸阅读

 - [ENTRYPOINT 入口点](entrypoint.md)：固定的启动命令
- [后台运行](../../05_container/daemon.md)：容器前台/后台概念
- [最佳实践](../../15_appendix/best_practices.md)：Dockerfile 编写指南
+- [后台运行](../../05_container/5.2_daemon.md)：容器前台/后台概念
+- [最佳实践](../../15_appendix/15.1_best_practices.md)：Dockerfile 编写指南