目录
[📌 前言](#📌 前言)
[1.1 为什么需要变量？](#1.1 为什么需要变量？)
[1.2 变量命名规则（必须记住！）](#1.2 变量命名规则（必须记住！）)
[1.4 变量定义的四种方式对比](#1.4 变量定义的四种方式对比)
[1.5 变量使用的三大陷阱与解决方案](#1.5 变量使用的三大陷阱与解决方案)
[❌ 陷阱1：YAML 解析错误](#❌ 陷阱1：YAML 解析错误)
[❌ 陷阱2：字典变量调用错误](#❌ 陷阱2：字典变量调用错误)
[❌ 陷阱3：注册变量未正确捕获](#❌ 陷阱3：注册变量未正确捕获)
[1.6 高级变量类型实战](#1.6 高级变量类型实战)
[📌 字典变量](#📌 字典变量)
[📌 列表变量](#📌 列表变量)
[📌 注册变量（最强大）](#📌 注册变量（最强大）)
📌 前言
在 Ansible 自动化运维中，变量、机密和事实 是三大核心支柱。掌握它们的管理方法，能让你的 Playbook 更灵活、更安全、更易维护。本文将系统讲解这三个关键领域的实战应用。
第一部分：变量管理
1.1 为什么需要变量？
想象你有 100 台服务器要安装同一个软件包，如果硬编码包名，修改时需要改 100 处代码。而使用变量，只需改一处------这就是变量的核心价值。
变量的三大作用：
-
✅ 存储可复用值，减少重复代码
-
✅ 简化项目维护，降低出错率
-
✅ 动态管理配置（用户、端口、服务等）
1.2 变量命名规则（必须记住！）
bash
# ✅ 正确的变量名
apache_port
db_user_name
app_version_2024
# ❌ 错误的变量名
2_port # 不能以数字开头
apache-port # 不能包含特殊符号
apache port # 不能有空格核心原则： 字母开头，仅含字母/数字/下划线，禁止空格、特殊符号、数字开头。
1.3变量优先级完全图解(最重要!)
bash
┌─────────────────────────────────────────┐
│ 命令行额外变量 (-e/--extra-vars) │ ⭐ 最高优先级
├─────────────────────────────────────────┤
│ 任务变量 (task vars) │
├─────────────────────────────────────────┤
│ Play 变量 (vars/vars_files) │
├─────────────────────────────────────────┤
│ 主机事实 (host facts) │
├─────────────────────────────────────────┤
│ host_vars 中的主机变量 │
├─────────────────────────────────────────┤
│ 清单中的主机变量 │
├─────────────────────────────────────────┤
│ group_vars 中的组变量 │
├─────────────────────────────────────────┤
│ 清单中的组变量 │ ⭐ 最低优先级
└─────────────────────────────────────────┘实战案例： 为什么命令行变量优先级最高？
bash
# 场景：生产环境需要临时修改配置
# 不用修改 Playbook，直接用 -e 覆盖
ansible-navigator run deploy.yml -e "env=production db_host=prod.db.com"1.4 变量定义的四种方式对比
| 定义位置 | 优先级 | 推荐场景 | 示例 |
|---|---|---|---|
| 清单文件 | 低 | 小型项目 | [webservers] 下定义 |
| group_vars/ | 中低 | 按组配置 | group_vars/webservers.yml |
| host_vars/ | 中 | 按主机配置 | host_vars/web01.yml |
| Playbook | 中高 | 临时变量 | vars: 块 |
| 命令行 | 最高 | 临时覆盖 | -e "key=value" |
1.5 变量使用的三大陷阱与解决方案
❌ 陷阱1：YAML 解析错误
# 错误示例
- name: 设置端口
debug:
msg: 端口是 {{ apache_port }} # ❌ 错误！没有引号
# 正确示例
- name: 设置端口
debug:
msg: "端口是 {{ apache_port }}" # ✅ 必须加引号❌ 陷阱2：字典变量调用错误
# 定义字典变量
db_config:
host: localhost
port: 5432
user: admin
# 正确的调用方式（两种）
- debug: msg="{{ db_config.host }}" # 点符号
- debug: msg="{{ db_config['port'] }}" # 括号符号❌ 陷阱3：注册变量未正确捕获
# 错误：没有捕获输出
- name: 执行命令
shell: whoami
# 正确：使用 register 捕获
- name: 执行命令
shell: whoami
register: current_user
- name: 显示结果
debug: msg="当前用户是 {{ current_user.stdout }}"1.6 高级变量类型实战
📌 字典变量
# 定义
vars:
users:
alice:
uid: 1001
groups: [admin, wheel]
bob:
uid: 1002
groups: [users]
# 使用
- name: 创建用户
user:
name: alice
uid: "{{ users.alice.uid }}"
groups: "{{ users.alice.groups | join(',') }}"📌 列表变量
# 定义
packages:
- nginx
- mysql-server
- git
# 使用
- name: 安装软件包
package:
name: "{{ item }}"
state: present
loop: "{{ packages }}"📌 注册变量（最强大）
- name: 检查服务状态
systemctl:
name: nginx
state: started
register: nginx_status
- name: 根据结果执行操作
debug:
msg: "服务已启动"
when: nginx_status.changed == false