错误含义解析 #

这个错误的核心逻辑很明确：当你使用docker_image模块且默认state: present时，模块需要明确知道如何获取目标镜像——但当前的参数配置没给足信息，模块没法判断你是要从远程仓库拉取镜像，还是从本地构建镜像，所以抛出了"缺少source"的错误。

具体调试方向 #

• 修正docker_image模块的参数写法
  从你的Playbook和错误输出来看，问题大概率出在构建参数的配置方式上。在较新的Ansible版本中，docker_image模块要求把构建相关的配置（比如目录、标签）放在build字典参数里，而不是直接用顶层的path和tags。正确的写法示例如下：

  - name: build docker image
    docker_image:
      name: bionic
      build:
        path: /path/to/your/dockerfile-folder  # 别用根目录/，换成Dockerfile实际所在的目录
        tag: deb
      force: yes
  

  另外注意：你Playbook里写的是tags: deb，但模块实际识别的是tag（单个标签）或tags（标签列表），且构建场景下标签需要配置在build字典内。

• 调整Dockerfile的路径配置
  你当前指定的path: /（根目录）非常不合理：一来Docker构建时会加载整个根目录的内容，效率极低还可能触发权限问题；二来模块可能无法正确定位到Dockerfile。请把path改成你的Dockerfile实际所在的目录，比如如果Dockerfile在执行Playbook的当前目录，就写./或者对应的绝对路径。

• 核对Ansible版本与模块文档
  不同版本的docker_image模块参数差异不小，建议执行ansible-doc docker_image命令查看当前Ansible版本对应的模块文档，确认构建镜像时的正确参数格式。比如旧版本可能支持直接用顶层path，但新版本已经废弃该写法，必须用build.path。

• 检查参数拼写与配置一致性
  从错误输出的module_args能看到，模块实际接收到的name是xroad-deb-bionic（而非你Playbook里的bionic），tag是latest（而非你写的deb），这说明你的Playbook可能存在参数拼写错误，或者实际执行的Playbook和你粘贴的版本不一致。请仔细核对Playbook中的参数名称，比如tags是否应该写成tag，或者是否有其他配置覆盖了这些参数。

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