1、命令用法
docker commit -a|--author[=""] -m|--message[=""] CONTAINER [REPOSITORY[:TAG]]
docker version:1.0.0
2、命令分析
例如 docker commit -a=author -m=balabala container-name repo:t
CmdCommit(api/client/command.go)----> PostCommit(api/server/server.go) ---> ContainerCommit(server/server.go)
3 步骤
3.1 CmdCommit
解析命令行参数。
name:Container名
repository:registry名
tag:tag名
if cmd.NArg() == 3 {
fmt.Fprintf(cli.err, "[DEPRECATED] The format 'CONTAINER [REPOSITORY [TAG]]' as been deprecated. Please use CONTAINER [REPOSITORY[:TAG]]\n")
name, repository, tag = cmd.Arg(0), cmd.Arg(1), cmd.Arg(2)
} else {
name = cmd.Arg(0)
repository, tag = utils.ParseRepositoryTag(cmd.Arg(1))
}
解析registry是否正确
if repository != "" {
if _, _, err := registry.ResolveRepositoryName(repository); err != nil {
return err
}
}
请求包变量填充,其中config是名为name的Container配置
v := url.Values{}
v.Set("container", name)
v.Set("repo", repository)
v.Set("tag", tag)
v.Set("comment", *flComment)
v.Set("author", *flAuthor)
var (
config *runconfig.Config
env engine.Env
)
向httpserver发起请求并解析返回的结果
stream, _, err := cli.call("POST", "/commit?"+v.Encode(), config, false)
if err != nil {
return err
}
if err := env.Decode(stream); err != nil {
return err
}
3.2 PostCommit
设置job环境参数
job.Setenv("repo", r.Form.Get("repo"))
job.Setenv("tag", r.Form.Get("tag"))
job.Setenv("author", r.Form.Get("author"))
job.Setenv("comment", r.Form.Get("comment"))
job.SetenvSubEnv("config", &config)
运行job并返回生成的镜像id
if err := job.Run(); err != nil {
return err
}
env.Set("Id", engine.Tail(stdoutBuffer, 1))
3.3 ContainerCommit
得到镜像名并 通过镜像名得到container
name := job.Args[0]
container := srv.daemon.Get(name)
if container == nil {
return job.Errorf("No such container: %s", name)
}
获取Container配置,并新建一个配置变量
var (
config = container.Config
newConfig runconfig.Config
)
将命令上中携带的配置放入newConfig中
if err := job.GetenvJson("config", &newConfig); err != nil {
return job.Error(err)
}
将镜像中的Container配置合入新的配置中
if err := runconfig.Merge(&newConfig, config); err != nil {
return job.Error(err)
}
做提交操作,job环境变量中的repo、tag将在将来要生成的lay作为标记
img, err := srv.daemon.Commit(container, job.Getenv("repo"), job.Getenv("tag"), job.Getenv("comment"), job.Getenv("author"), &newConfig)
if err != nil {
return job.Error(err)
}
3.4 srv .daemon.Commit----> Commit(daemon/daemon.go)
挂在Container的文件系统,Mount操作实际是就是将
if err := container.Mount(); err != nil {
return nil, err
}
对当前layer打包,ExportRw方法使用daemon的diff方法找出文件系统中变化的部分并打包
rwTar, err := container.ExportRw()
if err != nil {
return nil, err
}
创建新的layer
var (
containerID, containerImage string
containerConfig *runconfig.Config
)
if container != nil {
containerID = container.ID
containerImage = container.Image
containerConfig = container.Config
}
img, err := daemon.graph.Create(rwTar, containerID, containerImage, comment, author, containerConfig, config)
if err != nil {
return nil, err
}
如果有tag信息,将tag打到新layer上
if repository != "" {
if err := daemon.repositories.Set(repository, tag, img.ID, true); err != nil {
return img, err
}
}
在向下分析就是文件系统驱动了,比如如何给Container中变动的东东做diff之类的,这部分还需要时间深入的了解docker使用各种文件系统驱动及文件系统本身。