Ansible使用Map类型变量配置环境变量时出现映射值不允许错误

错误原因 #

你遇到的mapping values are not allowed in this context是YAML语法解析错误，结合场景核心问题有两个：

1. 多行字符串定义不规范：用单引号包裹VAR23的多行YAML片段内容时，YAML解析器会尝试解析内部的global:、version:等结构，误将其识别为映射（map）而非纯字符串，触发语法错误。
2. 对Ansible environment参数的误解：environment要求接收键值对形式的字典，每个键是环境变量名，值必须是可直接作为环境变量的字符串值，你的写法导致解析器无法正确识别变量结构。

解决方案 #

方案1：将YAML片段作为环境变量值传递 #

如果需求是把那段YAML结构作为VAR23的环境变量值，用YAML的**块字面量标量（|）**正确定义多行字符串，避免解析歧义：

修改变量定义：

Variable_123: 
  VAR23: |
    global:
      string: abcd
    environment:
      local:
        version: 2.32

任务执行代码（注意添加引号符合YAML规范）：

- name: Run tests
  environment: "{{ Variable_123 }}"
  command: echo "$VAR23"

• |会保留字符串的换行和缩进，完全还原需要的YAML格式；如果不需要换行，可改用>折叠换行。

方案2：提取内部配置作为独立环境变量 #

如果真实需求是把global.string、environment.local.version等配置项作为单独的环境变量传递，调整变量结构和任务写法：

首先定义原始配置变量：

app_config:
  global:
    string: abcd
  environment:
    local:
      version: 2.32

然后在任务中提取对应值作为环境变量：

- name: Run tests
  environment:
    STRING: "{{ app_config.global.string }}"
    VERSION: "{{ app_config.environment.local.version }}"
  command: echo "$STRING $VERSION"

关键注意事项 #

• Ansible的environment参数仅接受键值对字典，值必须是字符串、数字或可转换为字符串的类型，不能直接传递嵌套的映射结构。
• YAML中定义多行字符串时，优先使用|或>而非单/双引号，避免解析器误判内部结构。

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