Taller 1: Ansible - Playbook sencillo

¿Qué vas a aprender en este taller?

Realizar la instalación de ansible.
Conocer los ficheros fundamentales en la configuración de ansible.
Trabajar con la estructura de un playbook.
Trabajar con variables.
Aprender algunos módulos de ansible.
Ejecutar un playbook ansible.

¿Qué tienes que hacer?

Realiza la instalación de ansible. Puedes usar los repositorios oficiales de Debian, o realizar una instalación con pip en un entorno virtual python.
Crea una máquina virtual que vamos a configurar con ansible. Esta máquina debe tener las siguientes características:
- Debe tener creado un usuario sin privilegios con el que podamos acceder a la máquina usando claves ssh.
- Debe tener instalado sudo y el usuario que estamos usando para acceder debe estar configurado para poder usar sudo sin que le pida la contraseña.
Haz un fork del repositorio taller_ansible_vagrant y realiza una clonación en el ordenador donde has instalado ansible. Vamos a trabajar en el directorio Taller1.
El inventario es el fichero donde definimos los equipos que vamos a configurar. En nuestro caso se llama hosts. En el inventario se clasifican los equipos por grupos:
- El grupo all corresponde a todos los equipos definidos.
- En este ejemplo hemos creado un grupo servidores, donde hemos definido nuestra máquina.
- A la máquina la hemos llamado nodo1 (cambia el nombre y pon el de tu máquina), además debes rellenar la siguiente información del nodo:
  - ansible_ssh_host: Dirección IP del equipo que queremos configurar.
  - ansible_ssh_user: Usuario sin privilegios con el que vamos acceder por ssh (lo hemos creado en el equipo en el punto 2).
  - ansible_ssh_private_key_file: Fichero con la clave privada que vamos a usar para el acceso.
El fichero de configuración lo encontramos en el fichero ansible.cfg, donde tienes que poner el nombre del fichero de inventario en el parámetro inventory. El parámetro host_key_checking = False impide que se haga la comprobación del equipo cada vez que se hace la conexión ssh.
Vamos a comprobar si tenemos conectividad con el nodo. Para ello vamos a usar el módulo ping de ansible. Ejecuta alguna de estas instrucciones:
- ansible -m ping all: Comprueba la conectividad con todos los equipos del inventario.
- ansible -m ping servidores: Comprueba la conectividad con los equipos del grupo servidores.
- ansible -m ping nodo1: Comprueba la conectividad con el equipo nodo1 (Cambia el nombre con el que has configurado en el fichero).
Debe salir el mensaje “pong” en verde.
ansible puede trabajar con variables que obtiene de distinta manera:
- A nivel de nodo: definimos variables para cada nodo en el inventario, por ejemplo: ansible_ssh_host, ansible_ssh_user, …
- A nivel de grupo de nodos: Hemos creado un directorio que se tiene que llamar group_vars, dentro de este directorio podemos crear ficheros con las variables que creamos a nivel del grupo. En este ejemplo hemos creado un fichero all, por lo que las variables serán conocidas para todos los nodos. Hemos definido 3 variables para todos los nodos:bd_name, bd_user y bd_pass.
- Gathering Facts: Variables que obtiene ansible de los nodos que está configurando. La primera tarea que ejecuta el play es obtener información del nodo que va a configurar. Toda esa información se puede usar al definir las tareas, por ejemplo: ansible_hostname, ansible_distribution,… Para ver esa información podemos ejecutar:ansible nodo1 -m setup.
Veamos el playbook que se encuentra en el fichero site.yml:
- Primera línea: hosts: all. Significa que las tareas se van a ejecutar en todos los nodos definidos en el inventario. Podríamos haber puesto hosts: servidores o hosts: nodo1.
- become: true: En las tareas que necesiten ejecutarse como administrador se utilizará sudo.
- tasks: Lista de tareas. Todas las tareas tienen un mensaje en el parámetro name y el uso de un módulo.
Veamos las tareas que están definidas:
1. Actualizamos el sistema: Se utiliza el módulo apt para actualizar los paquetes del sistema.
2. Instalar paquetes con apt: Busca en la documentación del módulo apt y termina la segunda tarea para hacer la instalación del paquete git y apache2.
3. Copiar fichero a la máquina remota: El módulo copy nos permite copiar ficheros desde el equipo donde tenemos ansible instalado hasta la máquina que estamos configurando. Los ficheros se suelen guardar en un directorio llamado files. Modifica la tarea para guardar el fichero foo.txt al directorio /etc de la máquina remota.
4. Copiar un template a un fichero de la máquina remota: El módulo template nos permite copiar una plantilla jinja2 (que normalmente tenemos en un directorio llamado template) a la máquina remota después de cambiar las variables por los valores adecuados.
  - Modifica la plantilla index.j2 para indicar los nombres correctos de las variables. Tienes que cambiar las variables modifica_el_nombre por el nombre correcto de las variables.
  - Modifica la tarea para guardar el template en el directorio /var/www/html/index.html de la máquina que estamos configurando.
Ejecuta el playbook:
```
 ansible-playbook site.yaml
```
- Si tienes errores, repasa las modificaciones que has realizado para corregirlos.
- Cuando funcione la ejecución de la receta, cambia el fichero foo.txt y ejecuta de nuevo la receta. ¿Se ejecutan todas las tareas?
- ¿Cómo se llama la propiedad que permite que las tareas que ya se han realizado no se vuelvan a ejecutar?
- Comprobación del funcionamiento: Comprueba que se ha copiado un fichero foo.txt en el servidor, accede desde un navegador al servidor y comprueba que aparece el fichero index.html que hemos creado.

¿Qué tienes que entregar?

Entrega los ficheros: site.yaml, hosts y template/index.j2.
Entrega una captura de pantalla donde se vea que se ha finalizado la ejecución del playbook.
Responde: ¿Cómo se llama la propiedad que permite que las tareas que ya se han realizado no se vuelvan a ejecutar?
Captura de pantalla, donde se vea el fichero foo.txt en el servidor configurado.
Captura de pantalla donde se vea el acceso desde el navegador al servidor web, y se vea el contenido del fichero index.html.
Entrega la URL de tu repositorio con el que estás trabajando.