67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
# Ansible Playbook Repository
|
|
|
|
This repository contains Ansible playbooks for automating the configuration and deployment of infrastructure.
|
|
|
|
## Table of Contents
|
|
|
|
- [Prerequisites](#prerequisites)
|
|
- [Getting Started](#getting-started)
|
|
- [Playbook Structure](#playbook-structure)
|
|
- [Running the Playbook](#running-the-playbook)
|
|
- [Contributing](#contributing)
|
|
- [License](#license)
|
|
|
|
## Prerequisites
|
|
|
|
Before you begin, ensure you have the following installed:
|
|
|
|
- [Ansible](https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html)
|
|
- [Python](https://www.python.org/downloads/)
|
|
- [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
|
|
|
|
## Getting Started
|
|
|
|
1. Clone the repository:
|
|
```sh
|
|
git clone ssh://gitea@git.arnaudne.fr:2221/arnaudne/ansible.git
|
|
cd Ansible
|
|
```
|
|
|
|
2. Install the required Ansible roles and collections:
|
|
```sh
|
|
ansible-galaxy install -r requirements.yml
|
|
```
|
|
|
|
## Playbook Structure
|
|
|
|
The playbook is organized as follows:
|
|
|
|
- `playbooks/`: Contains the main playbook files.
|
|
- `roles/`: Contains reusable roles used by the playbooks.
|
|
- `inventory/`: Contains inventory files for different environments.
|
|
- `requirements.yml`: Lists the required Ansible roles and collections.
|
|
|
|
## Running the Playbook
|
|
|
|
To run the playbook, use the following command:
|
|
|
|
```sh
|
|
ansible-playbook -i inventory/production playbooks/main.yml
|
|
```
|
|
|
|
Replace `inventory/production` with the appropriate inventory file for your environment.
|
|
|
|
## Contributing
|
|
|
|
Contributions are welcome! Please follow these steps:
|
|
|
|
1. Fork the repository.
|
|
2. Create a new branch (`git checkout -b feature-branch`).
|
|
3. Make your changes.
|
|
4. Commit your changes (`git commit -m 'Add new feature'`).
|
|
5. Push to the branch (`git push origin feature-branch`).
|
|
6. Open a pull request.
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. |