Skip to content
Interactive Ansible tutorials with dead simple setup via Docker
Branch: master
Clone or download
turkenh Merge pull request #21 from icecream78/text-fix-step-8
FIx result text on step 8 from kitten image to Murrey
Latest commit 07dac2f Jan 28, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
images Update ansible to 2.4 May 25, 2018
tutorials FIx result text from kitten image to Murrey Jan 27, 2019
.gitignore
.travis.yml Update .travis.yml May 25, 2018
LICENSE-tutorials.md
LICENSE.md Add License Sep 23, 2017
README.md
tutorial.sh Update ansible to 2.4 May 25, 2018

README.md

ansible-interactive-tutorial

Build Status

Interactive tutorials for Ansible

Prerequisite

Only prerequisite is docker

Requires docker version 1.9+ and tested with 1.12+

If you don't have docker installed, you can also run on http://play-with-docker.com (just click "+ ADD NEW INSTANCE" button and clone this repo there)

How to Run

./tutorial.sh

demo

Clean up

./tutorial.sh --remove

More Details

Tutorials

Almost all of the tutorials are adapted from the great leucos/ansible-tuto repository:

1. Getting Started
2. Basic inventory
3. First modules and facts
4. Groups and variables
5. Playbooks
6. Playbooks, pushing files on nodes
7. Playbooks and failures
8. Playbook conditionals
9. Git module
10. Extending to several hosts
11. Templates
12. Variables again
13. Migrating to roles!
14. Using roles from Ansible Galaxy - Install a Jenkins server
15. Free play

You can run each lesson individually but it is highly encouraged to follow the order as most of them are built on top of the previous one!

Containers

tutorial.sh starts 4 docker containers behind the scenes. 1 for running the tutorial itself and 3 as ansible nodes which behave exactly same as (virtual or physical) machines throughout the tutorial.

ansible.tutorial is an alpine based tutorial container in which ansible and nutsh (a framework for creating interactive command line tutorials) are available.

host0.example.org, host1.example.org and host2.example.org are the Ubuntu 16.04 based containers that act as ansible nodes. These nodes were already provisioned with the ssh key of ansible.tutorial container. So that you don't have to deal with setting up keys.

Port Mapping

There are some checkpoints in the tutorials where you can check and verify your deployments. For this purpose some ports of the containers are exposed as host ports as follows:

Container Container Port Host Port
host0.example.org 80 $HOSTPORT_BASE  
host1.example.org 80 $HOSTPORT_BASE+1
host2.example.org 80 $HOSTPORT_BASE+2
host0.example.org 8080 $HOSTPORT_BASE+3
host1.example.org 30000 $HOSTPORT_BASE+4
host2.example.org 443 $HOSTPORT_BASE+5

HOSTPORT_BASE is set to 42726 by default and can be changed while starting the tutorial (in case any of the consecutive 6 ports is not available) as follows:

./tutorial.sh --remove # Make sure you shut down the previous ones
HOSTPORT_BASE=<some_other_value> ./tutorial.sh

Workspace Directory

ansible-interactive-tutorial/workspace directory on your local machine is mounted as /root/workspace inside the ansible.tutorial container. So, you can use your favorite editor on your local machine to edit files. Editing files is not necessary to follow the lessons though.

You can’t perform that action at this time.