Ansible

Máquina de control: instalación de Ansible en Ubuntu 18.04.3

Instalaremos Ansible en una máquina virtual de VirtualBox con Ubuntu 18.04.3 Server que ejercerá de máquina de control. La instalación la realizaremos con Packer a partir de la imagen creada en el ejemplo 1 de la lección Packer (2) mediante la plantilla y script siguientes:

• Plantilla de Packer ansible-1-1.json:

  {
    "builders": [
      {
        "type": "virtualbox-ovf",
        "source_path": "packer-2-1/packer-2-1-ubuntu-18-04-3-server.ova",
        "guest_additions_mode": "disable",
        "boot_wait": "30s",
        "ssh_username": "mclibre",
        "ssh_password": "mclibre",
        "shutdown_command": "echo 'mclibre' | sudo -S shutdown -P now",
        "output_directory": "ansible-1-1",
        "vm_name": "ansible-1-1-control-ubuntu-18-04-3-server",
        "format": "ova"
      }
    ],
    "provisioners": [
      {
        "type": "shell",
        "execute_command": "echo 'mclibre' | sudo -S sh -c '{{ .Vars }} {{ .Path }}'",
        "script": "ansible-1-1.sh",
        "pause_before": "10s"
      }
    ]
  }
  

  Notas:

  • Línea 11: El retardo tras el apagado es para dar tiempo a VirtualBox a desbloquear la máquina y poder hacer la exportación final.
• script de instalación de Ansible ansible-1-1.sh [fuente]:

  sudo apt update
  sudo DEBIAN_FRONTEND=noninteractive apt full-upgrade -yq
  sudo DEBIAN_FRONTEND=noninteractive apt install software-properties-common -yq
  sudo apt-add-repository ppa:ansible/ansible -y
  sudo apt update
  sudo DEBIAN_FRONTEND=noninteractive apt install ansible -yq
  

Nodos administrados: Ubuntu 18.04.3

En los nodos administrados no es necesario instalar Ansible. Los nodos administrados serán también máquinas virtuales de VirtualBox con Ubuntu 18.04.3 Server. Utilizaremos la imagen creada en el ejemplo 1 de la lección Packer (2) para los nodos administrados

Configuración inicial y primera conexión

La máquina de control Ansible se conecta con los nodos administrados por SSH. Para poder realizar esa conexión y comprobar su correcto funcionamiento, realice estos pasos en la máquina de control:

• Edite el archivo /etc/ansible/hosts para añadir la dirección IP de los nodos administrados:

  sudo nano /etc/ansible/hosts
  

• En el archivo /etc/ansible/hosts Ansible permite crear grupos de nodos. Los nombre de los grupos se escriben entre corchetes ([XXX]).

  Las opciones de configuración se pueden escribir en grupo [XXX-vars] (y afectan a todos los nodos incluidos en el grupo:

  [clients]
  192.168.1.16
  
  [clients:vars]
  ansible_python_interpreter=/usr/bin/python3
  

  Notas:

  • Como Ubuntu 18.04.3 incluye Python 3 (pero no Python 2), es necesario indicar a Ansible que utilice python3..

  Las opciones de configuración se pueden escribir en cada nodo (y afectan únicamente a dicho nodo):

  [clients]
  192.168.1.16 ansible_python_interpreter=/usr/bin/python3
  

• Ansible se comunica con los nodos mediante SSH por lo que se debe crear una clave SSH en la máquina de control y enviarla a los nodos administrados:

  ssh-keygen -t rsa
  ssh-copy-id mclibre@192.168.1.16
  

• Compruebe que se puede conectar con los nodos mediante la orden:

  ansible all -m ping
  

  Por cada nodo administrado debe mostrarse una respuesta similar a esta:

  192.168.1.16 | SUCCESS => {
      "changed": false,
      "ping": "pong"
  }
  

Ejemplo 1: Ejecución de comandos de shell

Para ejecutar comandos de la shell, Ansible dispone del módulo shell.

• Cree el archivo playbook-1-1.yaml con el siguiente contenido:

  ---
  - hosts: 'clients'
    tasks:
    - name: 'ejemplo 1'
      shell: 'ls -al >> prueba.txt'
  

• Ejecute el archivo playbook-1-1.yaml:

  ansible-playbook playbook-1-1.yaml
  

• Obtendrá una respuesta similar a esta:

  PLAY [clients] ******************************************************************
  
  TASK [Gathering facts] **********************************************************
  ok: [192.168.1.16]
  
  TASK [ejemplo 1] ****************************************************************
  changed: [192.168.1.16]
  
  PLAY RECAP **********************************************************************
  192.168.1.16                 : ok=2     changed=1   unreachable=0    failed=0
  

• En el nodo administrado puede comprobar que se ha creado el fichero listado.txt con el listado del directorio.
• Para obtener más información sobre la ejecución del playbook, ejecute el archivo con la opción --verbose:

  ansible-playbook playbook-1-1.yaml --verbose
  

Ejemplo 2: Actualización del sistema

Para tareas de mantenimiento de paquetes, Ansible dispone del módulo apt.

• Cree el archivo playbook-1-2.yaml con el siguiente contenido:

  ---
  - hosts: 'clients'
    tasks:
    - name: 'ejemplo 2'
      become: true
      apt:
        update_cache: true
        upgrade: true
  

• Ejecute el archivo playbook-1-2.yaml con la opción -K. La opción -K es necesaria porque apt requiere la contraseña del usuario:

  ansible-playbook playbook-1-2.yaml -K
  

• Obtendrá una respuesta similar a esta:

  SUDO password:
  
  PLAY [clients] ******************************************************************
  
  TASK [Gathering facts] **********************************************************
  ok: [192.168.1.16]
  
  TASK [ejemplo 2] ****************************************************************
  [WARNING]: Could not find aptitude. Using apt-get instead.
  changed: [192.168.1.16]
  
  PLAY RECAP **********************************************************************
  192.168.1.16                 : ok=2     changed=1   unreachable=0    failed=0
  

  Nota:

  • El aviso [WARNING] se debe a que el paquete aptitude no está instalado.

Ejemplo 3: Instalación y desinstalación de paquetes

Para tareas de mantenimiento de paquetes, Ansible dispone del módulo apt.

En el ejemplo siguiente, se instala el paquete aptitude, un interfaz en modo texto de APT.

• Compruebe en el nodo administrado que el paquete aptitude no está instalado con la orden:

  apt-cache policy aptitude
  

  Si aptitude no está instalado, se mostrará la respuesta:

  aptitude:
    Instalados: (ninguno)
    ...
  

• Cree el archivo playbook-1-3.yaml con el siguiente contenido:

  ---
  - hosts: 'clients'
    tasks:
    - name: 'ejemplo 3'
      become: true
      apt:
        name: 'aptitude'
        state: 'present'
  

• Ejecute el archivo playbook-1-3.yaml con la opción -K. La opción -K es necesaria porque apt requiere la contraseña del usuario:

  ansible-playbook playbook-1-3.yaml -K
  

• Compruebe en el nodo administrado que el paquete aptitude sí que está ahora instalado con la orden:

  apt-cache policy aptitude
  

  Si aptitude está instalado, se mostrará una respuesta similar a esta:

  aptitude:
    Instalados: 0.8.10-6ubuntu1
    ...
  

Para desinstalar el paquete, el playbook sería:

---
- hosts: 'clients'
  tasks:
  - name: 'ejemplo 3'
    become: true
    apt:
      name: 'aptitude'
      state: 'absent'