Docker - 02Client

写在前面

自从20.10版本,原来Docker-CE的仓库就不再使用，而是分成了Docker CLI和Docker Engine,后续涉及源码的地方都将基于v20.10.12展开

Docker Client

​​docker [OPTIONS] COMMAND [arg...]​​

docker client入口函数在cmd/docker/docker.go

01 初始化DockerCli

调用cli/command/cli.go/NewDockerCli实例化一个cli,这里会去获取环境变量、设置默认的store.Config、配置默认的标准输入输出及错误输出

DockerCli将作为客户端的上下文存在于整个生命周期

type DockerCli struct {
	configFile         *configfile.ConfigFile
	in                 *streams.In
	out                *streams.Out
	err                io.Writer
	client             client.APIClient
	serverInfo         ServerInfo
	clientInfo         *ClientInfo
	contentTrust       bool
	contextStore       store.Store
	currentContext     string
	dockerEndpoint     docker.Endpoint
	contextStoreConfig store.Config
}

02 runDocker

1. 初始化命令模版: 在newDockerCommand中初始化命令行模版,命令模版:vendor/github.com/spf13/cobra/command.go/command
2. 初始化Flags并关联Options: cli/flags/common.go/InstallFlags

   type CommonOptions struct {
       Debug      bool
       Hosts      []string
       LogLevel   string
       TLS        bool
       TLSVerify  bool
       TLSOptions *tlsconfig.Options
       Context    string
   }

3. 初始化命令: cli/command/commands/commands.go/AddCommands,cli/command/container下包含容器相关的命令,cli/command/image下包含镜像相关的命令,以此类推
4. 解析传入的Options cli/cobra.go/HandleGlobalFlags,将os.Args的Options切分后面就是args
5. 初始化Options cli/cobra.go/Initialize, 初始化APIClient(用于和daemon通信)
6. 解析os.Args后面的args,匹配相关命令
7. 执行匹配到的命令

源码编译cli

cli是在docker容器中编译的,但是通过dockerfile构建容器时可能会遇到网络问题导致部分依赖拉取失败

1. 修改dockerfiles/Dockerfile.binary-native,换源

   #...
   FROM    golang:${GO_VERSION}-alpine
   #换源
   RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.aliyun.com/g' /etc/apk/repositories
   
   RUN     apk add -U git bash coreutils gcc musl-dev
   #...

2. 修改dockerfiles/Dockerfile.dev,添加代理, GOPROXY=https://goproxy.cn,direct

   # ...
   FROM golang AS esc
   ARG ESC_VERSION=v0.2.0
   RUN --mount=type=cache,target=/root/.cache/go-build \
       --mount=type=cache,target=/go/pkg/mod \
       --mount=type=tmpfs,target=/go/src/ \
       GO111MODULE=on GOPROXY=https://goproxy.cn,direct go install github.com/mjibson/esc@${ESC_VERSION}
   
   FROM golang AS gotestsum
   ARG GOTESTSUM_VERSION=v0.4.0
   RUN --mount=type=cache,target=/root/.cache/go-build \
       --mount=type=cache,target=/go/pkg/mod \
       --mount=type=tmpfs,target=/go/src/ \
       GO111MODULE=on GOPROXY=https://goproxy.cn,direct go install gotest.tools/gotestsum@${GOTESTSUM_VERSION}
   
   FROM golang AS vndr
   ARG VNDR_VERSION=v0.1.2
   RUN --mount=type=cache,target=/root/.cache/go-build \
       --mount=type=cache,target=/go/pkg/mod \
       --mount=type=tmpfs,target=/go/src/ \
       GO111MODULE=on GOPROXY=https://goproxy.cn,direct go install github.com/LK4D4/vndr@${VNDR_VERSION}
   #...

3. sudo make -f docker.Makefile binary, 最后二进制文件在工作目录下的build