Concourse构建流水线中Kaniko无法解析Dockerfile路径问题排查

报错信息 #

Error: error resolving dockerfile path: please provide a valid path to a Dockerfile within the build context with --dockerfile

流水线配置 #

resources:
- name: source-code
  type: git
  source:
    uri: gitlab.git
    branch: main
    username: ((gitlab-auth.username))
    password: ((gitlab-auth.password))

- name: kaniko-image
  type: registry-image
  source:
    repository: gcr.io/kaniko-project/executor
    tag: debug

- name: push-image
  type: registry-image
  source:
    repository: quay.io/gitlab
    username: ((quay-gitlab-mr.username))
    password: ((quay-gitlab-mr.password))

jobs:
- name: build-and-push-image
  plan:
  - get: source-code
    trigger: true
  - get: kaniko-image
  - task: build-task-image
    config:
      platform: linux
      image_resource:
        type: registry-image
        source:
          repository: quay.io
          tag: kaniko-v1
      inputs:
      - name: source-code
      params:
        CONTEXT: source-code
        DOCKERFILE: Dockerfile
        IMAGE_NAME: quay.io/gitlab
        TAG: 1.0.5
      run:
        path: /kaniko/executor
        args:
        - --context=${CONTEXT}
        - --destination=${IMAGE_NAME}:${TAG}
        - --dockerfile=${DOCKERFILE}
        - --force
  - put: push-image
    params:
      image: source-code/image.tar

问题背景 #

尝试搭建Concourse流水线，通过Kaniko构建镜像并推送到Quay仓库，持续触发上述Dockerfile路径错误。已知Dockerfile位于源码根目录，Concourse已拉取源码到source-code目录，尝试多种路径配置均无效；使用特权任务常规构建可正常完成，但场景不允许使用特权模式。

问题根源及修复方案 #

1. 任务镜像配置错误 #

任务中指定的image_resource为quay.io/kaniko-v1，这是无效的Kaniko镜像——该镜像不存在或不包含Kaniko执行器环境，导致无法正确解析上下文目录中的Dockerfile。你已经定义了正确的kaniko-image资源（gcr.io/kaniko-project/executor:debug），但任务未使用该资源，反而自行指定了错误镜像。

2. 多余的镜像推送步骤 #

Kaniko通过--destination参数会直接将构建好的镜像推送到目标仓库，无需再通过Concourse的registry-image资源执行put操作，当前配置的push-image步骤完全多余，且指定的source-code/image.tar文件根本不存在（Kaniko不会生成该文件）。

修正后的流水线片段 #

jobs:
- name: build-and-push-image
  plan:
  - get: source-code
    trigger: true
  - get: kaniko-image
  - task: build-task-image
    config:
      platform: linux
      # 使用正确的Kaniko官方debug镜像
      image_resource:
        type: registry-image
        source:
          repository: gcr.io/kaniko-project/executor
          tag: debug
      inputs:
      - name: source-code
      params:
        # 明确指定上下文为任务工作目录下的source-code文件夹
        CONTEXT: ./source-code
        DOCKERFILE: Dockerfile
        IMAGE_NAME: quay.io/gitlab
        TAG: 1.0.5
      run:
        path: /kaniko/executor
        args:
        - --context=${CONTEXT}
        - --destination=${IMAGE_NAME}:${TAG}
        - --dockerfile=${DOCKERFILE}
        - --force
  # 删除多余的put步骤

额外注意事项 #

• 若Quay仓库为私有，需确保Kaniko能获取到Quay的认证信息：可将Quay的用户名密码通过任务参数传入，或在任务中生成/kaniko/.docker/config.json配置文件，让Kaniko能正常访问私有仓库。
• 使用gcr.io/kaniko-project/executor:debug标签镜像，该镜像包含基础调试工具，方便排查路径或权限类问题。

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