Ansible变量优先级：‘role params’与‘include params’解析求助

一、第20项：role(及include_role) params 用法说明 #

• 位置：在Playbook调用角色时直接传递，支持两种调用方式：
  1. roles: 块调用时，直接跟在角色名称下方
  2. include_role 模块调用时，通过vars子块传递
• 语法示例：

  # 方式1：roles块传参
  roles:
    - name: web_server
      listen_port: 8080
      doc_root: /var/www/custom
  
  # 方式2：include_role模块传参
  tasks:
    - name: 加载数据库角色并配置参数
      include_role:
        name: db_server
      vars:
        db_port: 3306
        db_name: app_db
  

• 核心特点：参数仅对当前调用的角色实例生效，优先级高于角色内部定义的默认变量，适合针对特定角色实例做个性化配置。

二、第21项：include params 用法说明 #

• 位置：使用include_tasks（旧版include已废弃）导入独立任务文件时传递
• 语法示例：

  tasks:
    - name: 导入通用备份任务并指定路径
      include_tasks: backup_tasks.yml
      vars:
        backup_dir: /backup/app
        retention_days: 7
  

• 核心特点：参数仅作用于被导入的任务文件内的所有任务，属于任务片段级别的传参，和角色无直接关联，优先级低于role params。

三、多角色统一变量的实现方案 #

针对你需要将两个角色任务中的部分值统一声明在单一位置的需求，推荐以下几种实用方式：

1. 全局共享变量文件 #

在Playbook根目录创建group_vars/all.yml（或vars/shared_vars.yml），定义所有角色共享的变量：

# group_vars/all.yml
common_listen_port: 80
common_log_path: /var/log/app

两个角色的任务文件可直接通过{{ common_listen_port }}引用，无需额外传参，变量会自动作用于所有Play和角色。

2. 基础角色依赖+默认变量 #

创建一个基础角色，在其defaults/main.yml中定义共享变量，然后让业务角色依赖该基础角色：

# roles/base/defaults/main.yml
shared_timeout: 300
shared_max_conn: 1000

# roles/web/meta/main.yml
dependencies:
  - name: base

# roles/api/meta/main.yml
dependencies:
  - name: base

业务角色会自动继承基础角色的默认变量，若需覆盖，可在Playbook或Inventory中定义同名变量即可。

3. Play级统一变量 #

在Play的vars块中定义共享变量，作用于整个Play内的所有角色：

- name: 部署应用集群
  hosts: app_servers
  vars:
    app_version: v2.3.0
    app_env: production
  roles:
    - web
    - api

这种方式的变量优先级高于角色默认变量，适合在单个Play范围内统一管理配置。

4. 引用外部变量文件的role params传参 #

如果必须通过role params传参（比如仅针对特定角色实例生效），可将共享变量单独存放在文件中，调用角色时引用：

# vars/role_shared.yml
shared_db_user: app_user

# playbook.yml
- name: 部署服务
  hosts: all
  vars_files:
    - vars/role_shared.yml
  roles:
    - name: web
      db_user: "{{ shared_db_user }}"
    - name: api
      db_user: "{{ shared_db_user }}"

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