/ansible-playbooks

My Ansible playbooks and roles used to deploy, configure and manage systems.

Primary LanguageJinjaMIT No AttributionMIT-0

Ansible Lint

⚙️ Ansible Playbooks ⚙️

ansible logo

My Ansible playbooks and roles used to deploy, configure and manage systems.

Feel free to use the content of this repository as an inspiration or learning tool for your own ansible deployement.

🏁 Quick Start

  1. Clone this git repository.
git clone https://github.com/UbioZur/ansible-playbooks.git && cd ansible-playbooks
  1. Set your inventories file(s) to manage all of your servers.
  2. Copy and edit your Vault.
cp vaul/sample.yml vault/main.yml
  1. [Optional] Encrypt your vault file.
echo "MY_COMPLICATED_PASSWORD" > vault/.pass
chmod 400 vault/.pass
ansible-vault encrypt --vault-password-file vault/.pass vault/main.yml
  1. Choose a playbook (see Available playbooks section).
  2. Run <playbook_name> with (or without) arguments and extra vars:
cd playbooks
ansible-playbook <playbook_name>.yml [args] [extra vars...]
  1. Enjoy! 😎

📚 Available Playbooks

Those playbooks allow to setup or manage the system in a way I like, allowing automation and easier/faster deployment.

  • 📖 all-gatherfacts to gather facts and packages of all servers and save them in a local .json file.
  • 📖 omv-setup to setup Open Media Vault server with the OMV-Extras packages and bash for the CLI interface.

🧰 Available Roles

In order to reuse some tasks between playbooks, I am using and sharing the roles with this repositories instead of ansible galaxie.

  • 🔧 install-commons to install commons CLI tools I like to have when I use the system with the command line.
  • 🔧 setup-bash to setup bash on a user the way I like it (with aliases, prompt etc...).
  • 🔧 upgrade-packages to upgrade the packages on the system.

🔭 Project Scope

This project is personal and meant for my personal use and learning purposes. Therefore I will not accept contributions outside of the following:

  • Bug fixing If there is a bug due to an update in ansible or the system operating system.
  • Best Practices For learning purposes, I welcome any issues and merge request that will allow me to learn more about best practices with ansible, github, ...
  • Privacy If I have shared/commit some private information that should stay away from the public eyes.
  • Questions As I am sharing it for learning purposes, feel free to open a discussion if you have any question related to the playbook or the roles.

©️ License

MIT No Attribution License.