# 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.