ehlxr/docker_practice
1
0
Fork 0
mirror of https://github.com/yeasy/docker_practice.git synced 2026-08-10 08:27:25 +00:00
Code Issues Projects Releases Wiki Activity
1,618 Commits 5 Branches 34 Tags
33bca896b523889d578a29f60fac1082e84d8ceb
Commit Graph
126 Commits
Author SHA1 Message Date
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 a1f63a565b fix(links): repair dead external links found by a cluster-wide sweep 
对 13 本书的 1,842 个外链做了一次全量 curl 健康检查（跟随重定向、带浏览器 UA），
逐条排除误报后确认的真死链。替换目标全部逐个验证返回 200。

注意两类**不是**缺陷、因此没有动的：
- platform.claude.com / docs.anthropic.com 当时返回 500，串行重试仍 500，
  但同日早些时候可正常访问——是上游临时故障，不是死链。
- docker_practice 列出的国内 registry 镜像连不上，是因为书里已明确标注
  「已停止服务」「已于 2024 年关闭」，属于故意保留的历史记录。
 2026-07-22 16:51:15 -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 67d5fc775a fix(content): harden Compose credential examples 2026-06-04 01:02:59 -07:00
yeasy 6fc032f7d6 应用专业编辑审查：修复版本/引用/技术准确性等 3 处 2026-06-01 11:11:28 -07:00
yeasy 094965e039 修复编辑问题：错别字/语病/术语/标点等 25 处（自动审校） 2026-05-31 22:20:50 -07:00
yeasy 48e86b7bec fix(appendix): correct .dockerignore typo in image-slimming FAQ 2026-05-28 11:38:28 -07:00
yeasy fb361bb1f0 fix(appendix): use H2 for 附录七 to match sibling appendix files 
The other appendix entries (附录四 best_practices, 附录五 debug,
附录六 resources, 附录八 learning_roadmap) all use H2. glossary.md
was the lone H1, which broke the table-of-contents nesting in
GitBook. Demoted to H2 to align.
 2026-05-24 01:03:34 -07:00
yeasy 036f0486db fix(content): tighten safety guidance 2026-05-24 00:57:03 -07:00
yeasy e17bef96d2 docs(content): update Compose and safety guidance 2026-05-21 20:13:39 -07:00
yeasy 2e625a3cdf fix(content): harden install and security guidance 2026-05-21 01:23:44 -07:00
yeasy 1b651e5f8c fix(content): refresh Docker and Kubernetes guidance 2026-05-20 09:16:36 -07:00
yeasy 78ca8f6d19 Refresh Docker ecosystem 2026-05-16 14:09:31 -07:00
yeasy a20d1b19c4 Fix 3 broken external links in appendix 2026-05-14 02:27:32 +00:00
yeasy ef5a97fa09 Fix VirtioFS note, cri-socket, componentstatuses, ES version and typo 2026-05-13 08:26:24 +00:00
yeasy 7cae0b6bb3 Fix deprecated TLS protocols and mongo CLI 2026-05-03 15:20:57 +00:00
yeasy 7e3f90b522 Update Node base images to 22 LTS 2026-05-01 10:24:43 +00:00
yeasy 30f0115cb9 Update nginx, OS, Buildx, etcd and K8s refs 2026-04-28 12:22:57 +00:00
yeasy a89f7285c7 Fix typos and update Docker Hub limits and versions 2026-04-28 09:15:40 +00:00
yeasy 15c7fe1dc2 Update Docker Hub rate limits and version refs 2026-04-28 08:20:21 +00:00
yeasy 4d1e323faf Fix seccomp typo, postgres path and DCA exam details 2026-04-28 04:21:10 +00:00
yeasy 16203c5018 Complete Dockerfile instruction reference list 2026-04-27 23:17:39 +00:00
yeasy 37e376d578 Fix mongosh, DCA price, compose healthcheck and cleanup 2026-04-27 14:17:57 +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 ac92e6c536 Fix Debian dates and FAQ template syntax 2026-04-22 08:43:48 -07:00
yeasy c9c72618c3 Refresh k8s docker versions and references 2026-04-21 20:57:33 -07:00
yeasy 85f76aa6d9 Fix guide issues 2026-03-28 18:24:46 -07:00
yeasy 5a6a50ba97 Refine appendix navigation 2026-03-28 18:19:49 -07:00
Baohua Yang b67d5367dc chore: update content and add generated PDF 2026-03-27 08:43:47 -07:00
yeasy 5a55e03f45 Minor update 2026-03-26 10:02:41 -07:00
yeasy 6faf9a1707 Shorten overly long FAQ heading 2026-03-26 09:04:16 -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
Baohua Yang 8e8c554482 fix: update docker-compose V1 syntax to V2 and add release PDF workflow 
Replace remaining docker-compose command references with docker compose (V2).
Add GitHub Actions workflow to auto-generate PDF via mdpress on release.
 2026-03-19 20:21:06 -07:00
yeasy 65984bba30 Remove appendix writing rules 2026-03-18 19:43:41 -07:00
yeasy 8d7541bed6 Convert bare URLs to markdown links 2026-03-16 23:28:44 -07:00
yeasy 3a417db2e2 Convert bare URLs to markdown links 2026-03-16 22:40:09 -07:00
yeasy 696070cba9 Remove redundant English from headings 2026-03-16 22:34:38 -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 6abe4934e7 Fix figure captions, numbering, and heading level 2026-03-09 19:03:47 -07:00
baohua 20a69d1662 Fix typography 2026-03-09 20:04:13 -07:00
baohua 8c4c2aa875 Add learning roadmap 2026-03-05 19:14:37 -08:00