mirror of
https://github.com/yeasy/docker_practice.git
synced 2026-10-21 02:07:21 +00:00
fix(一致性): 两处相互冲突的建议,其一会让读者悄悄失去本书推荐的默认后端
- 18.1 完整演示了如何开启 `userns-remap`,全程没有任何代价提示。但官方文档 明写「The containerd image store is not available when using user namespace remapping」,而本书基线是 Docker Engine v29.x——该版本新装默认就是 containerd image store,12.4 节还把它标为「强烈推荐(现代默认)」。照 18.1 做完,读者会在毫不知情的情况下退回旧存储后端,失去 OCI image index、多架构 镜像与构建溯源。补上这条互斥关系并交叉引用 12.4。 - 5 章说「生产环境建议指定确切版本号(如 nginx:1.28.0)而非仅大版本号」, 7 章说「使用主或次版本号而非完整版本号(patch)」并把 patch 版本列入 「避免」。两条都以全书建议的口吻写成,方向正好相反。它们其实面向不同环节: Dockerfile 的**基础镜像**用主/次版本号,才能在重新构建时自动带上安全补丁; **部署**一个服务镜像则应钉死确切版本,让部署可复现、升级是显式动作。 两处各补一句限定范围并互相指引,而不是删掉其中一条。
This commit is contained in:
@@ -14,7 +14,8 @@
|
||||
- **镜像标签约定**:
|
||||
- `latest` 或 `v1.0.0` 等:带标签的自定义镜像,示例中指定具体版本
|
||||
- `24.04`、`8.4`:官方镜像的稳定版本分支
|
||||
- 生产环境建议:指定确切版本号(如 `nginx:1.28.0`、`mysql:8.4.4`)而非仅大版本号
|
||||
- 生产环境建议:**运行/部署**服务镜像时指定确切版本号(如 `nginx:1.28.0`、`mysql:8.4.4`)而非仅大版本号,让每次部署可复现、升级是显式动作。
|
||||
(注意这与 [第 7 章](../07_dockerfile/README.md) 对 **Dockerfile 基础镜像** 的建议方向相反:基础镜像用主/次版本号,以便重新构建时自动带上补丁。两者面向的是不同环节。)
|
||||
|
||||
* [启动容器](5.1_run.md)
|
||||
* [守护态运行](5.2_daemon.md)
|
||||
|
||||
@@ -89,7 +89,8 @@ docker build -t my-image:1.0 .
|
||||
本章中的 Dockerfile 示例使用的基础镜像标签遵循以下原则:
|
||||
|
||||
- **通用标签**(如 `ubuntu:24.04`、`alpine`、`nginx`):保持原样,无需修改
|
||||
- **基础镜像版本号**(如 `node:22`、`python:3.12`):使用主或次版本号而非完整版本号(patch),这样可以自动获取最新的补丁版本,确保获得安全更新
|
||||
- **基础镜像版本号**(如 `node:22`、`python:3.12`):使用主或次版本号而非完整版本号(patch),这样可以自动获取最新的补丁版本,确保获得安全更新。
|
||||
(这条只针对 **Dockerfile 的基础镜像**;部署一个服务镜像时反而应钉死确切版本,见 [第 5 章](../05_container/README.md)。)
|
||||
- **避免**:不建议使用 `latest` 标签和完整的 patch 版本号(如 `20.10.0`)作为基础镜像,因为这会导致构建的不可重现性或安全风险
|
||||
|
||||
读者在使用这些示例时,应根据实际生产环境需求选择合适的版本号。
|
||||
|
||||
@@ -45,6 +45,12 @@ Docker 守护进程在启动容器时,会在后台为容器创建一套独立
|
||||
```
|
||||
使用 `default` 值时,Docker 会自动在宿主机上创建一个名为 `dockremap` 的用户和用户组。
|
||||
|
||||
> **注意其代价**:官方文档明确 **containerd image store 在启用 `userns-remap` 时不可用**。
|
||||
> 而本书基线是 Docker Engine v29.x,该版本新装默认就是 containerd image store,
|
||||
> [12.4 节](../12_implementation/12.4_ufs.md) 也把它标为「强烈推荐(现代默认)」。
|
||||
> 也就是说,打开 userns-remap 会让你退回旧的镜像存储后端,失去 OCI image index、
|
||||
> 多架构镜像与构建溯源等能力。两者只能二选一,请按威胁模型权衡。
|
||||
|
||||
2. **验证子 UID 和子 GID 分配**
|
||||
|
||||
Docker 会通过 `/etc/subuid` 和 `/etc/subgid` 文件为 `dockremap` 分配一个高位的 UID 范围:
|
||||
|
||||
Reference in New Issue
Block a user