yeasy
141fdc80bc
fix(examples): 修正若干无法按原样执行的命令
...
* appendix/repo/nodejs.md:`docker build -t my-nodejs-app` 缺上下文参数,实际会
报 "docker buildx build" requires exactly 1 argument;补 `.`。同文件 docker run
示例里 `# -v "$ ":/usr/src/myapp \` 这一行的注释把自己的续行反斜杠也注掉了,加上
紧跟的空行,命令在 `--name my-running-script` 处就结束、没有镜像名,后面几行变成
独立的无效命令。该行内容与下一行的 --mount 重复,且 `"$ "` 已是残缺文本,删去。
* 06_repository/6.4:`openssl s_client -connect YourDomainName OR HostIP:443` 里的
占位符带空格,shell 会切成三个参数,-connect 只收到 YourDomainName,openssl 直接
报错;`docker login YourDomainName OR HostIP` 同理。改为一个变量。
* 08_data/8.2:`docker run -v $(pwd):/app -p 3000:3000 node npm run dev` 跑不起来
——官方 node 镜像没有设置 WORKDIR(docker-node 的 Dockerfile 里只有 ENTRYPOINT
与 CMD),工作目录是 /,npm 找不到 /package.json。补 -w /app,顺手引号包住 $(pwd)
并给出确定的标签(本书 4.1、7.10 都要求避免 latest)。
* 12_implementation/12.6:整段用的是 iproute2(ip link add / ip netns exec),中间
却夹了一句 `brctl addif`。bridge-utils 在当前 Debian/Ubuntu/RHEL 默认不再安装,
照抄会在这一行断掉;改成等价的 `ip link set A master docker0`。
* 14.1/14.2 的 `sysctl --system`、14.1 join 节点的 `systemctl enable/start
containerd`、6.4 的 `systemctl restart docker` 都缺 sudo,而紧邻的行(sudo tee、
14.1 第 47 行的 sudo systemctl restart containerd)都带。补齐。
* 15_etcd/demo/cluster/docker-compose.yml 仍留着顶层 `version: "3.6"`,Compose 会
警告 obsolete;11.1 明写「新文件建议直接省略该字段」,15.3 正文内联的同一份文件
也早已省略,只有磁盘上的 demo 落下了。删除后 YAML 仍可正常解析。
* 11.4:「对于 web 项目中的一个 db 容器,可能是 web_db」是 Compose V1 的下划线拼接,
V2 起统一改用连字符,只有 --compatibility 才回到下划线。
* 附录四 CMD 一节四处写成 `CMD ['executable', 'param1']` 单引号,还说「我们建议任何
服务镜像都使用这种形式」。exec 形式是 JSON,单引号解析不出来会退回 shell 形式,本书
7.4 就把 `CMD ['node', 'server.js']` 明确标为「❌ 错误:单引号(JSON 不支持)」。
一并把 `CMD ['PHP', '-a']` 的二进制名改回小写 php。
2026-08-07 23:26:36 -07:00
yeasy
b81816bb07
fix(content): 修正已随上游变化失效的版本事实与镜像引用
...
深审发现 14 处正文与上游现状不符(另有 4 处在 .agent/ 本地记忆,不入库)。
全部经官方一手源核验,并由独立复核者逐条尝试证伪后保留。
**Docker Content Trust 已从 CLI 移除(本书基线正是 Engine 29.x)**
- 18.6:`docker trust`、`DOCKER_CONTENT_TRUST` 的示例此前标为“历史用法”,
但未说明命令在 29.x 上根本不存在。Engine 29.0 release notes 原文:
"Docker Content Trust was removed from the Docker CLI";实测 docker/cli
的 cli/trust 包在 v28.5.0 返回 200、v29.0.0 返回 404
- 2.3、18.6:DCT 不再是“弃用阶段、时间线待公布”——官方 retired 页已给出
完整时间表(notary.docker.io 2026-12-08 关闭)
- 注意:`--disable-content-trust` 是 MarkDeprecated(隐藏但仍接受为 no-op),
不是“不可用”。初版提议写成不可用,经复核纠正后才落地
**etcd 维护分支写反了**
- 15_etcd README/15.1/15.2 均称“3.5 已退出维护窗口”,但 2026-07-23 官方与
v3.7.1、v3.6.14 同批发布了 v3.5.33,公告称三个分支均在维护;3.4 EOL 也应
是 2026-06(v3.4.45),非 5 月
**其他上游变化**
- 17.6:containerd 首个 2.x LTS 是 2.0(2024-11-05 起),非 2.3
- 6.4:`sonatype/nexus3:3.69` 这个 tag 从不存在(Sonatype 用三段式),改 3.69.0
- appendix/repo/centos:`rockylinux` 官方镜像已冻结(最后推送 2024-05-30),
改用官方指引的 `rockylinux/rockylinux`(2026-07-12 仍在更新)
- 6.2/6.3:docs.docker.com/registry/ 已 301 到 retired 页,改指
distribution.github.io(实测 200)
- 6.1:`docker search centos` 的示例输出补上上游现有的 DEPRECATED 标记
**刻意未改**:`minio/minio` 虽在 Docker Hub 标记 archived,但提议替换的
quay.io/minio/minio 最新 tag 停在 2024-07-31,比 Docker Hub 的 2025-09-07
更旧,照改会把读者引向更陈旧的仓库,留待作者定夺。
验证:check_project_rules 202 文件全过、emphasis 全过、40 测试通过、format 干净。
2026-07-28 20:12:47 -07:00
yeasy
51698c89c5
fix(content): correct verified internal inconsistencies across 7 sections
...
均为书内自证的矛盾,无需外部来源:
- 19.3: golang:1.26-alpine 标注为 ~1GB,但 21.7 将 ~900MB 归给非 alpine 的
golang:1.26,且 7.17 实测 alpine 版镜像为 295MB——alpine 变体不可能大于其
非 alpine 版本。改为与 21.7 一致的「golang:1.26 基础镜像的 ~900MB」。
- 20_cases_os: 正文称通用镜像 100-300 MB,紧邻的表格却列 Ubuntu ~80 MB
(与 4.2 的 ubuntu 24.04 78MB 一致)。正文改为 80-300 MB。
- 4.2: 「查找大于 500MB 的镜像」的 ^[0-9]+GB 不匹配小数,会漏掉 docker 实际
输出的全部 x.yGB(本书自己的示例即为 2.5GB)。补充可选小数部分。
- 6.2: docker image ls 示例输出把 tag 混入 REPOSITORY 列
(127.0.0.1:5000/ubuntu:latest + TAG latest),与同块 ubuntu/latest 行及
本节自述的 tag 格式不符。
- 5.3: 生命周期状态图缺 Stopped --> Running,而 5.3.6 正是讲 docker start
启动已停止的容器;原图中停止的容器只能被删除。
- 9.5: 端口映射图节点标签 "容器 (Class B: 80)" 语义错乱(Class B 是 IP 地址
分类,与端口无关),改为「容器 (端口: 80)」。
- appendix/faq/errors.md: 标题「常见错误速查表」与 SUMMARY.md 及 faq/README
两处链接文字「常见错误处理」不一致(全书 196 篇中唯一一处标题漂移)。
2026-07-16 23:20:25 -07:00
yeasy
9fdffa9d91
fix(content): harden Docker practice guide
2026-06-16 21:23:21 -07:00
yeasy
1cdd3c582a
fix(content): harden Docker examples
2026-06-01 10:33:50 -07:00
yeasy
ea26f96297
fix(content): remove demo registry credential
2026-05-25 01:13:10 -07:00
yeasy
28c23d003e
fix(content): harden Docker examples
2026-05-23 21:28:59 -07:00
yeasy
5650315cb4
Remove demo TLS key
2026-05-17 20:28:01 -07:00
yeasy
9f481e88ca
Fix go mod, Docker Hub rate limit, Compose verbose, docker debug, htpasswd security
2026-05-13 08:30:20 +00:00
yeasy
7cae0b6bb3
Fix deprecated TLS protocols and mongo CLI
2026-05-03 15:20:57 +00:00
yeasy
e416a1be7e
Fix Docker Hub rate limits, DCT timeline, image tags, etcd and Alertmanager
2026-04-27 01:15:52 +00:00
yeasy
1e9cdeea3f
Update Grafana to v13, add version notes
2026-04-25 15:50:13 +00:00
yeasy
515ba9f64a
Add blank lines before lists per CommonMark
2026-04-25 15:13:27 +00:00
yeasy
839a63f5af
Update versions and fix formatting issues
2026-04-25 15:10:43 +00:00
yeasy
8093b198ce
Update node-exporter to v1.11.1, fcct to butane
2026-04-25 14:58:40 +00:00
yeasy
77a537df54
Add blank lines before lists per CommonMark
2026-04-25 14:57:09 +00:00
yeasy
c9c72618c3
Refresh k8s docker versions and references
2026-04-21 20:57:33 -07:00
yeasy
b3d1508310
Add new content and update versions
2026-04-19 22:35:33 -07:00
yeasy
3bad07c41a
更新Docker安装、镜像、Dockerfile和Compose等文档内容
2026-03-29 11:40:34 -07:00
yeasy
76c2ae50fe
Add blank lines around headers
2026-03-24 09:27:04 -07:00
yeasy
44b1307277
Remove blank lines after code block markers
2026-03-21 22:36:09 -07:00
yeasy
370949f226
Add blank lines before headers
2026-03-21 12:57:51 -07:00
yeasy
c02a8a41cd
Update container runtime guidance
2026-03-16 20:49:00 -07:00
yeasy
b9c63a5133
Polish Docker workflow formatting
2026-03-16 00:32:49 -07:00
yeasy
470271fa6a
Fix outdated versions, template variables and version inconsistencies
...
- Update K8s Dashboard v2.0.0 to v2.7.0
- Update etcd v3.4.0 to v3.5.17
- Update PostgreSQL 15 to 16 for consistency
- Update Node.js 12 to 20 (current LTS)
- Replace unresolved GitBook template variables (CODE1/2/3/9)
2026-03-14 08:45:42 -07:00
yeasy
a16e0879c0
Improve READMEs and add contribution prompts
2026-03-09 20:04:21 -07:00
baohua
20a69d1662
Fix typography
2026-03-09 20:04:13 -07:00
Baohua Yang
88c739a433
Fix typo
2026-03-04 17:35:19 -08:00
baohua
e8be1c4bbc
Optimize content and fix issues
2026-03-03 19:30:21 -08:00
Baohua Yang
a92ed4a63f
Update content
2026-03-02 21:56:46 -08:00
Baohua Yang
9f67b560d9
Add security note
2026-02-28 14:28:38 -08:00
Baohua Yang
5f32350c12
Add more content and fix format
2026-02-25 21:06:21 -08:00
Baohua Yang
5e8d7252be
Simplify words and fix format issues
2026-02-24 22:01:02 -08:00
Baohua Yang
8c77a9aa99
Fix missing links
2026-02-22 13:40:20 -08:00
Baohua Yang
114def0634
style(docs): standardize heading formats and numbering
...
- Enforce Level 1-3 structural numbering based on SUMMARY.md hierarchy
- Remove structural numbering from Level 4+ headings
- Eliminate single child headings by converting to bold text
- Auto-inject summary text for headings with multiple children missing intro text
- Exclude Appendix chapters from structural numbering
- Avoid modifying code block contents
- Add script to detect non-standard English usage in headers
2026-02-21 22:40:33 -08:00
Baohua Yang
e69a140cc9
chore: remove unused historic image files
2026-02-21 16:43:31 -08:00
Baohua Yang
cc13935f0f
style: apply global formatting fixes (struct, spacing, zhlint)
2026-02-21 11:08:52 -08:00
Baohua Yang
1203dee81e
Continue to fix format issues
2026-02-21 10:47:37 -08:00
Baohua Yang
20c4f21247
Fix and improve
2026-02-12 16:51:50 -08:00
Baohua Yang
194680ab6e
Restruct
2026-02-09 12:56:12 -08:00
baohua
bb94a9f617
Fix and update
2026-02-09 11:34:35 -08:00
Baohua Yang
784c989789
Use a better structure
2026-02-09 09:32:05 -08:00
Baohua Yang
2264a7ae72
Release v1.5.0: Restructure chapters and update for Docker v30.x
2026-02-04 22:14:22 -08:00