Ansible Production Grade Setup

Production-grade Ansible playbooks and roles for infrastructure automation and configuration management.

Tech Stack¶

List of tools used in the project

Prerequisites¶

Important

This project uses Devbox to provide a consistent development environment.

Install Docker
Docker installation guide
Install Devbox
Devbox installation guide

Clone the repository

git clone https://github.com/sean-njela/ansible-demo.git
cd ansible-demo

Start Devbox shell

devbox shell

First run may take several minutes to install tools, but subsequent runs spin up in seconds.

Quick Start¶

task setup
task status   # check if everything is running
task dev      # start development stack
task info     # to list urls to visit
task cleanup-dev

Documentation¶

For full documentation, setup instructions, and architecture details, visit the docs directory or run locally with:

task docs

Then open: http://127.0.0.1:8030/

Tasks (Automation)¶

Important

This project is designed for a simple, one-command setup. All necessary actions are orchestrated through Taskfile.yml.

The Taskfile.gitflow.yml provides a structured Git workflow using Git Flow. This helps in managing features, releases, and hotfixes in a standardized way. To run these tasks just its the same as running any other task. Using gitflow is optional. If you do not want the gitflow tasks, you can remove the Taskfile.gitflow.yml file and unlink it from the Taskfile.yml file (remove the includes section). If you cannot find the section use CTRL + F to search for Taskfile.gitflow.yml.

To see all tasks:

task --list-all

Contributing¶

Contributions welcome! Open an issue or submit a PR.

License¶

Distributed under the MIT License. See LICENSE for more info.