hadret.restic

Descripción general Versiones Perspectivas

Rol de Ansible: Restic

Un rol de Ansible que instala restic en Linux y FreeBSD.

Requisitos

Ninguno.

Variables del Rol

Las variables disponibles se enumeran a continuación, junto con sus valores predeterminados (ver defaults/main.yml):

restic_version: '0.15.1'
restic_install_path: '/usr/local/bin'
restic_password_file_path: '/root'
restic_discard_cron_stdout: false

restic_user: root
restic_group: "{{ restic_user }}"

restic_version especifica la versión del binario de restic que se debe instalar. Se compara con el repositorio de GitHub donde se anuncian las versiones para su descarga.
restic_install_path proporciona la ruta donde el binario de restic debe estar disponible (/usr/local/bin se exporta por defecto como parte de $PATH). También es la misma ruta utilizada por el script envoltorio que realiza la ejecución de la copia de seguridad, donde el nombre se construye como $restic_install_path/restic-$job_name (más sobre eso más adelante).
restic_password_file_path proporciona la ruta a la carpeta en la que se deben almacenar los archivos de contraseña para los repositorios de restic. Cada archivo se construye como $restic_password_file_path/.restic-@job_name. Estos archivos son ocultos (de ahí el . al principio del archivo) por defecto y están restringidos al restic_user y restic_group para acceso de solo lectura. Estos, por defecto, son root, pero se pueden sobreescribir y se puede usar cualquier usuario válido o ya presente. En tal caso, se garantizarán las capacidades adecuadas para ese usuario.

restic_discard_cron_stdout: false

Define si la salida del cronjob debe ser dirigida a /dev/null o no (enviará un correo electrónico en cada ejecución si esto se establece en false).

restic_prometheus_exporter: true
restic_prometheus_output_path: /var/lib/node_exporter/textfile_collector

Habilita una muy simple integración con Prometheus que va a escribir tres valores en la ubicación del recolector de archivos de texto predeterminado. Tenga en cuenta que habilitar el soporte para esto instalará/requerirá dos dependencias adicionales: jq y moreutils (para sponge).

restic_repos: []

Esto define un arreglo de trabajos de restic. Cada trabajo definido creará un script envoltorio separado y un archivo de contraseña. Se pueden encontrar ejemplos en defaults/main.yml.

Dependencias

Ninguna.

Ejemplo de Playbook

- hosts: all
  roles:
     - hadret.restic

Créditos

Este rol se basa en el trabajo de donat-b/ansible-restic y paulfantom/ansible-restic. Todas las pruebas de molecule y la configuración de CI se basan en el trabajo de geerlingguy. Muchas partes de la integración con Prometheus fueron tomadas directamente de este hilo en el foro de Restic.