Rola Ansible: kimdre.hcloud-backup

Rola Ansible do tworzenia i zarządzania kopią zapasową oraz migawkami serwerów w Hetzner Cloud.

• Wymagania
• Zmienne roli
  • api_token
• Domyślne zmienne
• Przykładowy playbook
• Licencja
• Autor

Wymagania

• Ansible w wersji 2.15 lub nowszej

Zmienne roli

api_token

Token API Hetzner Cloud.

Przykład

api_token: "twój-token-hcloud"

Można również ustawić jako zmienną środowiskową HCLOUD_TOKEN.

Domyślne zmienne

Zobacz plik hcloud-backup/defaults/main.yml dla wszystkich dostępnych zmiennych.

backup_type

Typ kopii zapasowej do utworzenia.

Możliwe formaty:

• snapshot jest zazwyczaj tańszy przy mniejszych serwerach i zużyciu dysku, a liczba migawków jest nieograniczona.
• backup musi być najpierw włączony dla serwera i można utworzyć tylko 7 kopii zapasowych na serwer przed ich obrotem.

Wartość domyślna

backup_type: snapshot

backup_description

Opis migawki/backupu.

Wartość domyślna

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

backup_labels

Lista etykiet migawki/backupu.

Możliwe formaty:

• key: "value"
• key: "" dla etykiet bez wartości.

Wartość domyślna

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

label_selector

Lista etykiet do identyfikacji migawków do obrotu, powinna pokrywać się z backup_labels.

Używane tylko wtedy, gdy backup_type jest ustawiony na snapshot.

Możliwe formaty:

• key: "value"
• key: "" dla etykiet bez wartości.

Wartość domyślna

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

rotate_snapshots

Obrót migawków, jeśli ustawione na true, najstarsze znalezione migawki zostaną usunięte zgodnie z wartością zmiennej keep_snapshots oraz liczbą istniejących migawków.

Używane tylko wtedy, gdy backup_type jest ustawiony na snapshot.

Wartość domyślna

rotate_snapshots: true

keep_snapshots

Liczba migawków do zachowania, starsze migawki zostaną usunięte.

Używane tylko wtedy, gdy backup_type jest ustawiony na snapshot oraz rotate_snapshots jest ustawione na true.

Wartość domyślna

keep_snapshots: 5

backup_check_retries

Liczba prób sprawdzenia utworzenia kopii zapasowej.

Wartość domyślna

backup_check_retries: 40

backup_check_delay

Opóźnienie w sekundach między próbami sprawdzenia utworzenia kopii zapasowej.

Wartość domyślna

backup_check_delay: 15

delegation

Host do uruchamiania zadań roli.

Wartość domyślna

delegation: "{{ inventory_hostname }}"

Przykładowy playbook

- name: "Utwórz migawkę hosta"
  hosts: '{{ target | default("all") }}'
  roles:
    - role: kimdre.hcloud-backup
      vars:
        api_token: "twój-token-api-hcloud"
        backup_type: "snapshot"
        keep_snapshots: 7

Licencja

Apache-2.0

Autor

• Kim Oliver Drechsel