Rôle Ansible : kimdre.hcloud-backup

Rôle Ansible pour créer et faire tourner des sauvegardes et des instantanés de serveurs dans Hetzner Cloud.

• Exigences
• Variables du rôle
  • api_token
• Variables par défaut
• Exemple de Playbook
• Licence
• Auteur

Exigences

• Ansible 2.15 ou version ultérieure

Variables du rôle

api_token

Jeton API de Hetzner Cloud.

Exemple

api_token: "votre-jeton-hcloud"

Peut également être défini comme une variable d'environnement HCLOUD_TOKEN.

Variables par défaut

Voir hcloud-backup/defaults/main.yml pour toutes les variables disponibles.

backup_type

Type de sauvegarde à créer.

Formats possibles :

• snapshot est généralement moins coûteux avec de plus petits serveurs et moins d'utilisation de disque, et il n'y a pas de limite sur le nombre d'instantanés pouvant être créés.
• backup doit être activé d'abord pour le serveur et seuls 7 sauvegardes peuvent être créées par serveur avant d'être tournées.

Valeur par défaut

backup_type: snapshot

backup_description

Description de l'instantané/sauvegarde.

Valeur par défaut

backup_description: "{{ inventory_hostname }} {{ now(fmt='%Y-%m-%d %H:%M:%S') }}"

backup_labels

Liste des étiquettes de l'instantané/sauvegarde.

Formats possibles :

• key: "value"
• key: "" pour les étiquettes sans valeur.

Valeur par défaut

backup_labels:
    created_by: "ansible.hcloud-backup"
    created_at: "{{ now(fmt='%Y-%m-%d_%H-%M-%S') }}"
    host: "{{ inventory_hostname }}"
    rotation: "true"

label_selector

Liste des étiquettes pour identifier les instantanés à faire tourner, qui doit se chevaucher avec backup_labels.

Utilisé uniquement lorsque backup_type est défini sur snapshot.

Formats possibles :

• key: "value"
• key: "" pour les étiquettes sans valeur.

Valeur par défaut

label_selector:
    created_by: ansible.hcloud-backup
    host: "{{ inventory_hostname }}"
    rotation: "true"

rotate_snapshots

Faire tourner les instantanés, s'il est défini sur true, les instantanés les plus anciens trouvés seront supprimés en fonction de la variable keep_snapshots et du nombre d'instantanés existants.

Utilisé uniquement lorsque backup_type est défini sur snapshot.

Valeur par défaut

rotate_snapshots: true

keep_snapshots

Nombre d'instantanés à conserver, les anciens instantanés seront supprimés.

Utilisé uniquement lorsque backup_type est défini sur snapshot et rotate_snapshots est défini sur true.

Valeur par défaut

keep_snapshots: 5

backup_check_retries

Nombre de tentatives pour vérifier la création de la sauvegarde.

Valeur par défaut

backup_check_retries: 40

backup_check_delay

Retard en secondes entre les tentatives pour vérifier la création de la sauvegarde.

Valeur par défaut

backup_check_delay: 15

delegation

Hôte pour exécuter les tâches du rôle

Valeur par défaut

delegation: "{{ inventory_hostname }}"

Exemple de Playbook

- name: "Créer un instantané de l'hôte"
  hosts: '{{ target | default("all") }}'
  roles:
    - role: kimdre.hcloud-backup
      vars:
        api_token: "votre-jeton-api-hcloud"
        backup_type: "snapshot"
        keep_snapshots: 7

Licence

Apache-2.0

Auteur

• Kim Oliver Drechsel