### Ansible 剧本中 YAML 文件键值对的键来源分析 Ansible 使用基于 YAML 的剧本文件（Playbook），其中定义的任务、变量和其他配置都以键值对的形式存在。这些键的具体来源可以从以下几个方面进行解释： #### 1. **内置关键字** Ansible 定义了一系列固定的关键词，用于描述 Playbook 的结构和功能。这些关键词是由 Ansible 自身框架规定的，用户必须遵循其语法规则才能正确编写剧本[^1]。常见的内置关键字包括但不限于 `name`, `hosts`, `tasks`, `become`, `vars`, 和 `handlers` 等。例如，在以下示例中，`name`, `hosts`, 和 `tasks` 是 Ansible 内置的关键字。 ```yaml --- - name: Example playbook to demonstrate keys hosts: all become: yes tasks: - name: Print message debug: msg: "This is an example" ``` 以上代码片段中的 `name`, `hosts`, `tasks`, 和 `debug` 都是 Ansible 内部预定义并强制使用的键[^1]。 #### 2. **Facts 变量** 当运行 Ansible 时，它会自动收集目标主机的相关信息，并将其存储为 Facts 变量。这些变量通常作为键值对存在于特定的事实命名空间下，可以直接在剧本中调用。例如，`ansible_ssh_host`, `ansible_ssh_port`, 和 `ansible_ssh_user` 就是一些典型的事实变量名称[^4]。它们来源于远程主机的操作系统环境及其配置状态，无需手动声明即可直接使用。 #### 3. **自定义变量** 除了内置关键字外，还可以通过多种方式引入自定义变量到剧本当中。一种常见的方式是在单独的 `.yaml` 或 `.yml` 文件里设置变量集合，然后借助 `include_vars` 模块加载；另一种则是利用 roles 功能集中管理共享资源的同时也支持局部覆盖某些属性值[^3]。比如下面的例子展示了如何在一个独立文件 (`vars.yaml`) 中定义两个简单字符串类型的变量 `my_var_one` 和 `my_var_two` 并应用到后续操作之中: ```yaml # vars.yaml content my_var_one: value_for_my_first_variable my_var_two: another_value_here ``` 接着可以在主剧本引用该外部数据源如下所示： ```yaml - name: Include variables from external file and use them within the play. include_vars: vars.yaml - name: Display custom variable contents using included data source. debug: var: my_var_one ``` 这里提到的 `my_var_one` 和 `my_var_two` 即属于开发者自行指定而非平台自带的一部分[^3]. #### 4. **Roles 结构下的默认路径查找机制** 如果采用 Roles 组织项目，则 Ansible 还会在几个特殊位置寻找额外可能存在的变量定义文档，默认顺序依次为 role-level directories like `defaults/main.yml`, followed by `vars/main.yml`. 此类设定允许更加灵活地构建大型解决方案而不会让单个脚本变得臃肿难懂[^3]. 综上所述，Ansible 剧本中的键既可以来自于核心引擎预先规定好的标准选项集，也可能来自动态探测所得出的目标机器特性报告即所谓的 “facts”，甚至还能由使用者自由创造满足个性化需求的新标签体系加以扩充完善整个自动化流程的设计思路. ---