docker-cli源码窥探

最近一直在使用docker，看了一些书和教程，但是一直停在使用的层面，但总觉得不够深入，故决定看看源码，学习优秀的项目。

我将以docker ps -a 命令为例探究docker命令在 client侧的执行过程，源码的版本为20.10,。 选择docker ps -a的原因是，逻辑比较简单，且通过debug跟踪发现，该命令覆盖了大部分的代码逻辑。

为了突出显示重要的代码和节省篇幅，我将会隐藏部分代码，以 … 代替。

docker cli 项目的入口函数是 cli/cmd/docker/docker.go 文件中的main()函数。

1.入口函数main()

main()函数中仅包含两步骤：

• 先通过NewDockerCli() 获取一个docker cli实例；
• 然后通过runDocker()运行该cli实例

1.1 NewDockerCli()

NewDockerCli() 中主要涉及一些对cli实例的配置，如内容置信开关（默认是关闭的），还有其他一些参数。这里与具体的执行关系不大，就不赘述了。

1.2 runDokcer()

runDokcer()是真正命令开始解析执行的地方。

runDocker()总体过程是：

• 首先通过newDockerCommand()实例化一个顶级命令（即 docker XXX）；
• 通过HandleGlobalFlags()对顶级命令做一些配置；
• 通过Initialize()对顶级命令初始化，主要涉及配置文件方面；
• 通过processAliases()处理命令别名；
• 通过Find() 判断顶级命令后的 根命令是否合规。
• 最终通过Execute()开始执行顶级命令

1.2.1 newDockerCommand()

在newDockerCommand()中会首先实例化一个cmd，cmd中有一个RunE字段，该字段为函数类型，这是docker命令默认执行的逻辑，如果docker 后面不加参数，默认会显示help, 而实际执行时，确实是显示了help信息。

在cmd实例创建之后，会对该实例进行一些配置，如：添置一些模板函数，错误处理，帮助信息打印等。

newDockerCommand()中另一个重要的函数是AddCommands()，该函数会将所有的根命令（例如，ps 、image、 build等等，现阶段一共53个 ），添加至cmd中：

最终通过 NewTopLevelCommand()将cmd封装为一个顶级命令并返回。

1.2.2 HandleGlobalFlags()

对于该函数，我理解的其作用主要是将tcmd中的顶级命令及后面的参数取出来，以docker ps -a为例，cmd 就是docker命令，而返回为args则包含了ps -a。

1.2.3 Initialize()

此函数中主要是一些配置动作，包括与安全有关的一些配置，读取配置文件的动作，此处就不详细阐述了。

1.2.4 processAliases()

此函数主要处理一些命令别名，也略过了

1.2.5 Find()

Find()的主要作用是对命令做一些合规性检查。例如：是不是在不该加参数的命令后面加了参数，是不是输入了根本不存在命令等。

这里调用findNext()的主要目的是，判断在AddCommands()中添加的53个根命令，是否包含args中的命令。

举个例子，args 为 ["ps"," -a"]， 那么此时Find的作用就是判断 AddCommands()函数中有没有添加与Ps有关的命令。通过查询，发现AddCommands()是包含Ps命令的。

后面，Execute() 会再次调用findNext()函数。

1.2.6 Execute()

Execute()实际会调用 ExecuteC()。

在ExecuteC()，会调用Traverse()，获取c中的根命令,即ps -a 。并通过execute()执行该命令。

1.2.6.1 Traverse()

Traverse函数中通过递归和findNext() 的结合实现根命令提，并将命令及参数返回。

1.2.6.2 execute()

回到ExecuteC()中调用的execute()，执行最后获取到了ps -a命令，函数中包含了一系列的前置和后置函数，但是最重要 的是RunE()。

要注意，此时的RunE，已经不在顶级命令docker 的RunE，而是通过Traverse()函数获取的NewPsCommand()中的RunE。该RunE中调用了runPs()获取容器信息。

1.2.6.1.1 runPs()

runPs() 中，通过ContainerList接口，获取所有的容器信息，并输出相关结果。

1.2.6.1.2 ContainerList()

在ContainerList的接口实现中，发现此处通过向docker server发送一个get请求，获取所有容器信息，然后返回，并由runPs()打印相关信息。

至此，整个docker ps -a 命令在docker client侧的解析执行过程就结束了，在此过程中涉及的函数众多，且功能繁杂，但是代码并不难懂。相信在明白这个命令之后，其他命令也能更容易学习。本人能力有限，难以将每个函数讲清楚，建议大家可以自行搭建调式环境，通过打断点的方式深入了解。后续，我也将更新docker ps -a 命令在docker server侧的执行过程。

如果说不会搭建调式环境，可以自行百度下