本文作者:icy

深入解析 docker-archive/docker-ce:Golang 视角下的 Docker CE 源码剖析

icy 昨天 21 抢沙发
深入解析 docker-archive/docker-ce:Golang 视角下的 Docker CE 源码剖析摘要: 深入解析 docker-archive/docker-ce:Golang 视角下的 Docker CE 源码剖析 项目地址:https://github.com/docker-ar...

深入解析 docker-archive/docker-ce:Golang 视角下的 Docker CE 源码剖析

深入解析 docker-archive/docker-ce:Golang 视角下的 Docker CE 源码剖析

项目地址:https://github.com/docker-archive/docker-ce

这是一个 Go 开发者阅读容器引擎源码的绝佳入口,也是理解”一个工业级 Go 项目如何组织”的活教材。


一、这是什么项目?

docker-archive/docker-ce 是 Docker Community Edition(Docker CE)的官方源码归档仓库。在 2017 年,Docker 公司将 Docker 引擎的代码从原来的 docker/docker 仓库迁移到这里,用于组织 Docker CE 的打包、构建与发布流程,后来在 2019 年前后,Docker 的组件进一步拆分到 moby/moby 等独立仓库中,这个仓库便被归档(archive),进入了只读状态。

需要先厘清一个常见的误解:

仓库 角色
docker-archive/docker-ce(本项目) Docker CE 的构建、打包、发布工程的仓库,包含大量组件 Git 子模块(submodules)与构建脚本
moby/moby Docker 引擎核心(daemon + client)的真正源码
opencontainers/runc 容器运行时(OCI runtime)
containerd/containerd 容器生命周期管理

换句话说,docker-ce 本身不是引擎核心的一行行 Go 代码,而是一个“组装工厂”:它把 containerd、runc、libnetwork、docker/cli、moby 等真正用 Go 写就的组件作为子模块聚合进来,然后拉取、编译、打包成你在 apt/yum 里安装的 docker-ce。

所以阅读这个仓库,你能学到的不是 daemon 的网络栈实现细节,而是 一个大型 Go 项目族群如何做发布工程。但正因为它引用了大量 Go 子模块,它依然非常适合作为你研究 Docker 源码栈的”导航地图”。


二、仓库结构总览

克隆下来之后,你会看到类似这样的目录布局:

Plain text
docker-ce/
├── components/           # 各个子组件的 build 工程(含打包、测试脚本)
│   ├── engine/           # moby 引擎组件
│   ├── cli/              # docker CLI (docker/cli)
│   ├── containerd/       # containerd
│   ├── runc/             # runc
│   ├── packaging/        # deb/rpm 打包定义
│   └── ...
├── deb/                  # Debian/Ubuntu 包构建入口
├── rpm/                  # RHEL/CentOS/Fedora 包构建入口
├── hack/                 # 各种辅助脚本(下载、校验、release 等)
├── MANIFEST                # 组件版本清单,核心文件!
├── VERSION                 # Docker CE 版本号
├── Makefile                # 顶层构建入口
└── .gitmodules             # 关键:所有 Go 组件子模块的地址与版本

对你(Golang 开发者)来说,两个文件至关重要:

  1. MANIFEST —— 声明了每个组件(engine、cli、containerd……)在该次发布中对应的 提交 SHA / 分支。
  2. .gitmodules —— 定义每个组件从哪里拉取。

它们一起构成了”可复现构建“的基础:只要签出某个 tag,MANIFEST 就能锁定所有组件的精确版本。


三、构建流程:从 MANIFEST 到 deb 包

以一个 make deb 场景为例,顶层 Makefile 会驱动 hack/ 下的脚本完成:

  1. 读取 VERSION + MANIFEST,决定各组件版本;
  2. 下载源码 tarball(hack/download.tgz 之类),或直接 clone 子模块;
  3. 进入各组件目录执行 Go 构建(通过 components/engine、components/cli 等 Makefile 调用 go build);
  4. 打 deb/rpm 包:deb/ 与 rpm/ 下的模板把编译好的二进制(dockerd、docker、containerd、runc、docker-proxy…)塞进包结构;
  5. 签名 / 生成 repo 元数据。

对 Go 开发者有几点非常有参考价值:

  • 多组件版本协调:一次发布涉及十几个 Go 仓库(moby、cli、libnetwork、swarmkit、containerd、runc、tini、docker-proxy……)。MANIFEST 用一个”中央清单”锁定它们的 SHA,避免”组件漂移”。这是大型 monorepo / multi-repo 管理的经典范式。
  • 构建与源码彻底解耦:本仓库几乎不含业务 Go 代码,全部依赖外部组件。这种做法让”打包工程”可以独立演进而不至于污染引擎源码。
  • 可复现性(reproducible build):固定 SHA + 固定构建工具链 + 固定基础镜像,才能让”某版本 docker-ce”在任何机器上产出一致二进制。

给你一个简化示意(实际脚本更复杂,但思路一致):

makefile
# 顶层 Makefile 的简化示意
VERSION := $(shell cat VERSION)

.PHONY: checkout
checkout:
	@# 依据 .gitmodules 与 MANIFEST 拉取各组件
	git submodule update --init --recursive
	@# 若有 MANIFEST 中指定 SHA,则同步对齐
	./hack/sync-from-manifest.sh

.PHONY: build-engine
build-engine:
	$(MAKE) -C components/engine build VERSION=$(VERSION)

.PHONY: deb
deb: checkout build-engine
	@# 将二进制与配置塞入 deb 结构
	./hack/make.sh deb

四、Go 组件在这里扮演什么角色?

虽然本仓库以打包为主,但它牵动的核心组件几乎都是 Go 写的。理清它们的职责,对你深入 Go 云原生栈很有帮助:

组件 语言 职责
moby/moby (dockerd) Go Docker 守护进程,提供 Engine API
docker/cli (docker) Go 命令行客户端
containerd Go 容器运行时管理(镜像、容器生命周期)
runc Go OCI 运行时,真正调用 clone/pivot_root 等系统调用
libnetwork Go CNM 网络模型实现
swarmkit Go Swarm 编排
docker-proxy Go 端口转发用户态实现
tini C PID 1 init 进程

如果你曾在 dockerd 里读过 daemon/ 目录,或在 containerd 里追过 runtime/v2/task,你就能明白:docker-ce 仓库的价值,就是把这条从 CLI → daemon → containerd → runc → 内核的调用链完整地”封装成可发布的制品”。当你能顺着一个 docker run 请求把这条链上的每一跳都讲清楚,你对 Go 容器生态的理解就已经上了一个台阶。


五、为什么现在被归档?迁移路径

2017~2019 期间,Docker 逐步把引擎核心迁往 Moby 项目:

  • 引擎核心 → moby/moby
  • CLI → docker/cli
  • 打包定义 → 也在 moby/moby 的 packaging 目录及厂商侧维护

docker-ce 作为”某一段时期官方打包工程”的历史产物被保留下来,只读归档。如果你现在要做现代容器开发,应关注:

  • moby/moby
  • moby/buildkit(现代构建后端,强烈建议 Go 开发者研读)
  • containerd/containerd
  • opencontainers/runc

不过,归档 ≠ 无价值。这个仓库仍然是你理解 “Docker 发行体系” 的最佳考古材料。


六、给 Go 开发者的阅读建议

如果你真想从这套仓库里学到东西,我建议按这个顺序走:

  1. 先读 MANIFEST 与 .gitmodules:搞清一次发布涉及多少个 Go 仓库、它们的版本如何锁定。
  2. 追踪一个 docker 二进制的诞生:从 Makefile → components/cli → 找到 main.go,理解 CLI 如何用 cobra 组织命令。
  3. 追踪 dockerd:进入 moby/moby/cmd/dockerd,看它如何启动 API server、加载 containerd 客户端。
  4. 追一次容器启动请求:docker run → CLI 组 HTTP 请求 → daemon → containerd runtime/v2 → runc。这是理解 Go 云原生编排最核心的一条线。
  5. 对比打包脚本:看 deb/ 与 rpm/ 下的规则,理解 Go 二进制如何被分装进系统包、如何写 systemd unit。

七、小结

docker-archive/docker-ce 是一个“被归档但极具教学价值”的仓库。它本身不写业务 Go 代码,却是整个 Docker 生态的发布中枢与版本契约:通过 MANIFEST 锁定十几个 Go 组件的精确版本,通过 components/ 下的构建脚本把它们编译、打包成用户可安装的 docker-ce。

对于 Golang 开发者,它能给你三点关键启发:

  • 多仓库版本治理:如何用一份清单协调十几个 Go 仓库的发布;
  • 可复现构建:固定 SHA、固定工具链的工程实践;
  • 容器技术栈全链路:把 CLI / daemon / containerd / runc 串成一条可追溯的调用链。

读懂它,你不仅读懂了”一个 Go 项目如何被发布”,更读懂了”Docker 这套 Go 生态是如何被组装出来的”。


参考链接

docker-ce_20261110111714.zip
类型:压缩文件|已下载:0|下载方式:免费下载
立即下载
文章版权及转载声明

作者:icy本文地址:https://www.zelig.cn/golang/1522.html发布于 昨天
文章转载或复制请以超链接形式并注明出处软角落-SoftNook

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

微信扫一扫打赏

阅读
分享

发表评论

快捷回复:

评论列表 (暂无评论,21人围观)参与讨论

还没有评论,来说两句吧...