目录

📌 前言

第一部分：变量管理

1.1 为什么需要变量？

1.2 变量命名规则（必须记住！）

1.3变量优先级完全图解(最重要!)

1.4 变量定义的四种方式对比

1.5 变量使用的三大陷阱与解决方案

❌ 陷阱1：YAML 解析错误

❌ 陷阱2：字典变量调用错误

❌ 陷阱3：注册变量未正确捕获

1.6 高级变量类型实战

📌 字典变量

📌 列表变量

📌 注册变量（最强大）

---

📌 前言

在 Ansible 自动化运维中，变量、机密和事实 是三大核心支柱。掌握它们的管理方法，能让你的 Playbook 更灵活、更安全、更易维护。本文将系统讲解这三个关键领域的实战应用。

---

第一部分：变量管理

1.1 为什么需要变量？

想象你有 100 台服务器要安装同一个软件包，如果硬编码包名，修改时需要改 100 处代码。而使用变量，只需改一处——这就是变量的核心价值。

变量的三大作用：

• ✅ 存储可复用值，减少重复代码

• ✅ 简化项目维护，降低出错率

• ✅ 动态管理配置（用户、端口、服务等）

1.2 变量命名规则（必须记住！）

# ✅ 正确的变量名
apache_port
db_user_name
app_version_2024

# ❌ 错误的变量名
2_port           # 不能以数字开头
apache-port      # 不能包含特殊符号
apache port      # 不能有空格

核心原则： 字母开头，仅含字母/数字/下划线，禁止空格、特殊符号、数字开头。

1.3变量优先级完全图解(最重要!)

┌─────────────────────────────────────────┐
│  命令行额外变量 (-e/--extra-vars)       │ ⭐ 最高优先级
├─────────────────────────────────────────┤
│  任务变量 (task vars)                   │
├─────────────────────────────────────────┤
│  Play 变量 (vars/vars_files)            │
├─────────────────────────────────────────┤
│  主机事实 (host facts)                  │
├─────────────────────────────────────────┤
│  host_vars 中的主机变量                 │
├─────────────────────────────────────────┤
│  清单中的主机变量                       │
├─────────────────────────────────────────┤
│  group_vars 中的组变量                  │
├─────────────────────────────────────────┤
│  清单中的组变量                         │ ⭐ 最低优先级
└─────────────────────────────────────────┘

实战案例： 为什么命令行变量优先级最高？

# 场景：生产环境需要临时修改配置
# 不用修改 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