You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Jeff Geerling 16784065f8 Fixes #397: Add directions to install molecule docker driver. 4 days ago
.github Issue #402: Disable first-ansible-playbook CI test for now. 1 month ago
collection Issue #202: Local collections don't require config to be picked up. 1 year ago
deployments Fixes #259: Update Rails deployment demo Vagrantfile for better WSL compatibility. 11 months ago
deployments-balancer Fixes #239: Rework HAProxy balancer example and make sure apt cache is updated. 11 months ago
deployments-rolling Fixes #298: Change usage of 'src' in requirements.yml files. 11 months ago
docker Issue #310: Fix link to Docker Flask app example. [ci skip] 10 months ago
docker-flask fix link to how-do-i-modify-my-hosts-file 1 month ago
docker-hubot Issue #403: Update Hubot example Node.js version to 14. 1 month ago
drupal fix link to how-do-i-modify-my-hosts-file 1 month ago
dynamic-inventory Fixes #303: Update 'Dynamic inventory with AWS' example to use aws_ec2 plugin. 11 months ago
elk fix link to how-do-i-modify-my-hosts-file 1 month ago
first-ansible-playbook Fix capitalization for chrony 11 months ago
galaxy-role-servers fix link to how-do-i-modify-my-hosts-file 1 month ago
gluster Fixes #298: Change usage of 'src' in requirements.yml files. 11 months ago
https-letsencrypt Fixes #93: Assume Python 3 is available on Ubuntu 20.04. 11 months ago
https-nginx-proxy fix link to how-do-i-modify-my-hosts-file 1 month ago
https-self-signed fix link to how-do-i-modify-my-hosts-file 1 month ago
includes fix link to how-do-i-modify-my-hosts-file 1 month ago
jenkins fix link to how-do-i-modify-my-hosts-file 1 month ago
kubernetes fix link to how-do-i-modify-my-hosts-file 1 month ago
lamp-infrastructure Fixes #303: Update 'Dynamic inventory with AWS' example to use aws_ec2 plugin. 11 months ago
molecule Fixes #397: Add directions to install molecule docker driver. 4 days ago
nodejs fix link to how-do-i-modify-my-hosts-file 1 month ago
nodejs-role fix link to how-do-i-modify-my-hosts-file 1 month ago
orchestration Fixes #221: Final tweaks to orchestration testing. 11 months ago
security Final tweaks to security test configuration. 11 months ago
solr fix link to how-do-i-modify-my-hosts-file 1 month ago
test-plugin Issue #202: More idiomatic Ansible Python style. 1 year ago
tests Fix broken test build due to molecule docker dependency missing. 8 months ago
.gitignore Fixes #249: Update Helm example in chapter 16. 11 months ago
LICENSE Issue #5: Add MIT License. 7 years ago
README.md Fix the grammar 3 months ago

README.md

Ansible for DevOps Examples

CI Molecule CI

This repository contains Ansible examples developed to support different sections of Ansible for DevOps, a book on Ansible by Jeff Geerling.

Most of the examples are full-fledged VM examples, which use Vagrant, VirtualBox, and Ansible to boot and configure VMs on your local workstation. Not all playbooks follow all of Ansible's best practices, as they illustrate particular Ansible features in an instructive manner.

For more interesting examples of what you can do with Ansible, please see the Ansible Vagrant Examples repository, and browse through some of geerlingguy's roles on Ansible Galaxy.

Examples and Chapters in which they're used

Here is an outline of all the examples contained in this repository, by chapter:

Chapter 1

  • N/A

Chapter 2

Chapter 3

  • orchestration: A simple multiple-VM Vagrant configuration and Ansible inventory to allow testing of multi-server orchestration with ansible ad-hoc commands.

Chapter 4

  • drupal: A single-file playbook which configures the LAMP stack on a Linux host and installs Drupal.
  • includes: The same playbook as the drupal example, but using includes to make the playbook more understandable.
  • nodejs: A single-file playbook which configures a Node.js app to run on a Linux host.
  • solr: A single-file playbook which installs Apache Solr on a Linux host.

Chapter 5

  • N/A

Chapter 6

  • nodejs-role: The same playbook as the nodejs example, but using a role to break out the Node.js aspects into a separate nodejs role.
  • galaxy-role-servers: A couple very short playbooks that demonstrate how easy it is to get new servers running leveraging the power of community Ansible Galaxy roles.

Chapter 7

  • test-plugin: A simple test plugin that verifies a given value is representative of the color blue.
  • collection: An example local collection to demonstrate the basic structure of content collections.

Chapter 8

  • dynamic-inventory: Two example dynamic inventory scripts (one in PHP, one in Python) for use with Ansible.

Chapter 9

  • lamp-infrastructure: A multi-server LAMP-based web application infrastructure focused on high-availability and performance for a LAMP-stack app.
  • elk: A two-server example of the Elasticsearch-Logstash-Kibana stack, which uses one server to store and visualize logs centrally, and another server to send logs via Filebeat.
  • gluster: A two-server example of building a fast networked storage setup using Gluster.

Chapter 10

  • deployments: A playbook that deploys a Ruby on Rails application into an environment that runs Passenger and Nginx to handle web requests.
  • deployments-balancer: A playbook that handles zero-downtime deployments to webservers running behind an HAProxy load balancer.
  • deployments-rolling: A playbook that demonstrates rolling deployments to multiple servers for a Node.js app.

Chapter 11

  • security: A playbook containing many security automation tasks to demonstrate how Ansible helps automate security hardening.

Chapter 12

  • jenkins: A playbook that installs and configures Jenkins for CI/CD.

Chapter 13

  • molecule: A Molecule example used for testing and developing an Ansible playbook, or for testing in a Continuous Integration (CI) environment.
  • molecule-ci.yml GitHub Actions workflow: A GitHub Actions workflow which runs the molecule example in a CI environment.

Chapter 14

  • https-self-signed: A playbook that generates self-signed certificates.
  • https-letsencrypt: A playbook that demonstrates automated certificate management with Let's Encrypt and Ansible.
  • https-nginx-proxy: A playbook that demonstrates proxying HTTPS traffic through Nginx to HTTP backends.

Chapter 15

  • docker: Very simple playbook demonstrating Ansible's ability to manage Docker container images.
  • docker-hubot: Slightly more involved example of Ansible's ability to manage and run Docker container images.
  • docker-flask: A sample Flask app built with Ansible playbooks running inside the container.

Chapter 16

  • kubernetes: A playbook that builds a three-node Kubernetes cluster.

License

MIT

Sponsors

  • TinyPilot: An open-source, low-cost KVM over IP for managing your servers.
  • Tugboat: Tugboat is the fastest data-first ephemeral environment CI/CD tool. And here's a tub goat to prove it: 🛁🐐

The above sponsor(s) are supporting Jeff Geerling on GitHub Sponsors. You can sponsor Jeff's work too, to help him continue improving this book and Ansible open source work!

Buy the Book

Ansible for DevOps Cover

Buy Ansible for DevOps for your e-reader or in paperback format.