使用Ansible拉取Docker镜像列表时出现“invalid reference format”错误

错误原因很明确：community.docker.docker_image模块的name参数只接受单个镜像名称，你直接把列表变量docker-container传进去，模块会把整个列表['mariadb', 'guacamole']当成一个镜像名解析，自然会触发"invalid reference format"错误。

解决方法：用循环遍历列表处理每个镜像 #

修改你的任务，通过loop指令遍历列表中的每个镜像，让模块逐个处理：

- name: Pull docker container
  community.docker.docker_image:
    name: "{{ item }}"
    source: pull
  loop: "{{ docker-container }}"

扩展：整合拉取、打标签、推送至本地仓库的完整流程 #

如果要实现拉取后自动打标签并上传本地仓库，可以直接在同一个任务里完成，无需拆分：

- name: Pull, tag and push images to local registry
  community.docker.docker_image:
    name: "{{ item }}"
    source: pull
    # 替换为你的本地仓库实际地址
    repository: "192.168.2.20:5000/{{ item }}"
    tag: latest
    push: yes
  loop: "{{ docker-container }}"

额外建议 #

变量名尽量使用下划线docker_container代替中划线docker-container，虽然Ansible支持中划线变量，但下划线更符合Ansible的命名规范，能避免一些潜在的语法解析问题。

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