目錄
- docker-cli源碼窺探
- 1.入口函數main()
- 1.1 NewDockerCli()
- 1.2 runDokcer()
- 1.2.1 newDockerCommand()
- 1.2.2 HandleGlobalFlags()
- 1.2.3 Initialize()
- 1.2.4 processAliases()
- 1.2.5 Find()
- 1.2.6 Execute()
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實例
// 入口函數
func main(){
dockerCli,err:=command.NewDockerCli()//1.獲取cli實例...
if err:=runDocker(dockerCli);err!=nil{//執行cli...
os.Exit(1)
}
}
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側的執行過程。
如果說不會搭建調式環境，可以自行百度下
