Hoja de Trucos de Ansible

Instalación y Configuración

Ubuntu/Debian: apt install ansible

Instalar Ansible en sistemas Linux basados en Debian.

# Añadir repositorio de Ansible
sudo apt-add-repository ppa:ansible/ansible
# Actualizar listas de paquetes
sudo apt-get update
# Instalar Ansible
sudo apt-get install ansible
# Verificar instalación
ansible --version

CentOS/RHEL: yum install ansible

Instalar Ansible en sistemas basados en Red Hat.

# Instalar repositorio EPEL
sudo yum install epel-release -y
# Instalar Ansible
sudo yum install ansible -y
# Verificar instalación
ansible --version

macOS: brew install ansible

Instalar Ansible en macOS usando Homebrew.

# Instalar usando Homebrew
brew install ansible
# Verificar instalación
ansible --version

Configuración: /etc/ansible/ansible.cfg

Configurar ajustes y valores predeterminados de Ansible.

# Ver configuración actual
ansible-config list
# Ver configuración efectiva
ansible-config view
# Archivo de configuración personalizado
export ANSIBLE_CONFIG=/path/to/ansible.cfg

Configuración SSH: Autenticación basada en Claves

Ansible utiliza SSH para comunicarse entre nodos.

# Generar clave SSH
ssh-keygen -t rsa -b 4096
# Copiar clave pública a hosts remotos
ssh-copy-id user@hostname
# Probar conexión SSH
ssh user@hostname

Configuración del Entorno

Configurar variables de entorno y rutas del entorno Ansible.

# Establecer ubicación del archivo de inventario
export ANSIBLE_INVENTORY=/path/to/inventory
# Establecer verificación de claves de host
export ANSIBLE_HOST_KEY_CHECKING=False
# Establecer usuario remoto
export ANSIBLE_REMOTE_USER=ubuntu

Gestión de Inventario

Inventario Básico: /etc/ansible/hosts

Los grupos de hosts se pueden crear dando un nombre de grupo entre corchetes.

# Archivo de hosts básico (formato INI)
[webservers]
web1.example.com
web2.example.com
[databases]
db1.example.com
db2.example.com
[all:vars]
ansible_user=ubuntu
ansible_ssh_private_key_file=~/.ssh/id_rsa

Formato de Inventario YAML

Los archivos de inventario pueden estar en formato INI o YAML.

# inventory.yml
all:
  children:
    webservers:
      hosts:
        web1.example.com:
        web2.example.com:
    databases:
      hosts:
        db1.example.com:
      vars:
        mysql_port: 3306

Variables de Host y Grupos

Definir variables específicas del host y configuraciones de grupo.

# Inventario con variables
[webservers]
web1.example.com http_port=80
web2.example.com http_port=8080
[webservers:vars]
ansible_user=nginx
nginx_version=1.18

# Probar inventario
ansible-inventory --list
ansible-inventory --graph

Comandos Ad-Hoc

Estructura Básica del Comando

Estructura básica de un comando Ansible: ansible <hosts> -m <module> -a "<arguments>"

# Probar conectividad
ansible all -m ping
# Verificar grupo específico
ansible webservers -m ping
# Ejecutar comando en todos los hosts
ansible all -m command -a "uptime"
# Ejecutar con privilegios sudo
ansible all -m command -a "systemctl status nginx" --become

Operaciones de Archivos

Crear directorios, archivos y enlaces simbólicos en los hosts.

# Crear directorio
ansible all -m file -a "path=/tmp/test state=directory mode=0755"
# Crear archivo
ansible all -m file -a "path=/tmp/test.txt state=touch"
# Eliminar archivo/directorio
ansible all -m file -a "path=/tmp/test state=absent"
# Crear enlace simbólico
ansible all -m file -a "src=/etc/nginx dest=/tmp/nginx state=link"

Gestión de Paquetes

Instalar, actualizar y eliminar paquetes en diferentes sistemas.

# Instalar paquete (apt)
ansible webservers -m apt -a "name=nginx state=present" --become
# Instalar paquete (yum)
ansible webservers -m yum -a "name=httpd state=present" --become
# Actualizar todos los paquetes
ansible all -m apt -a "upgrade=dist" --become
# Eliminar paquete
ansible all -m apt -a "name=apache2 state=absent" --become

Gestión de Servicios

Iniciar, detener y gestionar servicios del sistema.

# Iniciar servicio
ansible webservers -m service -a "name=nginx state=started" --become
# Detener servicio
ansible webservers -m service -a "name=apache2 state=stopped" --become
# Reiniciar servicio
ansible webservers -m service -a "name=ssh state=restarted" --become
# Habilitar servicio al arranque
ansible all -m service -a "name=nginx enabled=yes" --become

Playbooks y Tareas

Estructura Básica del Playbook

Archivos YAML que definen qué tareas deben ejecutarse y en qué hosts.

---
- name: Configuración del servidor web
  hosts: webservers
  become: yes
  vars:
    nginx_port: 80

  tasks:
    - name: Instalar nginx
      apt:
        name: nginx
        state: present

    - name: Iniciar servicio nginx
      service:
        name: nginx
        state: started
        enabled: yes

Ejecución de Playbooks

Ejecutar playbooks con varias opciones y configuraciones.

# Ejecutar playbook
ansible-playbook site.yml
# Ejecutar con inventario específico
ansible-playbook -i inventory.yml site.yml
# Ejecución simulada (modo check)
ansible-playbook site.yml --check
# Ejecutar en hosts específicos
ansible-playbook site.yml --limit webservers
# Ejecutar con variables extra
ansible-playbook site.yml --extra-vars "nginx_port=8080"

Opciones de Tarea y Condicionales

Añadir condiciones, bucles y manejo de errores a las tareas.

tasks:
  - name: Instalar paquetes
    apt:
      name: '{{ item }}'
      state: present
    loop:
      - nginx
      - mysql-server
      - php
    when: ansible_os_family == "Debian"

  - name: Crear usuario
    user:
      name: webuser
      state: present
    register: user_result

  - name: Mostrar resultado de creación de usuario
    debug:
      msg: 'Usuario creado: {{ user_result.changed }}'

Handlers y Notificaciones

Definir handlers que se ejecutan cuando son notificados por las tareas.

tasks:
  - name: Actualizar configuración de nginx
    template:
      src: nginx.conf.j2
      dest: /etc/nginx/nginx.conf
    notify: reiniciar nginx

handlers:
  - name: reiniciar nginx
    service:
      name: nginx
      state: restarted

Variables y Plantillas

Definición de Variables

Definir variables en diferentes niveles y alcances.

# En playbook
vars:
  app_name: myapp
  app_port: 8080

# En group_vars/all.yml
database_host: db.example.com
database_port: 5432

# En host_vars/web1.yml
server_role: frontend
max_connections: 100

# Variables de línea de comando
ansible-playbook site.yml -e "env=production"

Plantillas Jinja2

Crear archivos de configuración dinámicos usando plantillas.

# Archivo de plantilla: nginx.conf.j2
server {
    listen {{ nginx_port }};
    server_name {{ server_name }};

    location / {
        proxy_pass http://{{ backend_host }}:{{ backend_port }};
    }
}

# Usando el módulo template
- name: Desplegar configuración de nginx
  template:
    src: nginx.conf.j2
    dest: /etc/nginx/sites-available/default
  notify: recargar nginx

Facts y Información del Sistema

Recopilar y usar facts del sistema en playbooks.

# Recopilar facts manualmente
ansible all -m setup
# Recopilar facts específicos
ansible all -m setup -a "filter=ansible_eth*"

# Usar facts en playbooks
- name: Mostrar información del sistema
  debug:
    msg: '{{ ansible_hostname }} ejecuta {{ ansible_distribution }}'

- name: Instalar paquete basado en el SO
  apt:
    name: apache2
  when: ansible_os_family == "Debian"

Vault y Gestión de Secretos

Cifrar datos sensibles usando Ansible Vault.

# Crear archivo cifrado
ansible-vault create secrets.yml
# Editar archivo cifrado
ansible-vault edit secrets.yml
# Cifrar archivo existente
ansible-vault encrypt passwords.yml
# Ejecutar playbook con vault
ansible-playbook site.yml --ask-vault-pass
# Usar archivo de contraseña vault
ansible-playbook site.yml --vault-password-file .vault_pass

Roles y Organización

Estructura de Roles

Organizar playbooks en roles reutilizables.

# Crear estructura de rol
ansible-galaxy init webserver

# Estructura de directorio del Rol
webserver/
├── tasks/
│   └── main.yml
├── handlers/
│   └── main.yml
├── templates/
├── files/
├── vars/
│   └── main.yml
├── defaults/
│   └── main.yml
└── meta/
    └── main.yml

Uso de Roles en Playbooks

Aplicar roles a hosts en sus playbooks.

---
- hosts: webservers
  roles:
    - common
    - webserver
    - { role: database, database_type: mysql }

# O con include_role
- hosts: webservers
  tasks:
    - include_role:
        name: webserver
      vars:
        nginx_port: 8080

Ansible Galaxy

Descargar y gestionar roles de la comunidad desde Ansible Galaxy.

# Instalar rol desde Galaxy
ansible-galaxy install geerlingguy.nginx
# Instalar versión específica
ansible-galaxy install geerlingguy.nginx,2.8.0
# Instalar desde archivo requirements
ansible-galaxy install -r requirements.yml
# Listar roles instalados
ansible-galaxy list
# Eliminar rol
ansible-galaxy remove geerlingguy.nginx

Colecciones

Trabajar con Colecciones de Ansible para funcionalidad extendida.

# Instalar colección
ansible-galaxy collection install community.general

# Usar colección en playbook
collections:
  - community.general
tasks:
  - name: Instalar paquete
    community.general.snap:
      name: code
      state: present

Depuración y Solución de Problemas

Depuración de Tareas

Depurar y solucionar problemas en la ejecución de playbooks.

# Añadir tareas de depuración
- name: Mostrar valor de variable
  debug:
    var: my_variable
- name: Mostrar mensaje personalizado
  debug:
    msg: 'Servidor {{ inventory_hostname }} tiene IP {{ ansible_default_ipv4.address }}'

# Ejecución detallada (verbose)
ansible-playbook site.yml -v
ansible-playbook site.yml -vvv  # Verbosity máxima

Manejo de Errores

Manejar errores y fallos con elegancia.

- name: Tarea que podría fallar
  command: /bin/false
  ignore_errors: yes

- name: Tarea con rescue
  block:
    - command: /bin/false
  rescue:
    - debug:
        msg: 'La tarea falló, ejecutando rescue'
  always:
    - debug:
        msg: 'Esto siempre se ejecuta'

Pruebas y Validación

Probar playbooks y validar configuraciones.

# Verificar sintaxis
ansible-playbook site.yml --syntax-check
# Listar tareas
ansible-playbook site.yml --list-tasks
# Listar hosts
ansible-playbook site.yml --list-hosts
# Recorrer playbook paso a paso
ansible-playbook site.yml --step
# Probar con modo de verificación
ansible-playbook site.yml --check --diff

Rendimiento y Optimización

Optimizar el rendimiento de la ejecución del playbook.

# Ejecutar tareas en paralelo
- name: Instalar paquetes
  apt:
    name: '{{ packages }}'
  vars:
    packages:
      - nginx
      - mysql-server

# Usar async para tareas de larga duración
- name: Tarea de larga duración
  command: /usr/bin/long-task
  async: 300
  poll: 5

Mejores Prácticas y Consejos

Mejores Prácticas de Seguridad

Asegurar su infraestructura y operaciones de Ansible.

# Usar Ansible Vault para secretos
ansible-vault create group_vars/all/vault.yml
# Deshabilitar la verificación de claves de host con cautela
host_key_checking = False
# Usar become solo cuando sea necesario
become: yes
become_user: root
# Limitar el alcance del playbook
ansible-playbook site.yml --limit production

Organización del Código

Estructurar sus proyectos Ansible de manera efectiva.

# Estructura de directorio recomendada
ansible-project/
├── inventories/
│   ├── production/
│   └── staging/
├── group_vars/
├── host_vars/
├── roles/
├── playbooks/
└── ansible.cfg

# Usar nombres significativos y documentación
- name: Nombre de tarea descriptivo
  # Añadir comentarios para lógica compleja

Control de Versiones y Pruebas

Gestionar el código de Ansible con un control de versiones adecuado.

# Usar Git para control de versiones
git init
git add .
git commit -m "Configuración inicial de Ansible"
# Probar en staging antes de producción
ansible-playbook -i staging site.yml
# Usar etiquetas (tags) para ejecución selectiva
ansible-playbook site.yml --tags "nginx,ssl"

Configuración y Características Avanzadas

Configuración de Ansible

Personalizar el comportamiento de Ansible con opciones de configuración.

# ansible.cfg
[defaults]
inventory = ./inventory
remote_user = ansible
host_key_checking = False
timeout = 30
forks = 5

[ssh_connection]
ssh_args = -o ControlMaster=auto -o ControlPersist=60s
pipelining = True

Plugins de Callback

Mejorar la salida y el registro con plugins de callback.

# Habilitar plugins de callback en ansible.cfg
[defaults]
stdout_callback = yaml
callbacks_enabled = profile_tasks, timer

# Configuración de callback personalizado
[callback_profile_tasks]
task_output_limit = 20

Filtros y Plugins de Búsqueda (Lookup)

Usar filtros Jinja2 y plugins de búsqueda para manipulación de datos.

# Filtros comunes en plantillas
{{ variable | default('default_value') }}
{{ list_var | length }}
{{ string_var | upper }}
{{ dict_var | to_nice_yaml }}

# Plugins de búsqueda (lookup)
- name: Leer contenido de archivo
  debug:
    msg: "{{ lookup('file', '/etc/hostname') }}"

- name: Variable de entorno
  debug:
    msg: "{{ lookup('env', 'HOME') }}"

Inventarios Dinámicos

Usar inventarios dinámicos para entornos de nube y contenedores.

# Inventario dinámico AWS EC2
ansible-playbook -i ec2.py site.yml
# Inventario dinámico Docker
ansible-playbook -i docker.yml site.yml
# Script de inventario personalizado
ansible-playbook -i ./dynamic_inventory.py site.yml

Enlaces Relevantes

• Hoja de Trucos de Linux
• Hoja de Trucos de Shell
• Hoja de Trucos de DevOps
• Hoja de Trucos de Docker
• Hoja de Trucos de Kubernetes
• Hoja de Trucos de Python