Curso Ansible: Generar ficheros YAML

Raul Unzue Pulido 10 julio, 2024 Automatización Deja un comentario 701 Vistas

Curso Ansible: Generar ficheros YAML

Seguimos ampliando el curso de Ansible…

Hoy vamos a mostraros como podemos generar los ficheros YAML o YML, que son los que nos permitirán ejecutar y definir las configuraciones que queremos trabajar.

Los ficheros YAML (YAML Ain’t Markup Language) son fundamentales en Ansible para definir playbooks, roles, variables, inventarios y más. Os explico cómo crear un fichero YAML y os voy a proporcionar una tabla con las opciones más comunes que podemos utilizar, junto con su explicación.

¿Qué es YAML?

YAML es un formato de serialización de datos legible para los humanos que se usa comúnmente para archivos de configuración. Es simple de leer y escribir, lo que lo hace ideal para la gestión de configuraciones en Ansible.

Creación de un Fichero YAML

Para crear un fichero YAML en Ansible:

Abre tu editor de texto favorito: Puedes usar editores como vim, nano, VSCode, Sublime Text, etc.
Crea un nuevo archivo: Asegúrate de que el nombre del archivo termine con .yml o .yaml.

Aquí te explico algunas reglas importantes sobre la indentación en YAML:

Reglas de Indentación en YAML

La indentación es el espacio en blanco al comienzo de una línea de texto en un archivo. En muchos lenguajes de programación y de marcado, incluido YAML, la indentación se utiliza para definir la estructura y la jerarquía de los bloques de código o datos. En otras palabras, la indentación determina qué elementos están contenidos dentro de otros elementos, lo que es fundamental para la correcta interpretación del archivo.

Consistencia en la indentación: Es fundamental que la indentación sea consistente en todo el archivo. Puedes usar espacios o tabuladores, pero nunca mezcles ambos en el mismo archivo.
Cantidad de espacios: La cantidad de espacios es flexible, pero se recomienda usar dos espacios para cada nivel de indentación para mantener la legibilidad.
No usar Tabuladores: Aunque técnicamente es posible usar tabuladores, la práctica recomendada es utilizar espacios, ya que los tabuladores pueden causar problemas de interpretación en diferentes herramientas o editores.

Ejemplo Básico de un Playbook en YAML

Aquí hay un ejemplo básico de un playbook en YAML:

---
- name: Ejemplo de Playbook
  hosts: localhost
  tasks:
    - name: Crear un fichero
      file:
        path: /tmp/archivo.txt
        state: touch

---

- name: Ejemplo de Playbook

hosts: localhost

tasks:

- name: Crear un fichero

file:

path: /tmp/archivo.txt

state: touch

¿Por Qué Se Usa “—“?

La línea — se usa al comienzo de un archivo YAML para indicar el inicio de un documento YAML. Aunque no es estrictamente necesario en todos los casos, es una práctica recomendada especialmente en archivos más largos o cuando hay múltiples documentos YAML en un solo archivo. Ayuda a los analizadores (parsers) a reconocer el inicio de un documento, lo que mejora la legibilidad y organización del archivo.

Tabla de opciones comunes en Ansible YAML

A continuación, se presenta una tabla con las opciones más comunes que puedes introducir en un fichero YAML para Ansible, junto con su explicación:

Explicación de un Playbook Completo

Vamos a desglosar un playbook completo usando las opciones anteriores:

---
- name: Despliegue de Aplicación Web
  hosts: webservers
  become: yes

  vars:
    http_port: 80
    max_clients: 200

  tasks:
    - name: Instalar Apache
      apt:
        name: apache2
        state: present
      when: ansible_os_family == "Debian"
      notify: Reiniciar Apache

    - name: Crear directorio para la aplicación
      file:
        path: /var/www/myapp
        state: directory

    - name: Subir archivo de configuración
      template:
        src: templates/httpd.conf.j2
        dest: /etc/apache2/sites-available/000-default.conf

  handlers:
    - name: Reiniciar Apache
      service:
        name: apache2
        state: restarted

---

- name: Despliegue de Aplicación Web

hosts: webservers

become: yes

vars:

http_port: 80

max_clients: 200

tasks:

- name: Instalar Apache

apt:

name: apache2

state: present

when: ansible_os_family == "Debian"

notify: Reiniciar Apache

- name: Crear directorio para la aplicación

file:

path: /var/www/myapp

state: directory

- name: Subir archivo de configuración

template:

src: templates/httpd.conf.j2

dest: /etc/apache2/sites-available/000-default.conf

handlers:

- name: Reiniciar Apache

service:

name: apache2

state: restarted

Pasos para Crear y Ejecutar el Playbook

Crear el archivo YAML: Guarda el contenido del playbook en un archivo, por ejemplo, deploy_web.yml.
Ejecutar el playbook: Usa el comando ansible-playbook para ejecutar tu playbook.