maxhoesel.ddclient

Un rôle très minimal pour installer et configurer ddclient depuis GitHub. Configure également un service systemd pour activer le mode démon de ddclient.

Exigences

Une version récente d'Ansible. Ce rôle prend en charge les 2 versions majeures d'Ansible les plus récentes. Les versions plus anciennes peuvent encore fonctionner, mais elles ne sont pas supportées.
Un hôte exécutant :
- Ubuntu 18.04 LTS ou plus récent
- Debian 10 ou plus récent
- D'autres distributions peuvent fonctionner, mais elles ne sont pas supportées (N'hésitez pas à ajouter le support avec une PR !)

Variables du rôle

Installation

`ddclient_version`

Version de ddclient à installer
Peut être une branche, un tag, un commit ou une autre valeur supportée par git.
Par défaut : develop

`ddclient_executable_path`

Chemin où mettre l'exécutable ddclient
Par défaut : /usr/local/sbin/ddclient, pour ne pas interférer avec les paquets de la distribution.

`ddclient_configfile`

Fichier de configuration à utiliser pour l'installation de ddclient
Par défaut : /etc/ddclient.conf

`ddclient_pidfile`

Fichier PID à utiliser pour le démon ddclient
Par défaut : /var/run/ddclient.pid

`ddclient_systemd_unit`

Nom du fichier d'unité pour le démon ddclient
Par défaut : ddclient

Configuration

`ddclient_interval`

Nombre de secondes entre les vérifications d'IP DynDNS
Par défaut : 300

`ddclient_mail`

Envoyer toutes les mises à jour à cet utilisateur/adresse mail
Par défaut : root

`ddclient_mail_failure`

Envoyer toutes les échecs à cet utilisateur/adresse mail
Par défaut : root

`ddclient_entries`

Liste des entrées de configuration ddclient
Chaque entrée contient une liste d'options et une liste de domaines
- Les options correspondent 1:1 aux paramètres de ddclient

Exemple :

- options:
    protocol: cloudflare
    zone: domain.tld
    ttl: 60
    login: votre-email
    password: APIKey
  domains:
    - domain.tld
    - my.domain.tld

Recherche IP

Options de configuration pour déterminer comment ddclient obtient les adresses IP qu'il doit mettre à jour via DynDNS. Par défaut, tous ces paramètres ne sont pas définis, ce qui signifie que ddclient utilisera ses valeurs par défaut intégrées.

REMARQUE : La plupart des paramètres ci-dessous peuvent être définis pour IPv4 ou IPv6.

`ddclient_strategy_usev[4/6]`

Définir la stratégie pour déterminer l'adresse IP IPv4/6 à utiliser pour les mises à jour DynDNS
Options : webv[4/6], if[4/6], ip[4/6], fw, cmd
Par défaut : non défini

`ddclient_strategy_ipv[4/6]`

Définir une IP statique lors de l'utilisation de la stratégie ip
Par défaut : non défini

`ddclient_strategy_ifv[4/6]`

Obtenir l'adresse IP d'une interface donnée lors de l'utilisation de la stratégie if
Par défaut : non défini

`ddclient_strategy_webv[4/6]`

Obtenir l'adresse IPv4 à partir d'un service de découverte IP en ligne, qu'il soit connu ou personnalisé
Par défaut : non défini

`ddclient_strategy_webv[4/6]_skip`

Voir la documentation de ddclient
Par défaut : non défini

`ddclient_strategy_fwv[4/6]`

Obtenir l'adresse IP à partir d'un appareil avec cette adresse IP ou URL
Par défaut : non défini

`ddclient_strategy_fwv[4/6]_skip`

Ignorer les adresses IP avant ce motif dans le texte renvoyé par l'appareil
Par défaut : non défini

`ddclient_strategy_fw_login`

Utiliser ce login lors de l'obtention de l'IP de l'appareil
Par défaut : non défini

`ddclient_strategy_fw_password`

Utiliser ce mot de passe lors de l'obtention de l'IP de l'appareil
Par défaut : non défini

`ddclient_strategy_cmdv[4/6]`

Obtenir l'adresse IPv4 à partir de la sortie de cette commande
Par défaut : non défini

Exemple de Playbook

- hosts: all
  tasks:
    - name: Installer ddclient
      include_role:
        name: maxhoesel.ddclient
      vars:
        ddclient_entries:
        - options:
            protocol: cloudflare
            zone: domain.tld
            ttl: 1 # automatique
            login: votre-email
            password: APIKey
          domains:
            - domain.tld
            - my.domain.tld
        # Déterminer l'adresse IPv4 en utilisant dyndns
        ddclient_strategy_usev4: webv4
        ddclient_strategy_webv4: dyndns
        # Obtenir l'adresse IPv6 depuis eth0
        ddclient_strategy_usev6: ifv6
        ddclient_strategy_ifv6: eth0