因工作需要从源码编译docker,本文对此进行介绍。
一、环境搭建
docker的编译,需要在宿主机预先安装docker软件。因为编译docker的源码时,会构建一个docker镜像并运行,在这个容器里面进行build操作。由于这个容器已经包含了go语言环境,故宿主机无须额外安装golang。
宿主机系统:ubuntu 16.04 64bit
宿主机docker版本:
1 | docker -v |
二、下载源码
docker的github官方网站为:https://github.com/docker/docker-ce/。
docker以每月发布一个版本的节奏进行开发。命名规则为:年份-月份-ce
,其中ce表示社区版本。截至本文撰写时,最新版本为v17.12.0-ce
,但下一版本v18.01.0-ce-dev
已经处于开发阶段(带dev表示开发阶段),本文编译得到的版本即为v18.01.0-ce-dev
。
发行版本下载地址:https://github.com/docker/docker-ce/releases。
本文在/home/latelee/docker/dev
目录进行,请根据实际情况修改目录。
下载源码:
1 | git clone https://github.com/docker/docker-ce |
进入docker-ce目录:
1 | cd docker-ce |
切换到最新的tag:
1 | git checkout -b v18.01.0-ce |
三、编译过程
本节工作目录为/home/latelee/docker/dev/docker-ce目录。
修改Dockerfile
执行下面小节编译命令时会发生一个错误,因此需要预先修改Dockerfile文件。
编译时会构建一个docker镜像来编译,实际执行的命令是(来自components/packaging/deb的makefile,并经过解析生成的): docker build -t debbuild-ubuntu-xenial/x86_64 -f /home/latelee/docker/dev/docker-ce/components/packaging/deb/ubuntu-xenial/Dockerfile.x86_64 .
。
分析components/packaging/deb/ubuntu-xenial/Dockerfile.x86_64
文件,知道其在构建过程会下载golang编译器,因golang.org访问不了,最后会构建失败。因此需要更新下载源。解决方法:找一个国内可下载的网站。如https://dl.gocn.io/。
修改components/packaging/deb/ubuntu-xenial/Dockerfile.x86_64
文件。
将RUN curl -fSL "https://golang.org/dl/go${GO_VERSION}.linux-amd64.tar.gz"; | tar xzC /usr/local
修改为:RUN curl -fSL "https://dl.gocn.io/golang/${GO_VERSION}/go${GO_VERSION}.linux-amd64.tar.gz"; | tar xzC /usr/local
最终会构建出镜像:debbuild-ubuntu-xenial/x86_64
。
注意,这个镜像在后面的编译中会继续使用,因此不需要删除。
编译
进入目录:
1 | cd components/packaging/deb |
deb目录下的Makefile指定了编译得到的是deb包。
执行编译命令:
1 | make VERSION=18.01.0-ce-dev ENGINE_DIR=/home/latelee/docker/dev/docker-ce/components/engine CLI_DIR=/home/latelee/docker/dev/docker-ce/components/cli ubuntu-xenial |
命令解释:
该命令指定了版本号和docker组件的目录(VERSION、ENGINE、CLI分别指版本号、docker引擎、docker命令行),同时指定了要编译的系统版本(ubuntu16.04代号为xenial),这是因为,本文只针对一个系统版本进行编译,而不是编译所有的版本。
生成文件
大约经过半小时,编译成功。最终生成的deb包位于:components\packaging\deb\debbuild\ubuntu-xenial
。
deb文件为:docker-ce_18.01.0~ce~dev~git20171228.105814.0.486a48d-0~ubuntu_amd64.deb
安装
将得到的deb包存放到本机或其它ubuntu系统上,执行以下命令进行安装:
1 | # dpkg -i docker-ce_18.01.0~ce~dev~git20171228.105814.0.486a48d-0~ubuntu_amd64.deb |
验证其版本号:
1 | # docker -v |
到此,docker的编译结束。
四、docker源码目录剖析
docker-ce源码目录如下:
1 | . |
其中组件目录包含三个子目录:cli、engine、packaging。前2个为go代码所在目录,packaging是构建最终二进制文件的目录。内容如下:
1 | . |
其中deb目录是编译生成deb文件的,区别不同的系统版本(如ubuntu和debian,而ubuntu又以代号区别不同版本,其中trusty表示14.04,xenial表示16.04,等等)。比如ubuntu-xenial目录包括了基于16.04的不同平台的Dockerfile。build-deb是运行于前面提到的容器的编译脚本。
详细分析将在后续文档给出。
附录
如果下载release版本进行编译,将得到如此错误:
1 | # WARNING! I don't seem to be running in a Docker container. |
解决方法:
使用git下载代码仓库,然后切换到发布版本分支,再进行编译。
由于docker版本更新非常快,本文所述,仅供参考。