GitLab流水线中使用Kaniko构建多镜像的上下文重置问题

问题根源 #

你遇到的报错是因为Kaniko默认会复用构建过程中生成的缓存层，当在同一个流水线任务中多次运行Kaniko构建时，第二次构建会直接复用第一次构建产生的包含test目录的镜像层，导致RUN mkdir test执行时因目录已存在而报错。

解决方案 #

1. 修改Dockerfile让命令具备幂等性

最简单的方法是调整mkdir命令，添加-p参数，确保目录存在时不会报错：

FROM nginx:latest
RUN mkdir -p test

这个方案无需修改CI配置，让Dockerfile本身兼容重复执行的场景。

2. 构建时禁用Kaniko缓存

在Kaniko命令中添加--no-cache参数，强制每次构建都从头开始执行所有步骤，不复用之前的缓存层：

build-multiple-images:
  stage: build
  image: gcr.io/kaniko-project/executor:debug
  script:
    # 构建第一个镜像
    - /kaniko/executor --context $CI_PROJECT_DIR --dockerfile $CI_PROJECT_DIR/Dockerfile --destination your-registry/image1:latest --no-cache
    # 构建第二个镜像
    - /kaniko/executor --context $CI_PROJECT_DIR --dockerfile $CI_PROJECT_DIR/Dockerfile --destination your-registry/image2:latest --no-cache

3. 为每个构建指定独立的缓存目录

如果想保留缓存功能但避免跨构建复用，可以为每个构建任务指定不同的缓存目录：

build-multiple-images:
  stage: build
  image: gcr.io/kaniko-project/executor:debug
  script:
    # 创建第一个缓存目录并构建镜像
    - mkdir -p /cache/image1
    - /kaniko/executor --context $CI_PROJECT_DIR --dockerfile $CI_PROJECT_DIR/Dockerfile --destination your-registry/image1:latest --cache-dir /cache/image1
    # 创建第二个缓存目录并构建镜像
    - mkdir -p /cache/image2
    - /kaniko/executor --context $CI_PROJECT_DIR --dockerfile $CI_PROJECT_DIR/Dockerfile --destination your-registry/image2:latest --cache-dir /cache/image2

4. 两次构建之间清理缓存目录

在两次Kaniko执行之间清理默认的缓存目录/cache，让第二次构建从头开始：

build-multiple-images:
  stage: build
  image: gcr.io/kaniko-project/executor:debug
  script:
    # 构建第一个镜像
    - /kaniko/executor --context $CI_PROJECT_DIR --dockerfile $CI_PROJECT_DIR/Dockerfile --destination your-registry/image1:latest
    # 清理缓存目录
    - rm -rf /cache/*
    # 构建第二个镜像
    - /kaniko/executor --context $CI_PROJECT_DIR --dockerfile $CI_PROJECT_DIR/Dockerfile --destination your-registry/image2:latest

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