For Ansible, it is necessary to install Ansible on the host machine. This repo uses a Vagrant box based on Ubuntu and we will use APT to install ansible.

Example code

Clone this repository with:

git clone https://bitbucket.org/agile611/startusingansible.git

Initial configuration

Start environment, we are going to need 4 ubuntu boxes (Ansible, Alfa, Bravo, Charlie)

vagrant up 
vagrant ssh ansible

Starting workspace on ansible box

vagrant@ansible$ sudo apt-get update
vagrant@ansible$ sudo apt-get install ansible -y

Check your ansible installation checking the response from this command:

vagrant@ansible$ ansible localhost -m setup

Create a ssh key to connect to the webserver box just pressing enter to the requested questions:

vagrant@ansible$ ssh-keygen
vagrant@ansible$ cat /home/vagrant/.ssh/id_rsa.pub

Copy /home/vagrant/.ssh/id_rsa.pub into the clipboard on webserver box and execute:

vagrant@alfa$ sudo -s
root@alfa# mkdir /root/.ssh
root@alfa# echo 'full contents of id_rsa.pub from ansible node' > /root/.ssh/authorized_keys
root@alfa# chmod 700 /root/.ssh
root@alfa# chmod 640 /root/.ssh/authorized_keys

Check if you can connect to the webserver using the ssh key (not prompting a password).

vagrant@ansible$ ssh root@192.168.0.2

If you can connect, the initial config is done. Repeat this for Bravo and Charlie Vms.

IMPORTANT NOTE

Priority order from the config files:

ANSIBLE_CONFIG (environment variable POSIX)
ansible.cfg (current folder)
~/.ansible.cfg (user home from the executor)
/etc/ansible/ansible.cfg (general file)

Test the environment

Setup Ansible Inventory on the ansible box, create the following folders:

vagrant@ansible$ mkdir example_ansible
vagrant@ansible$ mkdir example_ansible/hosts
vagrant@ansible$ nano example_ansible/hosts/all

And on the file hosts/all and the following lines:

[alfa]
192.168.0.2    

[bravo]
192.168.0.3

Check if everything works executing the following command:

vagrant@ansible$ cd example_ansible
vagrant@ansible$ ansible -i hosts -u root -m ping all

What happen?

The expected response is as follows:

192.168.0.2 | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}

Initial configuration and first yaml file

Create the file request.yml

---
- hosts: webserver

  tasks:
    - name: What system are you?
      command: uname -a
      register: info

    - name: print var
      debug: var=info

    - name: print field
      debug: var=info.stdout

    - name: What your name?
      command: hostname
      register: info

    - name: Give me your name
      debug: var=info.stdout

Execute the following command to show what tasks are we going to execute:


vagrant@ansible$ ansible-playbook -i hosts/all -u root request.yml --list-hosts --list-tasks

Execute the following command to perform the tasks described before:

vagrant@ansible$ ansible-playbook -i hosts/all -u root request.yml

IMPORTANT NOTE

The user root is used here for testing purposes and to make the environment easier to implement. Note that it is also the user which has the ssh key installed. You can add the ssh key to the user you in order to execute Ansible commands.

More examples (on examples folder)

000_initial_examples
001_apt
002_become
003_with_items
004_services
005_stack_restart
006_notify_handlers
007_files_copy
008_pip
009_files
010_templates
011_lineinfile
012_mysql_management
013_wait_for
014_stack_status
015_roles
016_tasks_handlers
017_files_templates
018_site_yml
019_facts
020_defaults
021_vars
022_with_dict
023_selective_removal
024_continued
025_vars_files_group_vars
026_vault

Problems provisioning the box

If you have problems provisioning the box, you can download it directly from here

After that you need to know the path of the box and execute the following command:

    vagrant box add /The/Path/From/Your/Downloaded/box/bento-ubuntu-20-04.box --name bento/ubuntu-20.04
    vagrant init bento/ubuntu-20.04

The init command creates a VagrantFile with your initial configuration. On the same folder where this Vagrantfile is, please execute to following command:

    vagrant up

After that, please connect to the box using the following command:

    vagrant ssh

If you get a terminal from the box, your environment is ready.

Common networking problems

If you have proxies or VPNs running on your machine, it is possible that Vagrant is not able to provision your environment.

Please check your connectivity before.

Support

This tutorial is released into the public domain by Agile611 under Creative Commons Attribution-NonCommercial 4.0 International.

This README file was originally written by Guillem Hernández Sola and is likewise released into the public domain.

Please contact Agile611 for further details.

Agile611
Laureà Miró 309
08950 Esplugues de Llobregat (Barcelona)