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
7cae0b6bb3
Fix deprecated TLS protocols and mongo CLI
2026-05-03 15:20:57 +00:00
yeasy
1e9cdeea3f
Update Grafana to v13, add version notes
2026-04-25 15:50:13 +00: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
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
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 Yang
5e8d7252be
Simplify words and fix format issues
2026-02-24 22:01:02 -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
cc13935f0f
style: apply global formatting fixes (struct, spacing, zhlint)
2026-02-21 11:08:52 -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
yeasy