最近使用docker commit碰到了一个小坑，简单记录在此。
事情是这样的，我们组的一个同学想要修改某个image中的程序启动参数，首先他使用某个镜像运行了一个容器（docker run image:tag /bin/bash），然后在容器内修改了程序的启动参数，最后使用这个容器生成它需要的image（docker commit containerID），通常来说这套操作是没有任何问题的，可是呢这个image一发布立刻就退出了… 根据日志能够观察到的现象是发布的pod起来后立即退出并且没有打印任何日志，但是在我们内部容器平台每个pod中都会有一个引导程序负责启动用户程序同时打印一些日志到stdout和stderr，开始分析问题时我们把关注点主要集中在用户程序的修改上（误以为改错了某些参数），忽略了stdout没有输出任何日志的这个关键信息。经推测没有日志输出很大的可能性是执行命令退出了，顺着没有日志输出这个关键信息排查，很快也定位到了问题所在。验证：分别启动两个新旧image，通过docker ps查看发现这两个容器的CMD指令不一致，老image的CMD=‘/bin/sh -c /bin/init’，新image的CMD=‘/bin/bash’，很明显修改后的CMD覆盖掉了修改前的。
那么接下来简单分析下CMD是如何被覆盖的，修改前image的cmd=‘/bin/sh -c /bin/init’，然后docker run -dit image:tag /bin/bash启动了容器并且进入到容器内部修改了应用程序相关参数，紧接着执行docker commit & docker push。起初以为docker commit会给新创建的image设置一个默认cmd (/bin/bash)，通过阅读代码了解到commit会将容器当前使用的cmd设置给新创建的image。也就是原来image的cmd被刚才commit时指定的容器cmd覆盖了。
知道了问题我们就来想想解决办法吧，目前想到了两种方式：
1. 如果希望cmd不变，那么就需要保证运行的容器cmd正确，针对上边提到的case可以在docker run一个容器时不指定cmd（docker run -dit image:tag），这样就会使用默认的cmd运行容器，此时再commit就不会出现上边提到的问题。
2. docker commit时可以指定--change参数替换image中的cmd，比如：--change=‘CMD ["/bin/sh", "-c", "/bin/init"]'
这部分代码逻辑相对比较简单，具体处理逻辑大家感兴趣可以自行阅读：
docker commit 处理逻辑：
1. docker client拼装请求发送到docker daemon的”/commit”接口
2. docker daemon接收到请求以后在postCommit()中调用CreateImageFromContainer()，在CreateImageFromContainer()函数中可以看到，首先根据容器ID找到容器的运行时信息，然后根据运行时的config信息生成一个用于创建image的config，最后根据这个newConfig生成一个新的image（config结构中包含了CMD、ENTRYPOINT等）
3. 另外也可以看到docker commit时如果参数中指定了changes那么在函数BuildFromConfig()中会优先使用changes指定的指令构建image的config（也就是覆盖了上一个容器的相关指令）
Docker Client：
|— NewCommitCommand (components/cli/cli/command/container/commit.go)
|— runCommit (components/cli/cli/command/container/commit.go)
|— ContainerCommit (components/engine/client/container_commit.go)
Docker Daemon:
|— initRoutes (components/engine/api/server/router/container/container.go)
|— postCommit (components/engine/api/server/router/container/container_routes.go)
|— CreateImageFromContainer (components/engine/daemon/commit.go)
|— daemon.GetContainer
|— dockerfile.BuildFromConfig
|— daemon.imageService.CommitImage