fix(content): 修正四处书内自相矛盾的技术断言

1. FROM「必须是第一条指令」(4.5、7.16、summary 三处)与本书 7.7.4「FROM 之前的
   ARG」整节直接冲突。官方 Dockerfile 参考写的是 "A Dockerfile must begin with a
   FROM instruction. This may be after parser directives, comments, and globally
   scoped ARGs",且 "ARG is the only instruction that may precede FROM"。三处
   一并改成「第一条构建指令」并点明例外。

2. 12 章小结把 USER Namespace 列进「默认启用」的一档,并写「容器 root ≠ 宿主机
   root」;而同章 12.2.2 明写 USER Namespace 默认**不**启用、需 userns-remap 显式
   开启,18.1 更直说「在默认情况下,容器内的 root 用户(UID=0)就是宿主机上的
   root 用户」。小结按正文口径改回——这条读反了会直接误判容器逃逸的风险面。

3. 11.5「目前支持三种日志驱动类型」是 Compose 早期文本的残留。官方支持 json-file、
   local、syslog、journald、gelf、fluentd、awslogs、splunk、etwlogs、gcplogs、
   none 共十余种,本书 19 章小结自己就列了六种。改为给出常见取值并链到官方清单。

4. 7.8 与 7.5 的示例注释建议 postgres:latest / redis:latest,而 4.1、7.10、
   7.16、7 章小结、4.5 全都要求避免 latest(7.8 同一文件第 177 行也写「避免
   latest」)。按全书口径改掉这两处。

另:ENV 的空格分隔旧写法(7.6 的「格式一」、附录四的 PG_MAJOR/PATH 示例)改为等号
形式并加注。BuildKit 的 LegacyKeyValueFormat 检查会报
"ENV key=value" should be used instead of legacy "ENV key value" format,
而本书 10.2 与 07 章 README 正是在推荐 docker buildx build --check。
This commit is contained in:
yeasy
2026-08-07 23:26:12 -07:00
parent 42253fc1e8
commit 08e981018e
9 changed files with 18 additions and 13 deletions
+1 -1
View File
@@ -12,7 +12,7 @@
Dockerfile 中的常用指令包括
- **FROM**: 指定基础镜像必须是第一条指令
- **FROM**: 指定基础镜像必须是第一条构建指令只有全局 `ARG`注释和 parser 指令可以在它之前
- **RUN**: 在镜像中执行命令用于安装软件包等
- **COPY**: 复制文件到镜像中
- **ADD**: 更高级的复制文件支持 URL 和自动解压
+1 -1
View File
@@ -164,7 +164,7 @@ curl -s http://myip.ipip.net -i
#### 实现方式
```docker
# 建议使用 redis:7 或 redis:latest,具体版本号根据生产需求选择
# 建议使用 redis:7 等具体版本标签,避免 latest,具体版本号根据生产需求选择
FROM redis:7-alpine
COPY docker-entrypoint.sh /usr/local/bin/
ENTRYPOINT ["docker-entrypoint.sh"]
+8 -4
View File
@@ -5,12 +5,16 @@
```docker
## 格式一:单个变量
ENV <key> <value>
ENV <key>=<value>
## 格式二:多个变量(推荐)
## 格式二:多个变量
ENV <key1>=<value1> <key2>=<value2> ...
```
> 用空格分隔的旧写法 `ENV <key> <value>``ARG` 同理虽然仍能构建但已被官方弃用BuildKit
> [LegacyKeyValueFormat](https://docs.docker.com/reference/build-checks/legacy-key-value-format/) 构建检查会报
> `"ENV key=value" should be used instead of legacy "ENV key value" format``docker buildx build --check` [10.2](../10_buildx/10.2_buildx.md)会直接把它标出来一律用等号
---
### 7.6.2 基本用法
@@ -18,8 +22,8 @@ ENV <key1>=<value1> <key2>=<value2> ...
#### 设置单个变量
```docker
ENV NODE_VERSION 20
ENV APP_ENV production
ENV NODE_VERSION=20
ENV APP_ENV=production
```
#### 设置多个变量
+1 -1
View File
@@ -120,7 +120,7 @@ VOLUME /data
#### 数据库持久化
```docker
# 建议使用 postgres:16 或 postgres:latest,具体版本号根据数据库兼容性需求选择
# 建议使用 postgres:16 等具体版本标签,避免 latest,具体版本号根据数据库兼容性需求选择
FROM postgres:16
VOLUME /var/lib/postgresql/data
```
+1 -1
View File
@@ -4,7 +4,7 @@
| 指令 | 作用 | 关键要点 |
|------|------|---------|
| **FROM** | 指定基础镜像 | 必须是第一条指令 |
| **FROM** | 指定基础镜像 | 必须是第一条构建指令只有全局 `ARG` 能写在它之前 |
| **RUN** | 在新层执行命令 | 合并命令清理缓存以减小体积 |
| **COPY** | 复制文件 | 优先使用支持 `--from` |
| **ADD** | 更高级的复制 | 自动解压 tar公开远程 artifact 应配合 `--checksum` |