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

This commit is contained in:
Baohua Yang
2026-02-21 11:08:52 -08:00
parent ad68b2d973
commit 79ac9c639a
159 changed files with 1708 additions and 882 deletions

View File

@@ -1,8 +1,10 @@
## 7.4 CMD 容器启动命令
本节涵盖了相关内容与详细描述主要探讨以下几个方面
### 什么是 CMD
`CMD` 指令用于指定容器启动时默认执行的命令它定义了容器的"主进程"
`CMD` 指令用于指定容器启动时默认执行的命令它定义了容器的 主进程
> **核心概念**容器的生命周期 = 主进程的生命周期CMD 指定的命令就是这个主进程
@@ -18,7 +20,9 @@ CMD 有三种格式:
| **shell 格式** | `CMD 命令 参数1 参数2` | 简单场景 |
| **参数格式** | `CMD ["参数1", "参数2"]` | 配合 ENTRYPOINT |
#### exec 格式推荐
#### exec 格式 (推荐)
如下代码块所示展示了相关示例
```docker
CMD ["nginx", "-g", "daemon off;"]
@@ -28,11 +32,13 @@ CMD ["node", "server.js"]
**优点**
- 直接执行指定程序是容器的 PID 1
- 正确接收信号 SIGTERM
- 正确接收信号 ( SIGTERM)
- 无需 shell 解析
#### shell 格式
如下代码块所示展示了相关示例
```docker
CMD echo "Hello World"
CMD nginx -g "daemon off;"
@@ -63,8 +69,14 @@ CMD ["sh", "-c", "echo $HOME"]
| 环境变量 | 需要 shell 包装 | 自动解析 |
| 推荐使用 | 大多数场景 | 需要 shell 特性时 |
#### 概述
总体概述了以下内容
#### 信号传递问题示例
如下代码块所示展示了相关示例
```docker
## ❌ shell 格式docker stop 会超时
@@ -107,8 +119,12 @@ CMD ["/bin/bash"] + cat /etc/os-release
### 经典错误容器立即退出
本节涵盖了相关内容与详细描述主要探讨以下几个方面
#### 错误示例
如下代码块所示展示了相关示例
```docker
## ❌ 容器启动后立即退出
@@ -117,6 +133,8 @@ CMD service nginx start
#### 原因分析
如下代码块所示展示了相关示例
```
1. CMD service nginx start
↓ 被转换为
@@ -133,6 +151,8 @@ CMD service nginx start
#### 正确做法
如下代码块所示展示了相关示例
```docker
## ✅ 让 nginx 在前台运行
@@ -150,6 +170,8 @@ CMD ["nginx", "-g", "daemon off;"]
#### 单独使用 CMD
如下代码块所示展示了相关示例
```docker
## Dockerfile
@@ -163,6 +185,8 @@ $ docker run myimage curl -v ... # 完全覆盖
#### 搭配 ENTRYPOINT
如下代码块所示展示了相关示例
```docker
## Dockerfile
@@ -175,13 +199,17 @@ $ docker run myimage # curl -s http://example.com
$ docker run myimage http://other.com # curl -s http://other.com参数覆盖
```
详见 [ENTRYPOINT 入口点](7.5_entrypoint.md) 章节
详见 [ENTRYPOINT 入口点](7.5_entrypoint.md)章节
---
### 最佳实践
#### 1. 优先使用 exec 格式
本节涵盖了相关内容与详细描述主要探讨以下几个方面
#### 1优先使用 exec 格式
如下代码块所示展示了相关示例
```docker
## ✅ 推荐
@@ -193,7 +221,9 @@ CMD ["python", "app.py"]
CMD ["sh", "-c", "echo $PATH && python app.py"]
```
#### 2. 确保应用在前台运行
#### 2确保应用在前台运行
如下代码块所示展示了相关示例
```docker
## ✅ 前台运行
@@ -208,7 +238,9 @@ CMD service nginx start
CMD systemctl start nginx
```
#### 3. 使用双引号
#### 3使用双引号
如下代码块所示展示了相关示例
```docker
## ✅ 正确:双引号
@@ -220,7 +252,9 @@ CMD ["node", "server.js"]
CMD ['node', 'server.js']
```
#### 4. 配合 ENTRYPOINT 使用
#### 4配合 ENTRYPOINT 使用
如下代码块所示展示了相关示例
```docker
## 用于可配置参数的场景
@@ -239,7 +273,9 @@ $ docker run myapp --port 9000
### 常见问题
#### Q: CMD 可以写多个吗
本节涵盖了相关内容与详细描述主要探讨以下几个方面
#### QCMD 可以写多个吗
不可以多个 CMD 只有最后一个生效
@@ -248,7 +284,9 @@ CMD ["echo", "first"]
CMD ["echo", "second"] # 只有这个生效
```
#### Q: 如何在 CMD 中使用环境变量
#### Q如何在 CMD 中使用环境变量
如下代码块所示展示了相关示例
```docker
## 方法1使用 shell 格式
@@ -260,7 +298,7 @@ CMD echo "Port is $PORT"
CMD ["sh", "-c", "echo Port is $PORT"]
```
#### Q: 为什么我的容器不响应 Ctrl+C
#### Q为什么我的容器不响应 Ctrl+C
可能是使用了 shell 格式信号被 sh 吃掉了