Ansible 最佳实践项目教程

Ansible 最佳实践项目教程

ansible-best-practises A project structure that outlines some best practises of how to use ansible 项目地址: https://gitcode.com/gh_mirrors/an/ansible-best-practises

1. 项目的目录结构及介绍

ansible-best-practises/
├── production.ini          # 生产环境配置文件
├── development.ini        # 开发环境配置文件
├── test.ini               # 测试环境配置文件
├── vpass                  # Ansible Vault 密码文件（未提交到仓库）
├── group_vars/
│   ├── all/
│   │   └── apt.yml         # 所有组的 apt 角色变量文件
│   ├── webservers/
│   │   ├── apt.yml         # webservers 组的 apt 角色变量文件
│   │   └── nginx.yml       # webservers 组的 nginx 角色变量文件
│   └── postgresql/
│       ├── postgresql.yml  # postgresql 组的 postgresql 角色变量文件
│       └── postgresql-password.yml  # 加密的 postgresql 密码文件
├── plays/
│   ├── ansible.cfg        # Ansible 配置文件
│   ├── webservers.yml     # webservers 角色的 playbook
│   └── postgresql.yml     # postgresql 角色的 playbook
├── roles/
│   ├── roles_requirements.yml  # 角色依赖文件
│   ├── external/          # 外部角色目录
│   └── internal/          # 内部角色目录
└── extensions/
    └── setup/
        └── role_update.sh  # 更新角色的脚本

目录结构介绍

• production.ini, development.ini, test.ini: 分别对应生产、开发和测试环境的库存文件。
• vpass: Ansible Vault 密码文件，用于加密敏感数据。
• group_vars/: 包含所有组的变量文件，按组和角色分类。
• plays/: 包含 Ansible 配置文件和各个角色的 playbook。
• roles/: 包含角色依赖文件和外部、内部角色目录。
• extensions/setup/: 包含项目设置和依赖更新的脚本。

2. 项目的启动文件介绍

项目的启动文件主要是 plays/ 目录下的 playbook 文件，例如 webservers.yml 和 postgresql.yml。这些文件定义了如何执行 Ansible 任务来配置和管理服务器。

webservers.yml

---
- name: webservers.yml | 所有 webservers 角色
  hosts: webservers
  sudo: True
  roles:
    - { role: common, tags: ["common"] }
    - { role: nginx, tags: ["nginx"] }

postgresql.yml

---
- name: postgresql.yml | 所有 postgresql 角色
  hosts: postgresql
  sudo: True
  roles:
    - { role: common, tags: ["common"] }
    - { role: postgresql, tags: ["postgresql"] }

3. 项目的配置文件介绍

ansible.cfg

plays/ansible.cfg 是 Ansible 的配置文件，包含了所有 Ansible 的配置选项。

[defaults]
inventory = production.ini
roles_path = roles/external:roles/internal

roles_requirements.yml

roles/roles_requirements.yml 定义了项目所需的外部角色及其版本。

---
- src: ANXS.build-essential
  version: "v1.0.1"

python_requirements.txt

extensions/setup/python_requirements.txt 包含了项目所需的 Python 依赖包。

ansible==2.9.10

通过这些配置文件，可以确保项目的依赖和配置一致性，便于项目的管理和维护。

ansible-best-practises A project structure that outlines some best practises of how to use ansible 项目地址: https://gitcode.com/gh_mirrors/an/ansible-best-practises