# 提交一个容器为镜像（不指定标签）
docker commit my-container

# 提交并指定镜像名和标签
docker commit my-container myapp:v1.0

# 提交时添加消息和作者信息
docker commit -a "developer@example.com" -m "added curl for debugging" my-container myapp:v1.0

# 提交时修改启动命令
docker commit --change='CMD ["nginx", "-g", "daemon off;"]' my-container myapp:v2.0

# 提交时暴露端口
docker commit --change='EXPOSE 80' my-container myapp:web

# 进入容器安装调试工具
docker run -it --name debug alpine sh
/ # apk add curl vim net-tools
/ # exit

# 将调试好的环境保存为镜像
docker commit debug debug-image:with-tools

# 以后可以直接用这个镜像，不用重新安装
docker run -it --rm debug-image:with-tools sh

# 场景：生产环境有紧急 Bug，来不及改 Dockerfile
docker exec -it myapp sh
# 在容器内修复配置或补丁
/ # vi /app/config.py  # 或者替换文件

# 将修复后的容器保存为镜像
docker commit -m "hotfix: fixed DB connection timeout" myapp myapp:hotfix-v1

# 用新镜像重新部署
docker stop myapp && docker rm myapp
docker run -d --name myapp myapp:hotfix-v1

# 在有状态容器升级前做快照
docker commit -p -m "snapshot before upgrade v1.1" myapp myapp:snapshot-pre-v1.1

# 如果升级出问题，可以回滚
docker stop myapp && docker rm myapp
docker run -d --name myapp myapp:snapshot-pre-v1.1

# 问题1：不可复现
# 容器中安装的软件依赖于运行时网络、仓库状态
# 换一台机器用 Dockerfile 重新构建可能得到不同的结果
# 或者忘了自己做了什么操作

# 问题2：包含多余文件
# commit 会保留容器中的所有变更，包括：
# - apt-get 下载的缓存
# - 临时文件
# - 敏感信息（密码文件、密钥等）

# 问题3：镜像层难以管理
# commit 会产生新的镜像层
# 但这个层中的内容是什么，只能靠 -m 消息了解
# 无法像 Dockerfile 一样逐行审查

# ✅ 合理的场景
# 1. 交互式调试后保存测试用镜像
# 2. 应急热修复（事后还是要补 Dockerfile）
# 3. 临时快照备份
# 4. 教学演示

# ❌ 不合理的场景
# 1. 作为 CI/CD 构建方式
# 2. 替代 Dockerfile
# 3. 生产环境正式交付

# 1. 提交前暂停容器（默认行为）
docker commit -p my-app myapp:v1
# -p 参数确保文件系统一致性

# 2. 使用 --change 修复 CMD
# 如果容器启动命令是 sh，commit 后镜像默认也是 sh
# 用 --change 改成正确的启动命令
docker commit \
  --change='CMD ["node", "app.js"]' \
  --change='EXPOSE 3000' \
  myapp myapp:fixed

# 3. 提交后验证
docker run --rm myapp:fixed node app.js

# docker commit 做的事情：
# 1. 暂停容器（如果 -p=true）
# 2. 获取容器文件系统的 diff（变化的层）
# 3. 创建一个新的镜像，包含原始镜像层 + diff 层
# 4. 新的镜像 ID = 基于 diff 内容的 hash

# 查看镜像的层历史
docker history myapp:committed
# IMAGE          CREATED          CREATED BY                                      SIZE
# abc123         1 minute ago     sh                                             5MB
# xyz456         1 hour ago       /bin/sh -c #(nop)  CMD ["nginx","-g","daemon of…   0B
# ... 原始 Nginx 镜像的层 ...

# 提交前手动清理缓存
docker exec myapp sh -c "apt-get clean && rm -rf /var/lib/apt/lists/*"
docker commit myapp myapp:optimized