容器与云原生 / 系统课时

构建标记并验证镜像

构建标记并验证镜像

本节学习如何从 Dockerfile 构建镜像,并通过标签管理版本,再使用运行、检查和历史查看确认镜像是否满足运行要求。

学习目标

  • 掌握 docker build 和 docker tag 的基本使用流程。
  • 学会通过容器启动、配置检查和层信息验证镜像质量。
  • 理解镜像标签、元数据和构建历史之间的关系。

构建镜像并设置版本标记

镜像构建完成后,通常不会直接使用默认名称,而是添加明确的仓库名、应用名和版本标签。标签能够帮助区分不同发布版本,也方便后续部署和回滚。

下面以当前目录存在 Dockerfile 的项目为例完成一次构建:

bash
docker build -t demo-api:1.0 .
docker tag demo-api:1.0 demo-api:stable

预期输出

text
Successfully built <IMAGE_ID>
Successfully tagged demo-api:1.0
demo-api:stable

其中 <IMAGE_ID> 会由实际 Docker 环境生成,不同机器上的值可能不同。

验证镜像运行状态

镜像验证不能只看构建是否成功,还需要确认容器能否启动、端口是否映射正确以及应用配置是否生效。

bash
docker run -d --name demo-container -p <PORT>:8080 demo-api:stable
docker ps
docker inspect demo-container

预期结果

text
CONTAINER ID   IMAGE              PORTS
<ID>           demo-api:stable    0.0.0.0:<PORT>->8080/tcp

Inspect 输出包含容器名称、端口映射和运行配置。

实际端口和容器 ID 会根据运行环境变化。

查看镜像层与构建历史

Docker 镜像由多个只读层组成。查看历史可以帮助定位镜像体积增长、重复安装依赖或缓存失效等问题。

bash
docker image inspect demo-api:stable
docker history demo-api:stable

预期结果

text
镜像信息包含 RepoTags、Config、Architecture 等字段。
history 输出展示各层创建命令和对应大小。

常见验证问题

如果容器启动后立即退出,应优先查看日志和启动命令;如果端口无法访问,需要检查应用监听地址是否正确,而不是只检查 Docker 端口映射。常见检查顺序如下:

  • 使用 docker ps -a 查看容器最终状态。
  • 使用 docker logs <ID> 查看应用启动错误。
  • 使用 docker inspect 核对环境变量、端口和挂载配置。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

构建标记并验证镜像

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通