Initial Commit
This commit is contained in:
67
README.md
Normal file
67
README.md
Normal file
@@ -0,0 +1,67 @@
|
||||
# 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.
|
||||
Reference in New Issue
Block a user