如何防止Ansible将类JSON格式字符串自动解析为JSON结构

Ansible在处理带Jinja模板的变量值时，会在模板渲染完成后自动做类型推断：如果渲染结果符合合法JSON格式，会自动将其转换为列表/字典等结构化类型。
你配置里前两个标签没有模板变量，YAML解析阶段直接识别为字符串；第三个标签包含{{ host_port }}模板插值，渲染完成后得到的是合法JSON数组，被自动转换为了结构化的数组类型，但Docker API要求所有label值必须是字符串，因此抛出反序列化错误。

不需要使用!unsafe标记（会阻断变量渲染），也不需要提前将标签值存为独立变量，以下两种内联写法都可以满足需求：

方案1：内联构造结构转JSON（推荐，无手动转义成本） #

不用手动写带转义符的JSON字符串，直接在Jinja表达式内构造需要的列表/字典结构，通过to_json过滤器直接输出JSON字符串。由于整个值是Jinja表达式返回的字符串结果，Ansible不会再对其做二次类型转换，模板变量也能正常解析：

- docker_container:
    name: portainer
    # 其余配置省略
    labels:
      com.datadoghq.ad.check_names: '["portainer"]'
      com.datadoghq.ad.init_configs: '[{}]'
      com.datadoghq.ad.instances: '{{ [{"host": "%%host%%", "port": host_port | string}] | to_json }}'

这种写法不需要手动转义双引号，YAML用单引号包裹字符串即可，可读性更高，也不容易因为转义符写错导致配置异常。

方案2：强制字符串类型（适配原有手写转义写法） #

如果要保留原来手写转义JSON的写法，只需要在值末尾拼接空字符串，或通过string过滤器强制指定值为字符串类型，即可阻断Ansible的自动类型推断：

# 写法1：末尾拼接空字符串，写法最简洁
com.datadoghq.ad.instances: >-
  [{"host": "%%host%%", "port": "{{ host_port }}"}]{{ '' }}

# 写法2：通过string过滤器强制转字符串
com.datadoghq.ad.instances: "{{ '[{\"host\": \"%%host%%\", \"port\": \"%s\"}]' | format(host_port) | string }}"

修改配置后执行ansible-playbook -vvv，在调试日志中确认com.datadoghq.ad.instances的值为带双引号包裹的字符串，而非展开的结构化数组，即可正常创建容器。

内容的提问来源于stack exchange，提问作者Mr. Developerdude