Ansible docker_image模块镜像引用格式错误问题求助

问题根源 #

你的配置存在三个核心问题：

1. group_vars变量格式错误：image未定义为合法列表，导致变量无法被正确解析
2. Playbook语法缩进错误：docker_image模块的参数未正确缩进，Ansible无法识别正确的任务结构
3. 镜像列表传递方式错误：直接将变量作为嵌套列表传入name参数，生成了无效的镜像引用格式

修正后的配置 #

1. 修正group_vars中的变量格式 #

将image定义为标准YAML列表：

# group_vars对应主机组的配置文件
image:
  - nginx
  - ubuntu

2. 正确的Playbook写法（两种可选方式） #

方式一：使用loop循环拉取多个镜像（推荐，更易维护）

- hosts: all
  tasks:
    - name: 拉取Docker镜像
      docker_image:
        name: "{{ item }}"
        source: pull
        tag: latest  # 可明确指定标签，默认值为latest，可选
      loop: "{{ image }}"

方式二：直接传入列表给name参数

- hosts: all
  tasks:
    - name: 拉取Docker镜像
      docker_image:
        name: "{{ image }}"
        source: pull
        tag: latest

错误解释 #

• 原group_vars中nginx和ubuntu前未加-，导致image被解析为字典而非列表，Ansible无法正确读取镜像名称列表
• 原Playbook中docker_image的参数未缩进，属于语法错误，模块无法正确接收参数
• 错误信息中的['((image))']是变量解析失败后生成的无效镜像引用，触发了Docker的"invalid reference format"错误

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