如何从GitLab向Ansible传递数组或字典类型额外参数

以下是几种实用的解决思路，彻底避开命令行参数解析的坑：

1. 用JSON格式直接传递 #

把列表或字典列表转成JSON字符串，用单引号包裹后传给Ansible，它会自动解析成对应的数据结构，完全不会出现逗号空格或字符串识别错误的问题。

示例GitLab锚点配置： #

.ansible_job_template: &ansible_job_template
  script:
    # 传递普通列表
    - ansible-playbook playbook.yml -e 'domains=["domain1.com", "domain2.com", "domain3.com"]'
    # 传递字典列表
    - ansible-playbook playbook.yml -e 'domains=[{"name":"domain1.com","ssl":true},{"name":"domain2.com","ssl":false}]'

2. 通过Ansible变量文件传递 #

把不同Job的变量写到单独的YAML文件里，GitLab CI中用@filename.yml的方式导入，彻底绕开命令行参数的解析问题，复杂结构维护起来也更方便。

步骤： #

1. 在项目中创建变量文件，比如vars/job1_domains.yml：

domains:
  - domain1.com
  - domain2.com

如果是字典列表：

domains:
  - name: domain1.com
    ssl: true
  - name: domain2.com
    ssl: false

2. 配置GitLab锚点和Job：

.ansible_job_template: &ansible_job_template
  script:
    - ansible-playbook playbook.yml -e @vars/${DOMAIN_VAR_FILE}.yml

job1:
  variables:
    DOMAIN_VAR_FILE: job1_domains
  <<: *ansible_job_template

job2:
  variables:
    DOMAIN_VAR_FILE: job2_domains
  <<: *ansible_job_template

3. 利用GitLab YAML块变量传递 #

用GitLab的YAML块语法（|）定义变量，保留列表的格式和空格，再传递给Ansible，同样能被正确识别为列表结构。

示例： #

.ansible_job_template: &ansible_job_template
  variables:
    DOMAINS_LIST: |
      [
        "domain1.com",
        "domain2.com",
        "domain3.com"
      ]
  script:
    - ansible-playbook playbook.yml -e "domains=${DOMAINS_LIST}"

优先级推荐： #

如果是复杂的字典列表，优先用变量文件，维护成本最低；简单列表可以用JSON格式，配置最简洁。

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