• 1. Docker Server创建流程
    • 1.1. 创建“serverapi”的Job
    • 1.2. 配置Job环境变量
    • 1.3. 运行Job
  • 2. ServeApi运行流程
    • 2.1. 判断Job参数
    • 2.2. 定义监听协议与地址及错误信息
    • 2.3. 遍历协议地址
    • 2.4. 协调chErrors与主进程关系
  • 3. ListenAndServe实现
    • 3.1. 创建route路由实例
      • 3.1.1. 创建空路由实例
      • 3.1.2. 添加路由记录
    • 3.2. 创建listener监听实例
    • 3.3. 创建http.Server
    • 3.4. 启动API服务

    1. Docker Server创建流程

    Docker Server是Daemon Server的重要组成部分,功能:接收Docker Client发送的请求,并按照相应的路由规则实现请求的路由分发,最终将请求处理的结果返回给Docker Client。
    Docker Daemon启动,在mainDaemon()运行的最后创建并运行serverapi的Job,让Docker Daemon提供API访问服务。
    Docker Server的整个生命周期

    1. 创建Docker Server的Job
    2. 配置Job的环境变量
    3. 触发执行Job

    说明:本文分析的代码为Docker 1.2.0版本。

    1.1. 创建“serverapi”的Job

    /docker/daemon.go

    1. func mainDaemon() {
    2. ...
    3. // Serve api
    4. job := eng.Job("serveapi", flHosts...)
    5. ...
    6. }

    运行serverapi的Job时,会执行该Job的处理方法api.ServeApi。

    1.2. 配置Job环境变量

    /docker/daemon.go

    1. job.SetenvBool("Logging", true)
    2. job.SetenvBool("EnableCors", *flEnableCors)
    3. job.Setenv("Version", dockerversion.VERSION)
    4. job.Setenv("SocketGroup", *flSocketGroup)
    5. job.SetenvBool("Tls", *flTls)
    6. job.SetenvBool("TlsVerify", *flTlsVerify)
    7. job.Setenv("TlsCa", *flCa)
    8. job.Setenv("TlsCert", *flCert)
    9. job.Setenv("TlsKey", *flKey)
    10. job.SetenvBool("BufferRequests", true)

    参数分为两种

    • 创建Job实例时,用指定参数直接初始化Job的Args属性
    • 创建Job后,给Job添加指定的环境变量
    环境变量名 FLAG参数 默认 作用值
    Logging true 启用Docker容器的日志输出
    EnableCors flEnableCors false 在远程API中提供CORS头
    Version 显示Docker版本号
    SocketGroup flSockerGroup docker 在daemon模式中unix domain socket分配用户组名
    Tls flTls false 使用TLS安全传输协议
    TlsVerify flTlsVerify false 使用TLS并验证远程客户端
    TlsCa flCa 指定CA文件路径
    TlsCert flCert TLS证书文件路径
    TlsKey flKey TLS密钥文件路径
    BufferRequest true 缓存Docker Client请求

    1.3. 运行Job

    /api/server/server.go

    1. if err := job.Run(); err != nil {
    2. log.Fatal(err)
    3. }

    Docker在eng对象中注册过键位serverapi的处理方法,在运行Job的时候执行这个处理方法的值函数,相应的处理方法的值为api.ServeApi。

    2. ServeApi运行流程

    ​ ServeApi属于Docker Server提供API服务的部分,作为一个监听请求、处理请求、响应请求的服务端,支持三种协议:TCP协议、UNIX Socket形式以及fd的形式。功能是:循环检查Docker Daemon支持的所有协议,并为每一种协议创建一个协程goroutine,并在协程内部配置一个服务于HTTP请求的服务端。

    /api/server/server.go

    1. // ServeApi loops through all of the protocols sent in to docker and spawns
    2. // off a go routine to setup a serving http.Server for each.
    3. func ServeApi(job *engine.Job) engine.Status {
    4. if len(job.Args) == 0 {
    5. return job.Errorf("usage: %s PROTO://ADDR [PROTO://ADDR ...]", job.Name)
    6. }
    7. var (
    8. protoAddrs = job.Args
    9. chErrors = make(chan error, len(protoAddrs))
    10. )
    11. activationLock = make(chan struct{})
    12. for _, protoAddr := range protoAddrs {
    13. protoAddrParts := strings.SplitN(protoAddr, "://", 2)
    14. if len(protoAddrParts) != 2 {
    15. return job.Errorf("usage: %s PROTO://ADDR [PROTO://ADDR ...]", job.Name)
    16. }
    17. go func() {
    18. log.Infof("Listening for HTTP on %s (%s)", protoAddrParts[0], protoAddrParts[1])
    19. chErrors <- ListenAndServe(protoAddrParts[0], protoAddrParts[1], job)
    20. }()
    21. }
    22. for i := 0; i < len(protoAddrs); i += 1 {
    23. err := <-chErrors
    24. if err != nil {
    25. return job.Error(err)
    26. }
    27. }
    28. return engine.StatusOK
    29. }

    ServeApi执行流程:

    1. 检查Job参数,确保传入参数无误
    2. 定义Docker Server的监听协议与地址,以及错误信息管理channel
    3. 遍历协议地址,针对协议创建相应的服务端
    4. 通过chErrors建立goroutine与主进程之间的协调关系

    2.1. 判断Job参数

    判断Job参数,job.Args,即数组flHost,若flHost的长度为0,则说明没有监听的协议与地址,参数有误。

    /api/server/server.go

    1. func ServeApi(job *engine.Job) engine.Status {
    2. if len(job.Args) == 0 {
    3. return job.Errorf("usage: %s PROTO://ADDR [PROTO://ADDR ...]", job.Name)
    4. }
    5. ...
    6. }

    2.2. 定义监听协议与地址及错误信息

    /api/server/server.go

    1. var (
    2. protoAddrs = job.Args
    3. chErrors = make(chan error, len(protoAddrs))
    4. )
    5. activationLock = make(chan struct{})

    定义protoAddrs[flHosts的内容]、chErrors[错误类型管道]与activationLock[同步serveapi和acceptconnections两个job执行的管道]三个变量,

    2.3. 遍历协议地址

    /api/server/server.go

    1. for _, protoAddr := range protoAddrs {
    2. protoAddrParts := strings.SplitN(protoAddr, "://", 2)
    3. if len(protoAddrParts) != 2 {
    4. return job.Errorf("usage: %s PROTO://ADDR [PROTO://ADDR ...]", job.Name)
    5. }
    6. go func() {
    7. log.Infof("Listening for HTTP on %s (%s)", protoAddrParts[0], protoAddrParts[1])
    8. chErrors <- ListenAndServe(protoAddrParts[0], protoAddrParts[1], job)
    9. }()
    10. }

    遍历协议地址,针对协议创建相应的服务端。协议地址

    2.4. 协调chErrors与主进程关系

    根据chErrors的值运行,如果chErrors这个管道中有错误内容,则ServerApi一次循环结束,若无错误内容,循环被阻塞。即chErrors确保ListenAndServe所对应的协程能和主函数ServeApi进行协调,如果协程出错,主函数ServeApi仍然可以捕获这样的错误,从而导致程序退出。

    /api/server/server.go

    1. for i := 0; i < len(protoAddrs); i += 1 {
    2. err := <-chErrors
    3. if err != nil {
    4. return job.Error(err)
    5. }
    6. }
    7. return engine.StatusOK

    3. ListenAndServe实现

    ListenAndServe的功能:使Docker Server监听某一指定地址,并接收该地址的请求,并对以上请求路由转发至相应的处理方法处。
    ListenAndServe执行流程:

    1. 创建route路由实例
    2. 创建listener监听实例
    3. 创建http.Server
    4. 启动API服务

    流程图:
    Docker Server - 图1

    3.1. 创建route路由实例

    /api/server/server.go

    1. // ListenAndServe sets up the required http.Server and gets it listening for
    2. // each addr passed in and does protocol specific checking.
    3. func ListenAndServe(proto, addr string, job *engine.Job) error {
    4. var l net.Listener
    5. r, err := createRouter(job.Eng, job.GetenvBool("Logging"), job.GetenvBool("EnableCors"), job.Getenv("Version"))
    6. if err != nil {
    7. return err
    8. }
    9. ...
    10. }

    路由实例的作用:负责Docker Server对外部请求的路由及转发。
    实现过程:

    1. 创建全新的route路由实例
    2. 为route实例添加路由记录

    3.1.1. 创建空路由实例

    /api/server/server.go

    1. func createRouter(eng *engine.Engine, logging, enableCors bool, dockerVersion string) (*mux.Router, error) {
    2. r := mux.NewRouter()
    3. ...
    4. }

    /vendor/src/github.com/gorilla/mux/mux.go

    1. // NewRouter returns a new router instance.
    2. func NewRouter() *Router {
    3. return &Router{namedRoutes: make(map[string]*Route), KeepContext: false}
    4. }
    5. // This will send all incoming requests to the router.
    6. type Router struct {
    7. // Configurable Handler to be used when no route matches.
    8. NotFoundHandler http.Handler
    9. // Parent route, if this is a subrouter.
    10. parent parentRoute
    11. // Routes to be matched, in order.
    12. routes []*Route
    13. // Routes by name for URL building.
    14. namedRoutes map[string]*Route
    15. // See Router.StrictSlash(). This defines the flag for new routes.
    16. strictSlash bool
    17. // If true, do not clear the request context after handling the request
    18. KeepContext bool
    19. }

    NewRoute()函数返回一个全新的route实例r,类型为mux.Router。实例初始化nameRoutes和KeepContext。

    • nameRoutes:map类型,key为string类型,value为Route路由记录类型
    • KeepContext:属性为false,则处理完请求后清除请求内容,不对请求做存储操作

    mux.Router会通过一系列已经注册过的路由记录,来匹配接收的请求。先通过请求的URL或者其他条件找到相应的路由记录,并调用这条记录中的执行处理方法。
    mux.Router特性

    • 请求可以基于URL的主机名、路径、路径前缀、shemes、请求头和请求值、HTTP请求方法类型或者使用自定义的匹配规则
    • URL主机名和路径可以通过一个正则表达式来表示
    • 注册的URL可以直接被运用,也可以保留从而保证维护资源的使用
    • 路由记录同样看可以作用于子路由记录

    3.1.2. 添加路由记录

    /api/server/server.go

    1. if os.Getenv("DEBUG") != "" {
    2. AttachProfiler(r)
    3. }
    4. m := map[string]map[string]HttpApiFunc{
    5. "GET": {
    6. "/_ping": ping,
    7. "/events": getEvents,
    8. "/info": getInfo,
    9. "/version": getVersion,
    10. "/images/json": getImagesJSON,
    11. "/images/viz": getImagesViz,
    12. "/images/search": getImagesSearch,
    13. "/images/{name:.*}/get": getImagesGet,
    14. "/images/{name:.*}/history": getImagesHistory,
    15. "/images/{name:.*}/json": getImagesByName,
    16. "/containers/ps": getContainersJSON,
    17. "/containers/json": getContainersJSON,
    18. "/containers/{name:.*}/export": getContainersExport,
    19. "/containers/{name:.*}/changes": getContainersChanges,
    20. "/containers/{name:.*}/json": getContainersByName,
    21. "/containers/{name:.*}/top": getContainersTop,
    22. "/containers/{name:.*}/logs": getContainersLogs,
    23. "/containers/{name:.*}/attach/ws": wsContainersAttach,
    24. },
    25. "POST": {
    26. "/auth": postAuth,
    27. "/commit": postCommit,
    28. "/build": postBuild,
    29. "/images/create": postImagesCreate,
    30. "/images/load": postImagesLoad,
    31. "/images/{name:.*}/push": postImagesPush,
    32. "/images/{name:.*}/tag": postImagesTag,
    33. "/containers/create": postContainersCreate,
    34. "/containers/{name:.*}/kill": postContainersKill,
    35. "/containers/{name:.*}/pause": postContainersPause,
    36. "/containers/{name:.*}/unpause": postContainersUnpause,
    37. "/containers/{name:.*}/restart": postContainersRestart,
    38. "/containers/{name:.*}/start": postContainersStart,
    39. "/containers/{name:.*}/stop": postContainersStop,
    40. "/containers/{name:.*}/wait": postContainersWait,
    41. "/containers/{name:.*}/resize": postContainersResize,
    42. "/containers/{name:.*}/attach": postContainersAttach,
    43. "/containers/{name:.*}/copy": postContainersCopy,
    44. },
    45. "DELETE": {
    46. "/containers/{name:.*}": deleteContainers,
    47. "/images/{name:.*}": deleteImages,
    48. },
    49. "OPTIONS": {
    50. "": optionsHandler,
    51. },
    52. }

    m的类型为映射,key表示HTTP的请求类型,如GET、POST、DELETE等,value为映射类型,代表URL与执行处理方法的映射。

    /api/server/server.go

    1. type HttpApiFunc func(eng *engine.Engine, version version.Version, w http.ResponseWriter, r *http.Request, vars map[string]string) error

    3.2. 创建listener监听实例

    路由模块完成请求的路由与分发,监听模块完成请求的监听功能。Listener是一种面向流协议的通用网络监听模块。

    /api/server/server.go

    1. var l net.Listener
    2. ...
    3. if job.GetenvBool("BufferRequests") {
    4. l, err = listenbuffer.NewListenBuffer(proto, addr, activationLock)
    5. } else {
    6. l, err = net.Listen(proto, addr)

    Listenbuffer的作用:让Docker Server立即监听指定协议地址上的请求,但将这些请求暂时先缓存下来,等Docker Daemon全部启动完毕之后才让Docker Server开始接受这些请求。

    /pkg/listenbuffer/buffer.go

    1. // NewListenBuffer returns a listener listening on addr with the protocol.
    2. func NewListenBuffer(proto, addr string, activate chan struct{}) (net.Listener, error) {
    3. wrapped, err := net.Listen(proto, addr)
    4. if err != nil {
    5. return nil, err
    6. }
    7. return &defaultListener{
    8. wrapped: wrapped,
    9. activate: activate,
    10. }, nil
    11. }

    若协议类型为TCP,Job环境变量中Tls或TlsVerity有一个为true,则说明Docker Server需要支持HTTPS服务。需要建立一个tls.Config类型实例tlsConfig,在tlsConfig中加载证书、认证信息,通过tls包中的NewListener函数创建HTTPS协议请求的Listener实例。

    /api/server/server.go

    1. l = tls.NewListener(l, tlsConfig)

    3.3. 创建http.Server

    /api/server/server.go

    1. httpSrv := http.Server{Addr: addr, Handler: r}

    Docker Server需要创建一个Server对象来运行HTTP/HTTPS服务端,创建http.Server,addr为需要监听的地址,r为mux.Router。

    3.4. 启动API服务

    创建http.Server实例后,即启动API服务,监听请求,并对每一个请求生成一个新的协程来做专属服务。对于每个请求,协程会读取请求,查询路由表中的路由记录项,找到匹配的路由记录,最终调用路由记录中的处理方法,执行完毕返回响应信息。

    /api/server/server.go

    1. return httpSrv.Serve(l)

    参考:

    • 《Docker源码分析》