Contents

• docker二进制代码编译流程
• 其他编译方法
• Makefile

docker二进制代码编译流程

docker如何编译，在 官网 进行了介绍。

其实很简单，就是在docker源码中有一个makefile文件，执行make，就可以进行编译了。

我们从源码来看一下make的过程。

首先看一下Makefile。

...
DOCKER_MOUNT := $(if $(BINDDIR),-v "$(CURDIR)/$(BINDDIR):/go/src/github.com/docker/docker/$(BINDDIR)")
DOCKER_RUN_DOCKER := docker run --rm -it --privileged -e TIMEOUT -e BUILDFLAGS -e TESTFLAGS -e TESTDIRS -e DOCKER_GRAPHDRIVER -e DOCKER_EXECDRIVER $(DOCKER_MOUNT) "$(DOCKER_IMAGE)"
...
binary: build
   $(DOCKER_RUN_DOCKER) hack/make.sh binary
...
build: bundles
docker build -t "$(DOCKER_IMAGE)" .
...
bundles:
   mkdir bundles

执行make binary。会首先创建bundles文件夹，然后执行docker build，通过dockerfile创建镜像（这一步其实可以直接从官网pull镜像而不用自己build，下面详细讲）。然后将容器run起来，通过-v参数，将容器中的bundles同物理机的该路径下的bundles文件夹绑定起来，然后启动容器。容器执行了hack/dind命令，编译docker，将编译好的文件放在了bundles中。从而在物理机上也可见。

对于docker的二进制代码编译采取了一种极为dockerful的方式。因为搭建docker的编译环境可能会较为繁琐，docker直接提供给了一个 docker-dev 的镜像给用户。获得这个镜像有两种方式，一种是直接下载。用户只需要下载这个镜像，就可以在这个镜像中进行docker的二进制代码的编译了。另一种，就是使用Dockerfile进行进行build，来获取镜像。Dockerfile文件就在docker源码的根目录下。这种方式比较耗时，不推荐。

有了docker-dev镜像，其实不必每次都要docker build镜像，而只需要利用原有镜像就可以了。那么我修改了Makefile文件，从而可以支持能够使用docker-dev镜像进行编译。更新后的Makefile在末尾附带。

在我的里面支持了多种方式来灵活使用本地环境：

通过build方式
make DOCKER_COMMAND=build

通过pull方式（默认，pull与本版本相同的docker-dev镜像）
make

通过pull方式，指定本地镜像（不再pull镜像）
make DOCKER_IMAGE=docker-dev:v1.2

其他编译方法

另外一种方法，就是把你的代码上传到github上。

然后在 https://registry.hub.docker.com 上面，注册，选择自己的github项目，进行自动编译。

这种方式真心慢，没个半小时弄不出来（实测是20min），虽然是官方推荐。但是我感觉这更像是给他们自己做的一种硬广告。。。

Makefile

.PHONY: all binary build cross default docs docs-build docs-shell shell test test-unit test-integration test-integration-cli test-docker-py validate

# env vars passed through directly to Docker‘s build scripts
# to allow things like `make DOCKER_CLIENTONLY=1 binary` easily
# `docs/sources/contributing/devenvironment.md ` and `project/PACKAGERS.md` have some limited documentation of some of these
DOCKER_ENVS :=    -e BUILDFLAGS    -e DOCKER_CLIENTONLY    -e DOCKER_EXECDRIVER    -e DOCKER_GRAPHDRIVER    -e TESTDIRS    -e TESTFLAGS    -e TIMEOUT
# note: we _cannot_ add "-e DOCKER_BUILDTAGS" here because even if it‘s unset in the shell, that would shadow the "ENV DOCKER_BUILDTAGS" set in our Dockerfile, which is very important for our official builds

# to allow pull docker-dev image from registry.hub.docker.com and avoid building every time
# allow `make DOCKER_COMMAND=build` to build image from Dockerfile
DOCKER_COMMAND := pull

DOCKER_VERSION := $(shell cat VERSION)

# to allow `make BIND_DIR=. shell` or `make BIND_DIR= test`
# (default to no bind mount if DOCKER_HOST is set)
# note: BINDDIR is supported for backwards-compatibility here
BIND_DIR := $(if $(BINDDIR),$(BINDDIR),$(if $(DOCKER_HOST),,bundles))

DOCKER_BUILD_MOUNT := $(if $(BIND_DIR),-v "$(CURDIR)/$(BIND_DIR):/go/src/github.com/docker/docker/$(BIND_DIR)")
DOCKER_PULL_MOUNT := -v "$(CURDIR):/go/src/github.com/docker/docker"

# to allow `make DOCSDIR=docs docs-shell` (to create a bind mount in docs)
DOCS_MOUNT := $(if $(DOCSDIR),-v $(CURDIR)/$(DOCSDIR):/$(DOCSDIR))

# to allow `make DOCSPORT=9000 docs`
DOCSPORT := 8000

GIT_BRANCH := $(shell git rev-parse --abbrev-ref HEAD 2>/dev/null)

# to allow you miss .git directory
DOCKER_ENVS += $(if $(GIT_BRANCH),,-e DOCKER_GITCOMMIT=$(DOCKER_VERSION))

DOCKER_BUILD_IMAGE := docker$(if $(GIT_BRANCH),:$(GIT_BRANCH))
DOCKER_PULL_IMAGE := docker-dev:$(if $(DOCKER_VERSION),$(DOCKER_VERSION))

# to allow `make DOCKER_IMAGE=docker-dev:v1.2`(to use some other image if needed)
ifeq ($(DOCKER_COMMAND),pull)
   DOCKER_IMAGE := $(DOCKER_PULL_IMAGE)
   DOCKER_MOUNT := $(DOCKER_PULL_MOUNT)
else
   DOCKER_IMAGE := $(DOCKER_BUILD_IMAGE)
   DOCKER_MOUNT := $(DOCKER_BUILD_MOUNT)
endif

DOCKER_DOCS_IMAGE := docker-docs$(if $(GIT_BRANCH),:$(GIT_BRANCH))

DOCKER_RUN_DOCKER := docker run --rm -it --privileged $(DOCKER_ENVS) $(DOCKER_MOUNT) "$(DOCKER_IMAGE)"

DOCKER_RUN_DOCS := docker run --rm -it $(DOCS_MOUNT) -e AWS_S3_BUCKET -e NOCACHE

# for some docs workarounds (see below in "docs-build" target)
GITCOMMIT := $(shell git rev-parse --short HEAD 2>/dev/null)

default: binary

all: $(DOCKER_COMMAND)
   $(DOCKER_RUN_DOCKER) hack/make.sh

binary: $(DOCKER_COMMAND)
   $(DOCKER_RUN_DOCKER) hack/make.sh binary

cross: $(DOCKER_COMMAND)
   $(DOCKER_RUN_DOCKER) hack/make.sh binary cross

docs: docs-build
   $(DOCKER_RUN_DOCS) -p $(if $(DOCSPORT),$(DOCSPORT):)8000 "$(DOCKER_DOCS_IMAGE)" mkdocs serve

docs-shell: docs-build
   $(DOCKER_RUN_DOCS) -p $(if $(DOCSPORT),$(DOCSPORT):)8000 "$(DOCKER_DOCS_IMAGE)" bash

docs-release: docs-build
   $(DOCKER_RUN_DOCS) -e OPTIONS -e BUILD_ROOT -e DISTRIBUTION_ID       -v $(CURDIR)/docs/awsconfig:/docs/awsconfig       "$(DOCKER_DOCS_IMAGE)" ./release.sh

docs-test: docs-build
   $(DOCKER_RUN_DOCS) "$(DOCKER_DOCS_IMAGE)" ./test.sh

test: $(DOCKER_COMMAND)
   $(DOCKER_RUN_DOCKER) hack/make.sh binary cross test-unit test-integration test-integration-cli test-docker-py

test-unit: $(DOCKER_COMMAND)
   $(DOCKER_RUN_DOCKER) hack/make.sh test-unit

test-integration: $(DOCKER_COMMAND)
   $(DOCKER_RUN_DOCKER) hack/make.sh test-integration

test-integration-cli: $(DOCKER_COMMAND)
   $(DOCKER_RUN_DOCKER) hack/make.sh binary test-integration-cli

test-docker-py: $(DOCKER_COMMAND)
   $(DOCKER_RUN_DOCKER) hack/make.sh binary test-docker-py

validate: $(DOCKER_COMMAND)
   $(DOCKER_RUN_DOCKER) hack/make.sh validate-gofmt validate-dco validate-toml

shell: $(DOCKER_COMMAND)
   $(DOCKER_RUN_DOCKER) bash

pull:
   docker pull "$(DOCKER_IMAGE)"

build: bundles
   docker build -t "$(DOCKER_IMAGE)" .

docs-build:
   git fetch https://github.com/docker/docker.git docs && git diff --name-status FETCH_HEAD...HEAD -- docs > docs/changed-files
   cp ./VERSION docs/VERSION
   echo "$(GIT_BRANCH)" > docs/GIT_BRANCH
#  echo "$(AWS_S3_BUCKET)" > docs/AWS_S3_BUCKET
   echo "$(GITCOMMIT)" > docs/GITCOMMIT
   docker build -t "$(DOCKER_DOCS_IMAGE)" docs

bundles:
   mkdir bundles

将Makefile拷贝到自己的docker工程中即可。

来自为知笔记(Wiz)