目录

一、Ansible变量概述

二、变量命名规范

三、变量定义位置与优先级

优先级从低到高排列：

优先级原则：

四、在Playbook中使用变量

1. 定义Playbook变量

2. 引用变量

五、主机变量与组变量

1. 在清单文件中定义（传统方式）

2. 使用目录结构定义（推荐方式）

六、实战示例：多环境配置管理

场景描述

七、高级变量技巧

1. 使用字典变量

2. 使用注册变量捕获输出

3. 命令行覆盖变量

八、最佳实践总结

---

一、Ansible变量概述

Ansible变量是自动化配置管理的核心组件，它们用于存储可在整个项目中重复使用的值。通过合理使用变量，我们可以：

• 简化项目创建和维护过程

• 减少人为错误

• 动态管理不同环境的配置值

• 提高Playbook的可重用性和可读性

变量可以存储各种类型的值，如要创建的用户名、需要安装的软件包、要管理的服务状态等。

---

二、变量命名规范

Ansible变量命名有严格的规定：

命名规则：

• 变量名必须以字母开头

• 只能包含字母、数字和下划线（_）

• 区分大小写

示例对比：

无效的变量名称	有效的变量名称	说明
web-server	web_server	不能使用连字符
remote.file	remote_file	不能使用点号
1st_server	server_1	不能以数字开头
server$name	server_name	不能包含特殊字符$
user name	user_name	不能包含空格

---

三、变量定义位置与优先级

Ansible允许在多个位置定义变量，当同名变量在不同位置被定义时，会根据优先级决定最终使用哪个值。

优先级从低到高排列：

1. 清单中定义的组变量 - 最宽泛的范围

2. group_vars目录中的组变量

3. 清单中定义的主机变量

4. host_vars目录中的主机变量

5. 系统自动收集的主机事实（facts）

6. Playbook中play级别的变量（通过vars或vars_files定义）

7. 任务级别的变量 - 更具体的范围

8. 命令行额外变量（使用-e参数）- 最高优先级

优先级原则：

• 范围越窄的变量优先级越高

• 命令行变量具有最高优先级，适合临时覆盖配置

• 建议使用全局唯一的变量名，避免优先级冲突

---

四、在Playbook中使用变量

1. 定义Playbook变量

方式一：在play的vars块中定义

- name: 配置Web服务器
  hosts: webservers
  vars:
    web_package: nginx
    web_port: 8080
    admin_user: alice
  tasks:
    - name: 安装Web服务器软件
      ansible.builtin.dnf:
        name: "{{ web_package }}"
        state: present

方式二：使用外部变量文件

创建web_vars.yml文件：

web_package: nginx
web_port: 8080
admin_user: alice

在Playbook中引用：

- name: 配置Web服务器
  hosts: webservers
  vars_files:
    - web_vars.yml
  tasks:
    - name: 安装软件包
      ansible.builtin.dnf:
        name: "{{ web_package }}"
        state: present

2. 引用变量

使用双大括号{{ }}引用变量：

tasks:
  - name: 创建用户 {{ admin_user }}
    ansible.builtin.user:
      name: "{{ admin_user }}"
      state: present
      
  - name: 配置Web服务端口
    ansible.builtin.lineinfile:
      path: /etc/nginx/nginx.conf
      line: "listen {{ web_port }};"

重要提示：当变量作为YAML值的开头时，必须使用引号包裹，避免YAML解析错误：

# 正确写法
name: "{{ package_name }}"

# 错误写法（可能导致YAML解析错误）
name: {{ package_name }}

---

五、主机变量与组变量

1. 在清单文件中定义（传统方式）

定义主机变量：

[web_servers]
server1.example.com ansible_user=admin ansible_port=2222
server2.example.com ansible_user=ops

定义组变量：

[web_servers]
server1.example.com
server2.example.com

[web_servers:vars]
http_port=80
max_clients=200

定义嵌套组的变量：

[frontend]
server1.example.com
server2.example.com

[backend]
server3.example.com
server4.example.com

[all_servers:children]
frontend
backend

[all_servers:vars]
timezone=Asia/Shanghai

2. 使用目录结构定义（推荐方式）

创建以下目录结构：

project/
├── inventory
├── group_vars/
│   ├── all          # 所有主机通用变量
│   ├── web_servers  # web_servers组变量
│   └── db_servers   # db_servers组变量
├── host_vars/
│   ├── server1.example.com
│   └── server2.example.com
└── playbook.yml

group_vars/all（所有主机通用配置）：

ntp_server: time.example.com
backup_dir: /var/backups

group_vars/web_servers（Web服务器组配置）：

web_package: nginx
web_port: 80

host_vars/server1.example.com（特定主机配置）：

server_role: load_balancer
max_connections: 1000

---

六、实战示例：多环境配置管理

场景描述

管理两个数据中心的服务器，每个数据中心有不同的配置需求。

目录结构：

infrastructure/
├── inventory
├── group_vars/
│   ├── datacenter_east
│   └── datacenter_west
├── host_vars/
│   ├── web01.east.example.com
│   └── web01.west.example.com
└── site.yml

inventory文件：

[datacenter_east]
web01.east.example.com
db01.east.example.com

[datacenter_west]
web01.west.example.com
db01.west.example.com

[all_datacenters:children]
datacenter_east
datacenter_west

group_vars/datacenter_east：

domain: east.example.com
dns_server: 10.0.1.10
package_repository: http://repo.east.example.com

group_vars/datacenter_west：

domain: west.example.com
dns_server: 10.0.2.10
package_repository: http://repo.west.example.com

host_vars/web01.east.example.com：

server_type: frontend
web_package: apache
ssl_enabled: true

---

七、高级变量技巧

1. 使用字典变量

将相关配置组织为字典，提高可读性和可维护性：

# 传统方式（多个独立变量）
user1_name: alice
user1_email: alice@example.com
user1_role: admin

user2_name: bob
user2_email: bob@example.com
user2_role: developer

# 字典方式（更清晰的组织）
users:
  alice:
    full_name: "Alice Smith"
    email: "alice@example.com"
    role: "admin"
    home_dir: "/home/alice"
  
  bob:
    full_name: "Bob Johnson"
    email: "bob@example.com"
    role: "developer"
    home_dir: "/home/bob"

# 访问字典值
tasks:
  - name: 创建用户目录
    ansible.builtin.file:
      path: "{{ users.alice.home_dir }}"
      state: directory
      owner: "alice"
    
  - name: 另一种访问方式（方括号表示法）
    debug:
      msg: "用户邮箱是 {{ users['bob']['email'] }}"

推荐使用方括号表示法，避免与Python内置方法名冲突。

2. 使用注册变量捕获输出

register关键字用于保存任务执行结果，供后续任务使用：

- name: 检查服务状态并基于结果操作
  hosts: all
  tasks:
    - name: 检查Nginx服务状态
      ansible.builtin.systemd:
        name: nginx
        state: started
      register: service_status
    
    - name: 显示服务状态信息
      debug:
        msg: "服务状态: {{ service_status.status }}"
    
    - name: 如果服务启动失败则发送通知
      ansible.builtin.mail:
        subject: "Nginx服务异常"
        body: "服务器 {{ inventory_hostname }} 上的Nginx服务启动失败"
        to: "admin@example.com"
      when: service_status.failed

3. 命令行覆盖变量

临时覆盖变量值，适合测试和调试：

# 覆盖单个变量
ansible-playbook site.yml -e "web_port=8080"

# 覆盖多个变量
ansible-playbook site.yml -e "web_port=8080 package_name=apache"

# 使用JSON格式传递复杂变量
ansible-playbook site.yml -e '{"user_list": ["alice", "bob"], "debug_mode": true}'

# 从文件读取变量
ansible-playbook site.yml -e "@extra_vars.json"

---

八、最佳实践总结

1. 命名规范：遵循命名规则，使用有意义的变量名

2. 作用域控制：将变量定义在合适的作用域级别

3. 目录结构：使用group_vars和host_vars目录管理变量，而非全部写在清单文件中

4. 优先级理解：清楚变量优先级，避免意外覆盖

5. 引用安全：变量作为值开头时务必加引号

6. 字典使用：相关配置使用字典组织，提高可维护性

7. 注册变量：合理使用注册变量捕获和利用任务输出

8. 版本控制：将变量文件纳入版本控制，记录配置变更历史

通过合理使用Ansible变量，我们可以构建出灵活、可维护、可重用的自动化配置管理方案，显著提高运维效率和质量。

---