Diferencias

Muestra las diferencias entre dos versiones de la página.

--- informatica:ciberseguridad:cursos:curso_ansible_automatizacion_it:conceptos_fundamentales [2023/05/04 20:23] – [Introducción a los módulos en Ansible] tempwin
+++ informatica:ciberseguridad:cursos:curso_ansible_automatizacion_it:conceptos_fundamentales [2023/05/05 16:50] (actual) – [Inventarios estáticos] tempwin
@@ Línea 83: / Línea 83: @@
   * ''shell'': ejecuta los comandos en una shell (por ejemplo, ''/bin/sh'') y permite utilizar pipes, etc. Debe usarse con cuidado.
   * ''script'': transfiere un script y lo ejecuta en el equipo destino.
-  * ''raw'': ejecuta un comando fuera del módulo de Ansible
+  * ''raw'': ejecuta el comando sin pasar por el control de Ansible
+<WRAP center round info 60%>
+Los módulos ofrecen //idempotencia//, es decir, da igual las veces que lo ejecutemos, el resultado será el mismo, llegaríamos siempre al estado deseado. Esto con los //run commands// es más difícil y hay que ser cuidadosos.
+</WRAP>
+===== Ejecutando módulos de forma standalone =====
+Empezamos con el módulo ''[[https://docs.ansible.com/ansible/latest/collections/ansible/builtin/ping_module.html|ping]]'':
+<code>
+ansible localhost -m ping
+</code>
+<WRAP center round tip 60%>
+Podemos ver información sobre un módulo desde línea de comandos: ''ansible-doc <nombre_modulo>''
+</WRAP>
+<code>
+ansible localhost -m ping -a "data='correcto'"
+</code>
+<WRAP center round todo 60%>
+Poner la salida de los comandos anteriores
+</WRAP>
+Ejemplo con el módulo ''[[https://docs.ansible.com/ansible/latest/collections/ansible/builtin/script_module.html#ansible-collections-ansible-builtin-script-module|script]]'':
+<code>
+ansible localhost -m script -a "/home/pepito/miscript.sh"
+</code>
+Contenido de ''miscript.sh'':
+<code bash>
+#!/bin/bash
+echo "Hola, mundo!"
+</code>
+<WRAP center round todo 60%>
+Poner ejemplo de salida
+</WRAP>
+Si queremos cambiar la //shell// a usar:
+<code>
+ansible localhost -m script -a "/home/pepito/miscript.sh executable=/bin/sh"
+</code>
+===== Preparando las máquinas a gestionar con usuario y contraseña =====
+En la realidad lo que queremos en configurar una o varias máquinas remotas.
+==== Equipo a gestionar ====
+  * Crear un usuario para Ansible
+  * Verificar que el servicio SSH está funcionando
+Para crear usuario desde línea de comandos:
+<code>
+adduser ansible
+</code>
+Verificamos si el servicio SSH está corriendo:
+<code>
+systemctl status sshd
+</code>
+Podríamos verificar también si tenemos conectividad a nivel de red entre los equipos a gestionar y el equipo que hace de nodo de gestión:
+<code>
+ping ip.equipo.destino.1
+ping ip.equipo.destino.2
+ping ip.equipo.destino.X
+</code>
+==== Nodo de gestión ====
+  * Confiar en la clave SSH del equipo destino
+  * Especificar el usuario y contraseña a utilizar para realizar la gestión
+Para usar ansible desde el nodo de gestión:
+<code>
+ansible dir.ip.maquina.destino --user=ansible -k -m ping
+</code>
+  * ''-k'' nos pedirá la contraseña en lugar de tener que indicarla como argumento.
+De esta manera habríamos validado que Ansible puede conectarse al equipo remoto y recuperar información (en este caso usando el módulo ''ping'').
+===== Preparando las máquinas a gestionar con clave pública =====
+Para evitar dejar las credenciales en algún sitio accesible, usaremos la criptografía de clave pública. La privada nos la quedamos y la pública se la pasamos a los sistemas que queremos gestionar con Ansible.
+<WRAP center round tip 60%>
+Esta es la manera recomendable de realizar las conexiones a otros equipos
+</WRAP>
+==== Equipo a gestionar ====
+  * Disponer de un usuario para Ansible
+  * Verificar que el servicio SSH está funcionando.
+  * Configurar las claves SSH autorizadas.
+==== Nodo de gestión ====
+  * Generar clave SSH para la autenticación
+  * Configuar en la clave SSH del equipo destino
+  * Indicar a Ansible la ubicación de la clave
+  * Especificar el usuario a utilizar para realizar la conexión.
+Creamos el par de claves pública y privada:
+<code>
+ssh-keygen -N "" -C "Ansible"
+</code>
+Por defecto, las claves se generan en ''/home/usuario/.ssh/id_rsa'' (privada) y ''/home/usuario/.ssh/id_rsa.pub'' (pública)
+Ahora tendríamos que llevar la clave pública a los equipos a gestionar. Para ello, se puede copiar y pegar el contenido del fichero ''id_rsa.pub'' en ''/home/pepito/.ssh/authorized_keys'' o realizarlo mediante el comando ''ssh-copy-id'':
+<code>
+ssh-copy-id usuarioremoto@equiporemoto
+</code>
+Finalmente, para probar a conectarnos con claves:
+<code>
+ansible dir.ip.equipo.remoto --user=ansible --key-file /home/pepito/.ssh/id_rsa -m ping
+</code>
+  * ''%%--%%key-file'': permite indicar dónde está la clave privada del nodo de gestión.
+===== Inventarios estáticos =====
+Fichero con la lista de los sistemas que queremos configurar. En los estáticos no son más que un fichero de texto con información de los equipos.
+Ejemplo:
+<code>
+.0.65.40
+.0.65.42
+.0.65.50
+host.example.com
+</code>
+También son válidos:
+<code>
+[control]
+control ansible_host=10.0.42.10
+[web]
+node-[1:3] ansible_host=10.0.42.[5:8]
+</code>
+<code>
+ansible ip.dir.equipo.remoto -u ansible --key-file /home/pepito/.ssh/id_rsa -m ping
+</code>
+Ansible crea por defecto un inventario estático en ''/etc/ansible/hosts''. Ahí tendríamos que añadir los equipos que queremos gestionar.
+<WRAP center round important 60%>
+Añadir ejemplos de lo anterior.
+</WRAP>
+Para crear nuestro propio inventario estático, creamos un fichero de texto con el siguiente contenido:
+<code>
+.0.40.10
+.0.40.20
+</code>
+Para ejecutar Ansible sobre ese inventario:
+<code>
+ansible all -i /home/pepito/inventario -u ansible --key-file /home/pepito/.ssh/id_rsa -m ping
+</code>
+Podríamos "complicar" un poco el fichero de inventario:
+<code>
+[servidor_web]
+.0.40.10
+[bbdd]
+.0.40.20
+</code>
+<code>
+ansible all -i /home/pepito/inventario -l servidor_web -u ansible --key-file /home/pepito/.ssh/id_rsa -m ping
+</code>
+De esa manera, solo se ejecutará el módulo ''ping'' sobre la máquina etiquetada como ''servidor_web''.
+Si queremos agrupar máquinas:
+<code>
+[servidor_web]
+.0.40.10
+[bbdd]
+.0.40.20
+[aplicacion:children]
+servidor_web
+bbdd
+</code>
+<code>
+ansible all -i /home/pepito/inventario -l aplicacion -u ansible --key-file /home/pepito/.ssh/id_rsa -m ping
+</code>
+Más cosas, añadiendo alias:
+<code>
+[servidor_web]
+.0.40.10
+[bbdd]
+bbdd1 ansible_host=10.0.40.20
+</code>
+Y llamamos a Ansible sobre el equipo con la etiqueta que creamos anteriormente:
+<code>
+ansible bbdd1 -i /home/pepito/inventario -u ansible --key-file /home/pepito/.ssh/id_rsa -m ping
+</code>
+===== Qué son los facts en Ansible =====
+Los //facts// permiten recoger información sobre los sistemas objetivo y realizar así ciertas modificaciones en función de esa información recogida.
+<code>
+ansible servidor_web -i /home/pepito/inventario -u ansible --key-file /home/pepito/.ssh/id_rsa -m setup
+</code>
+  * El módulo ''setup'' permite recoger los //facts//
+<WRAP center round todo 60%>
+Poner salida del comando anterior
+</WRAP>
+Podríamos filtrar (mirar documentación oficial del módulo ''setup''):
+<code>
+ansible servidor_web -i /home/pepito/inventario -u ansible --key-file /home/pepito/.ssh/id_rsa -m setup -a "filter=ansible_processor"
+</code>
+Cuando usemos Playbooks, por defecto Ansible recoge todos los //facts//.
 ===== Recursos =====
   * [[https://docs.ansible.com/ansible/latest/inventory_guide/intro_inventory.html|How to build your inventory]]
   * [[https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_vars_facts.html|Discovering variables: facts and magic variables]]