 yeasy
|
a780127d48
|
fix(用词): 「其它」统一为「其他」（34 处 / 25 文件）
《现代汉语词典》与《中文技术文档写作风格指南》都以「其他」为规范词形；
本书基线是 90 处「其他」比 35 处「其它」，是集群里遗留最多的一本
（其余各书 0～4 处，blockchain_guide 已于 2026-08-05 统一过 47 处）。
其中 6 处在标题和目录上——`4.6 其它制作镜像的方式`、`第十七章 容器其它生态`、
`18.5 其它安全特性`——标题与 SUMMARY 条目**同批改写以保持一致**：
改动后 196 条目录名与各文件标题仍是 0 处不一致。
**`CHANGELOG.md` 里那一处刻意不动**：它是历史发布记录，改它等于改历史。
改动前后逐字符对称差：只有 34 个「它」变成「他」，无其他字符变化。
`check_project_rules` 202/202、`check_emphasis` 202/202、37 tests OK。
|
2026-08-24 13:18:05 -07:00 |
|
|
yeasy
|
ef2625531d
|
style: 含中文的括号统一为全角（336 处 / 110 文件）
全书此前是真·五五开：含中文的括号 336 处半角 : 336 处全角，而且**在同一文件
内混用**——`18_security/18.1_kernel_ns.md` 第 11/17/20 行写 `（如 runC）`，
第 31 行写 `(用户命名空间映射)`。这不是体例问题，是它自己跟自己不一致。
集群里其余 13 本都一边倒（llm_internals 5 : 1049、oc_guide 2 : 713、
forward_deployed_engineering_guide 0 : 108），blockchain_guide 已在 2026-08-05
按同一方向统一过 97 处，故取全角，而非另立新规。全角括号前后不留空格，
原先 `概念 (镜像、容器、仓库) 和` 两侧的空格一并收掉。
**纯拉丁内容的半角括号一个没动**——`新建一个层 (Layer)`、`项目 (project)`
保持原样：改动前后「半角且内容纯拉丁」的数量都是 **1163**，而「半角且含中文」
从 **336 变成 0**。
其余验证：改动前后各自抹掉全部空白与圆括号后**逐字节相同**（两侧均 19559 字符）；
左右括号总数改动前后都是 399 : 399，证明没有吞括号也没有配错对。
`check_project_rules` 202/202、`check_emphasis` 202/202、37 tests OK、
根 `format_checker` 与 `validate_codeblocks` 干净、`git diff --check` 干净。
|
2026-08-24 13:13:23 -07:00 |
|
|
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
|
dad26ccb28
|
Update docker0 default subnet to 172.17.0.0/16
|
2026-04-25 21:03:39 +00:00 |
|
|
yeasy
|
c9c72618c3
|
Refresh k8s docker versions and references
|
2026-04-21 20:57:33 -07:00 |
|
|
Baohua Yang
|
5f32350c12
|
Add more content and fix format
|
2026-02-25 21:06:21 -08:00 |
|
|
Baohua Yang
|
347c38e8bc
|
Fix naming of the chapter dir
|
2026-02-22 12:42:15 -08:00 |
|