启用BuildKit后仍无法用Ansible构建Collabora Docker镜像

AI 小北

2026-8-8

解决Ansible构建Collabora Docker镜像时BuildKit未启用的问题

问题分析

你已经通过daemon.json全局启用BuildKit，且手动执行docker build命令能成功构建，但Ansible的docker_image模块仍提示BuildKit未启用，原因可能是：

docker_image模块未正确感知全局BuildKit配置
模块环境变量传递存在优先级问题
原任务中密钥传递方式与手动命令不一致（手动用--secret，但任务用build args）

解决方案

方案1：显式启用`docker_image`模块的BuildKit支持（Ansible 2.10+）

在build参数块中添加buildkit_enabled: yes，同时修正密钥传递方式（用secrets参数替代build args）：

- name: Build collabora Docker image
  docker_image:
    source: build
    name: '{{ collabora_docker.image_name }}'
    tag: '{{ collabora_docker.version }}'
    build:
      path: '/tmp/collabora.git/docker/from-packages'
      nocache: yes
      dockerfile: Ubuntu
      args:
        type: cool
      buildkit_enabled: yes  # 显式启用BuildKit
      secrets:
        - id: secret_key
          src: /path/to/your/secret_key/file  # 替换为实际密钥文件路径
  environment: 
    DOCKER_BUILDKIT: 1

方案2：直接调用`docker build`命令（最可靠，适配所有场景）

既然手动执行命令能成功，用command模块模拟手动操作，绕过docker_image模块的潜在问题：

- name: Build collabora Docker image via docker command
  command: >
    docker build --no-cache --secret id=secret_key,src=/path/to/secret_key
    --build-arg type=cool
    -t {{ collabora_docker.image_name }}:{{ collabora_docker.version }}
    -f Ubuntu .
  args:
    chdir: '/tmp/collabora.git/docker/from-packages'
  environment:
    DOCKER_BUILDKIT: 1