dctrud/docker-aufs-sanity

docker-aufs-sanity

本仓库包含一个Dockerfile，定义了Docker Hub上的容器dctrud/docker-aufs-sanity。

这是一个小型Docker容器，可用于测试提取Docker多层镜像的软件（如Singularity），确保它们正确处理aufs whiteout标记。

使用示例

如果你的Docker层提取工具正确处理whiteout标记，运行容器时应看到以下输出：

bash
$ docker run dctrud/docker-aufs-sanity
/test
/test/normal-dir
/test/normal-dir/file1
/test/normal-dir/file2
/test/whiteout-dir
/test/whiteout-dir/file2
/test/whiteout-file
/test/whiteout-file/file2

若aufs提取不正确，你可能会在whiteout-dir/或whiteout-file/目录中看到额外的file1，以及以.wh.开头的whiteout标记文件。例如Singularity v2.4的输出：

bash
$ singularity run docker://dctrud/docker-aufs-sanity
/test
/test/normal-dir
/test/normal-dir/file1
/test/normal-dir/file2
/test/whiteout-dir
/test/whiteout-dir/file1
/test/whiteout-dir/.wh.file1
/test/whiteout-dir/file2
/test/whiteout-file
/test/whiteout-file/file1
/test/whiteout-file/file2
/test/whiteout-file/.wh.file1
/test/.wh.whiteout-dir

原理说明

Dockerfile中的每个RUN步骤都会创建独立的容器文件系统层，基于之前的层构建内容。当在RUN步骤中删除文件时，无法修改之前的不可变层，Docker使用aufs whiteout标准记录删除操作：若在第1层创建file1并在第2层删除它，第2层的tar包会包含隐藏标记文件.wh.file1，指示提取工具在提取第2层时移除file1。

测试场景

镜像创建3个目录，分别测试不同场景：

目录Whiteout
创建/test/whiteout-dir/并添加file1，随后删除file1和目录本身。Docker会在层tar中创建/test/.wh.whiteout-dir标记文件。最后重新创建目录并添加file2。正确提取时，该目录仅含file2。

文件Whiteout
创建/test/whiteout-file/并添加file1，后续添加file2后删除file1。Docker会在层tar中创建/test/whiteout-file/.wh.file1标记文件。正确提取时，该目录仅含file2。

无Whiteout
/test/normal-dir/添加file1和file2，后续未删除任何文件。正确提取时，该目录包含两个文件。