Ansible调用Docker动态库存脚本时JSON解析错误问题咨询

我之前也碰到过一模一样的情况——脚本输出的JSON存成文件能用，但直接给Ansible调用就报解析错，核心原因几乎都是脚本输出了非JSON的额外内容，或者执行时产生的错误信息混进了标准输出里。下面给你一步步排查和解决的方法：

• 确认脚本输出的纯净度
  直接在命令行运行你的脚本，看看输出是不是只有纯JSON：

  ./your-docker-inventory-script.py
  

  如果看到除了JSON之外的内容（比如调试打印的日志、Docker命令的警告、脚本的报错信息），那就是问题所在——Ansible只会读取脚本stdout的内容，任何额外字符都会导致JSON解析失败。

  你可以用jq工具快速验证输出是否合法：

  ./your-docker-inventory-script.py | jq .
  

  如果jq报错，说明输出的JSON格式有问题，或者混进了其他无关内容。

• 清理脚本的额外输出

  • 把脚本里所有调试用的print语句删掉，或者把它们重定向到stderr（这样不会干扰stdout的JSON输出）：

    import sys
    # 调试信息输出到stderr，不会被Ansible读取
    print("Fetching Docker containers...", file=sys.stderr)
    

  • 确保脚本里调用Docker命令时，把stderr重定向掉，比如用subprocess模块时指定stderr=subprocess.DEVNULL，避免Docker的警告/错误信息跑到stdout里。

• 检查脚本的执行权限和shebang

  • 确保脚本有可执行权限：

    chmod +x your-docker-inventory-script.py
    

  • 脚本开头的shebang要正确匹配你的Python环境，比如：

    #!/usr/bin/env python3
    

    不然Ansible调用脚本时可能找不到正确的解释器，执行失败输出的错误信息会直接打乱JSON结构。

• 对照Ansible动态库存的JSON结构要求
  根据Ansible官方文档，动态库存的JSON需要符合特定结构：

  • 至少包含一个组（比如docker_containers），组里的hosts是主机列表
  • 可选但推荐包含_meta字段，里面的hostvars是主机变量的字典（空字典也可以，不要用null）

  举个符合要求的示例结构：

  {
    "docker_containers": {
      "hosts": ["container-web-1", "container-db-1"]
    },
    "_meta": {
      "hostvars": {
        "container-web-1": {
          "ansible_connection": "docker"
        },
        "container-db-1": {
          "ansible_connection": "docker"
        }
      }
    }
  }
  

  如果你的脚本输出的JSON结构不符合这个要求，也可能导致解析错误——虽然存文件后手动测试可能没问题，但Ansible的解析器对结构有严格要求。

• 最后验证
  修改完之后，再用Ansible的inventory模块测试：

  ansible-inventory -i ./your-docker-inventory-script.py --list
  

  如果能正常输出整理后的库存信息，说明解析成功了，接下来就算ping模块失败也没关系，正如你说的，走到这一步就说明库存配置有效了。

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