# DevOps/Ansible

Ansible is software for automate task, you can automates software provisioning, configuration management, application deployment and general orchestration, ansible design is based on modules, execute ansible-doc -l to view your available modules or check list of official modules in the documentation: https://docs.ansible.com/ansible/latest/modules/modules_by_category.html.

## Installation and Basic Configuration

Install Ansible binaries using yum or apt-get depending on your linux distribution, or pip on MacOS on your computer, not necessary on your managed nodes, then allows server access to your managed clients configuring automatic ssh key authentication.
* macOS: brew install ansible
* Ubuntu (latest version): sudo apt update && sudo apt install software-properties-common && sudo apt-add-repository -y ppa:ansible/ansible && sudo apt update && sudo apt install ansible -y
Following binaries will be installed:

### Commands

* ansible-config view

## Configuration files

There are at least two configuration files in Ansible:
* /etc/ansible/hosts, text configuration file for managed nodes, or inventory in Ansible terminology, in INI or YAML format.
* /etc/ansible/ansible.cfg general configuration file.

## Inventory of managed nodes

https://www.digitalocean.com/community/tutorials/how-to-manage-multistage-environments-with-ansible Inventory is defined in /etc/ansible/hosts file. It allows you to define your managed hosts by hostname or IP address, and group them, such as "my_webservers_group" in our example in INI format.
Groups of groups, hierarchies, is also supported using (:children) keyword: [YOUR_NEW_GROUP_OF_GROUPS:children]
You can also read Ansible best practices
Basic operations with your inventory:
* List managed hosts:
       ansible all --list-hosts
       ansible YOUR_GROUP --list-hosts
       ansible-inventory --graph
       ansible-inventory --list
       To filter just one group of host: ansible-inventory --list | jq '.["YOUR_GROUP_NAME"]'
* List defined groups
       ansible localhost -m debug -a 'var=groups.keys'
       ansible localhost -m debug -a 'var=groups'

## Basic Ansible operations

* Connect to remote host and verify python, it will not do a network ping to remote host, connect to host and test python:
       ansible HOSTNAME -m ping (-m parameter stands for module)
* Execute "uptime" in HOSTNAME:
       ansible HOSTNAME -a "uptime" (-a module arguments, in this case command to execute)
* Connect to HOSTNAME and execute uptime command with raw module, raw module do not need python.
       ansible HOSTNAME -m raw -a uptime
* Execute "echo hello" in all your managed nodes:
       ansible all -a "/bin/echo hello" (-a expect module arguments)
* Connect and display gathered facts, do not setup anything.
       ansible all -m setup
       ansible all -m setup --tree out/
* Execute commands on a machine:
       ansible MACHINE_NAME -m shell -a COMMAND
* List available modules:
       ansible-doc -l
* Execute a user defined task definition or playbook:
       ansible-playbook my_new_created_playbook.yml
* Execute a user defined task definition or playbook with command line variables:
       ansible-playbook my_new_created_playbook.yml -e "YOUR_USERNAME_VAR=YOUR_USERNAME_VALUE"
          -e: --extra-vars as key=value or YAML/JSON

## Ansible Galaxy (Roles)

ansible-galaxy to manage roles
* ansible-galaxy init <ROLE_NAME>
* ansible-galaxy search YOUR_SEARCH
* ansible-galaxy list
* Installing roles:
** ansible-galaxy installoVirt.ovirt-ansible-roles
** ansible-galaxy installPaloAltoNetworks.paloaltonetworks
See also: import_role https://docs.ansible.com/ansible/latest/modules/import_role_module.html#import-role-module

## Features

* Support for saving encrypted information (passwords, API Keys ...) in playbooks using Ansible Vault (ansible-vault) since 2014

## Ansible tunning/configuration

Configuration of ansible is done in /etc/ansible/ansible.cfg, you can tune some configurations. Check official documentation or some example configuration file..

## Ansible privileges

Use become in your playbook and execute with --ask-become-pass parameter.
    Use --ask-pass if you do not have private public key configuration.
vi create_user.yml
./create_user.yml
See also: Create a new user in a group of servers and provided ssh access using its public ssh key

## Activities

Beginner:
* Read how to use Ansible cheatsheet: https://www.digitalocean.com/community/tutorials/how-to-use-ansible-cheat-sheet-guide
* Read Ansible blog: https://www.ansible.com/blog
* Read StackOverflow questions about Ansible: https://stackoverflow.com/questions/tagged/ansible?tab=Votes
* Create your first playbooks:
** Create a new user in a group of servers and provided ssh access using its public ssh key
** Configure user to be able to use sudo with no password
** Add a repository (apt_repository module)
** Use loops in task
Intermediate
* Install and configure sysstat using Ansible
* Modify ssh client Ansible uses to connect: change it from Paramiko to openssh client and modify ControlPersist in ssh_args option. Do it in your ansible.cfg file. (Note than Ansible will use a different ControlPath that your openssh configuration. Default to: ~/.ansible/cp)
* Read about Ansible Roles (similar to modules in puppet and cookbooks in Chef): https://linuxacademy.com/blog/linux-academy/ansible-roles-explained/: ansible-galaxy init <ROLE_NAME>
* Read about Reusable Playbooks: Dynamic vs. Static and Tradeoffs and Pitfalls Between Includes and Imports
Advanced:
* Increase default forks configuration variable (default configuration is 5 forks) in /etc/ansible/ansible.cfg and verify how your execution time increase or decrease. Use:
* Use Ansible ovirt-RHV module (ovirt_vm) to create KVM virtual machines
* Read Release Notes: Ansible changelog and versions: v2.9, v2.8, v2.7.
* Read Ansible Code: git clone https://github.com/ansible/ansible.git