当前位置：首页 > news >正文

ansible的剧本文件一般放在什么地方?

news 2025/7/1 15:03:29

Ansible 的剧本（Playbook）存放目录需根据实际需求和运行环境灵活选择，以下是推荐的方案及注意事项：

当前工作目录：Ansible 默认优先在执行命令时的当前目录查找 playbook.yml 文件[¹]。例如：
```
cd /my/playbooks/directory
ansible-playbook my-playbook.yml  # 直接执行当前目录下的剧本
```
用户主目录的隐藏目录：若当前目录无剧本，Ansible 会去用户主目录下的 ~/.ansible/playbooks/ 目录查找[¹]。例如：
```
# 将剧本放入 ~/.ansible/playbooks/ 目录
mkdir -p ~/.ansible/playbooks/
cp my-playbook.yml ~/.ansible/playbooks/
```

通过配置文件指定
编辑 ansible.cfg（通常位于 /etc/ansible/ 或用户主目录 ~/.ansible.cfg），添加以下内容：
```
[defaults]
playbook_dir = /etc/ansible/playbooks/  # 自定义剧本目录
```
注意：playbook_dir 仅影响角色（roles）、变量文件等关联路径，不会直接指定剧本文件位置[³][⁵]。因此需结合其他方式使用。
通过命令行参数临时指定
使用 --playbook-path 参数覆盖默认路径：
```
ansible-playbook --playbook-path=/custom/path/ my-playbook.yml
```
通过环境变量设置
在 ~/.bashrc 或 ~/.zshrc 中定义环境变量：
```
export PLAYBOOK_DIR=/path/to/playbooks
```
执行命令时引用该变量：
```
ansible-playbook $PLAYBOOK_DIR/my-playbook.yml
```

集中管理剧本
推荐将剧本统一存放在 /etc/ansible/playbooks/ 或 /opt/ansible/playbooks/ 等全局目录，方便团队协作和自动化工具调用[⁵]。例如：
```
sudo mkdir -p /etc/ansible/playbooks/
sudo cp *.yml /etc/ansible/playbooks/
```

按功能或环境分类子目录
在主目录内按功能划分子目录，如：

/etc/ansible/playbooks/├── production/│   └── deploy.yml├── staging/│   └── test.yml└── common/└── base.yml

配合角色（Roles）使用
将可复用的任务封装为角色（Roles），存放在 /etc/ansible/roles/ 目录，剧本中通过 roles 引用。例如：
```
# 在 /etc/ansible/playbooks/main.yml 中
- hosts: allroles:- webserver- database
```

剧本无法找到
- 检查路径是否正确，避免拼写错误。
- 确保执行命令时的工作目录与剧本路径一致，或使用绝对路径。
- 若使用 ansible.cfg，确认 playbook_dir 未冲突且已重载配置（ansible-config dump --only-changed）。
权限问题
若剧本存放在 /etc/ansible/ 等系统目录，需确保执行用户有读取权限：
```
sudo chmod -R a+rX /etc/ansible/playbooks/
```