Docker自定义镜像创建日期显示异常的原因咨询

问题描述 #

我是Docker新手，创建镜像时遇到一个问题。我的Dockerfile内容如下：

FROM php:5.4-apache
COPY --chown=www-data:www-data src /var/www/html
COPY php/php.ini /usr/local/etc/php
RUN docker-php-ext-install pdo pdo_mysql

构建镜像后执行docker image ls命令，输出如下：

REPOSITORY              TAG       IMAGE ID       CREATED        SIZE
xxxxx/dcalc             latest    ea718faxxxxx   6 years ago    477MB

明明我添加了COPY、RUN等命令，新生成的镜像却显示6年前的创建日期（和基础镜像的时间一致），而且在MacOS的Docker Desktop和Linux（Docker版本20.10.17，构建版本100c701）上都遇到这个问题。

原因解释 #

这是Docker镜像缓存与层复用机制的正常表现：

• Docker镜像是由多个只读层叠加而成的，每一条Dockerfile指令对应一个镜像层。
• 构建时Docker会检查每一层是否已经存在于本地缓存中：如果指令内容（比如COPY的文件哈希、RUN的命令文本）和之前构建过的完全一致，就会直接复用已有的镜像层，包括该层的创建时间。
• 你的基础镜像php:5.4-apache是6年前的，而后续的COPY、RUN指令对应的层如果之前已经构建过（或者内容没有变化），Docker会复用这些层，最终镜像的CREATED日期会显示最上层复用层的创建时间——这里就是基础镜像的时间。

合理性说明 #

这种机制的核心目的是加速构建并节省资源：

• 避免重复执行相同的构建步骤，比如重复安装依赖、复制相同的文件，大幅缩短构建时间。
• 复用已有的镜像层减少磁盘占用，团队多人构建相同镜像时，缓存能让所有人受益。

解决方法 #

如果想要让镜像显示当前创建日期，可以通过以下方式：

• 强制禁用缓存构建：执行构建命令时添加--no-cache参数，强制Docker重新构建所有层：

  docker build --no-cache -t xxxxx/dcalc .
  

• 修改Dockerfile触发层重建：改动任意一条指令的内容，比如给RUN命令加个随时间变化的注释，或者修改COPY的文件内容，让Docker认为该层需要重新构建，后续层的创建时间也会更新：

  RUN docker-php-ext-install pdo pdo_mysql # 手动更新注释触发重建
  

内容的提问来源于stack exchange，提问作者ankGT