jdauphant / awesome-ansible

A collaborative curated list of awesome Ansible resources

Awesome Ansible

A collaborative curated list of awesome Ansible resources

Contents

• Books
• Roles
• Playbooks
• Tools
• Resources

---

Books

Books regarding Ansible

• Ansible for DevOps
• Ansible Playbook Essentials
• Ansible - Up and Running
• Learn Ansible
• Learning Ansible 2 - Second Edition
• Mastering Ansible - Second Edition
• OpenStack Administration with Ansible
• Practical Ansible 2

Roles

Roles for Ansible

• Java : Github / Galaxy
• MySQL : Github / Galaxy
• Nginx : Github / Galaxy
• os-hardening : Github / Galaxy
• PostgreSQL : Github / Galaxy
• Redis : Github / Galaxy

Playbooks

Playbooks for Ansible

• Ansible Examples - This tutorial presents ansible step-by-step.
• Ansible Desktop
• Ansible Tutorial
• Ansible Vagrant Examples
• DebOps - Your Debian-based data center in a box. A collection of Ansible playbooks, scalable from one container to an entire data center.
• fgci-ansible - Collection of the Finnish Grid and Cloud Infrastructure Ansible playbooks (CentOS).
• FreeBSD - Playbook example for FreeBSD.
• Hadoop - Ansible playbook that installs a Hadoop cluster, with HBase, Hive, Presto for analytics, and Ganglia, Smokeping, Fluentd, Elasticsearch and Kibana.
• Heartbleed OpenSSL Patch - A simple playbook that update OpenSSL for Debian system.
• Mac Development Ansible Playbook - Playbook to install and configure software on a Mac.
• OpenStack
• Rails
• Sovereign - Your own personal cloud.
• Streisand - Streisand sets up a new server running L2TP/IPsec, OpenConnect, OpenSSH, OpenVPN, Shadowsocks, sslh, Stunnel, a Tor bridge, and WireGuard. It also generates custom instructions for all of these services. At the end of the run you are given an HTML file with instructions that can be shared with friends, family members, and fellow activists.
• T.A.D.S. boilerplate - Provision and deploy a Docker Swarm cluster to development environment and to production. Infrastructure as Code and DevOps best practices.
• VPN Deploy
• Algo VPN - Set up a personal VPN in the cloud

Tools

Ansible related Tools

• Ansible cmdb - Takes the output of Ansible's fact gathering and converts it into a static HTML overview page containing system configuration information.
• Ansible Inventory Grapher - creates a dot file suitable for use by graphviz.
• Ansible Lint - Checks playbooks for practices and behaviour that could potentially be improved.
• Ansible Shell - Interactive shell for Ansible with built-in tab completion for all the modules.
• Ansible Silo - Ansible in a self-contained environment via Docker.
• Ansible Vim - Vim syntax plugin for Ansible 2.0.
• Ansigenome - Ansigenome is a command line tool designed to help you manage your Ansible roles - scan, standarize documentation and meta files, generate dependency graphs.
• ARA: Ansible Run Analysis - Records Ansible Playbook runs seamlessly to make them easier to visualize, understand and troubleshoot. It integrates with Ansible wherever you run it.
• AWX - AWX provides a web-based user interface, REST API, and task engine built on top of Ansible. It is the upstream project for Tower, a commercial derivative of AWX.
• Mitogen for Ansible - Uses the Mitogen library to execute Ansible playbooks in a more efficient way (decreases the execution time).
• Molecule - Testing of Ansible roles.
• OpsTools-ansible - The project opstools-ansible is to use Ansible to configure an environment that provides the support of OpsTools, namely centralized logging and analysis, availability monitoring, and performance monitoring.
• Phansible : Github - Simple generator for Vagrant projects, targeting PHP development environments.
• Semaphore - Open Source Alternative to Ansible Tower.
• TD4A - Template designer for automation - TD4A is a visual design aid for building and testing jinja2 templates. It will combine data in yaml format with a jinja2 template and render the output.

Resources

Useful Ansible resources

• Ansible Galaxy - Hub for finding roles.
• Ansible User Guide, including Best Practices and Conventions, tips, and pitfalls.
• Ansible Quickref - Quick reference to parameters and special variables.
• Ansible vs Chef
• Ansible (Real Life) Good Practices
• Ansible and Ansible Tower: best practices from the field
• Management of FreeBSD jails through Ansible
• Packer Provisioning with Ansible
• Vagrant Provisioning With Ansible

awesome-ansible's Issues

OpenStack - is it intentionally ?

The link to project OpenStack directs to https://github.com/openstack-ansible/openstack-ansible when we can read like on the screenshot below.

Is it intentionally?

Cloud Alchemy

Would you be interested in including our roles into this list? (Cloud Alchemy) provides ansible roles to install monitoring solution based on CNCF projects, currently it installs prometheus and grafana as well as some other things.
Those projects probably could serve as some sort of example since they follow Ansible best practices and have full CI pipelines based on molecule testing framework.
Also there is a repository with demo site which is also provisioned with travis pipeline running every day.

Currently our grafana role is in official docs and we are trying to include prometheus role into another official docs.

I would add PR, but I don't know where to put this 😕.

Add ansible-later

Would you be interested in adding ansible-later to your list? It's a fork of ansible-review (done by me) with some benefits and an alternative ansible best practice checker to ansible-lint.

Regards
Robert

Validate Links

Hello, I wrote a tool that can validate README links. It can be run when someone submits a pull request or pushes a commit to awesome-ansible.

For example, you would see that

https://github.com/al3x/sovereign redirects to
https://github.com/sovereign/sovereign

Which is minor but you would be alerted if a link no longer works.

This tool is currently being used by

• https://github.com/matteocrippa/awesome-swift
• https://github.com/brabadu/awesome-fonts
• and many more

Examples

• https://travis-ci.org/matteocrippa/awesome-swift/builds/96526196 ok ✅
• https://travis-ci.org/matteocrippa/awesome-swift/builds/96722421 link redirected / rename 🔴
• https://travis-ci.org/dkhamsing/open-source-ios-apps/builds/96763135 bad link / project deleted 🔴
• https://travis-ci.org/dkhamsing/open-source-ios-apps/builds/95754715 dupe 🔴

If you are interested, connect this repo to https://travis-ci.org/ and add a .travis.yml file to the project (you can also use Circle CI or other CI services).

See https://github.com/dkhamsing/awesome_bot for options, more information
Feel free to leave a comment 😄

Add Mitogen for Ansible to the list

I read the article Improving the performance of Ansible and I've found interesting (but not used) Mitogen for Ansible.

I think that that project is worth to add to the Awesome Ansible list.

CC: @dw

Ansible Silo - probably is in the wrong section

I'm not 100% sure but IMHO Ansible Sillo should be moved to the Tool section.

@udondan, what do you think?