Rôle Ansible pour Headscale

Un rôle qui installe et gère Headscale sur Linux.

Exigences

• Ansible >= 7

Installation

ansible-galaxy install kazauwa.headscale

Variables du rôle

• headscale_version
  • Par défaut : 0.22.3
  • Description : version de Headscale à installer. La liste des versions disponibles se trouve sur la page des versions officielles. Par défaut, c'est la dernière version disponible.
• headscale_arch
  • Par défaut : amd64
  • Description : architecture cible du binaire de Headscale.
• headscale_os
  • Par défaut : linux
  • Description : système d'exploitation cible du binaire de Headscale.
• headscale_user_name
  • Par défaut : headscale
  • Description : nom de l'utilisateur de service pour exécuter le binaire de Headscale.
• headscale_user_group
  • Par défaut : headscale
  • Description : groupe de l'utilisateur de service pour exécuter le binaire de Headscale.
• headscale_user_uid
  • Par défaut : 800
  • Description : uid pour l'utilisateur de service pour exécuter le binaire de Headscale.
• headscale_user_gid
  • Par défaut : 800
  • Description : gid pour l'utilisateur de service pour exécuter le binaire de Headscale.
• headscale_binary_path
  • Par défaut : /usr/local/bin/headscale
  • Description : chemin pour installer le binaire de Headscale.
• headscale_config_dir
  • Par défaut : /etc/headscale
  • Description : chemin vers les fichiers de configuration de Headscale.
• headscale_var_data_dir
  • Par défaut : /var/lib/headscale
  • Description : chemin vers les données de Headscale.
• headscale_pid_dir
  • Par défaut : /var/run/headscale
  • Description : chemin vers le socket de Headscale.
• headscale_config
  • Par défaut : {}
  • Description : configuration de Headscale au format YAML. Pensez à utiliser la configuration par défaut comme point de départ.
• headscale_config_template
  • Par défaut : ""
  • Description : chemin vers le modèle de configuration de Headscale au format Jinja2. Si présent, remplacera headscale_config.
• headscale_acl
  • Par défaut : {}
  • Description : politiques ACL au format YAML. Assurez-vous d'avoir lu la documentation sur l'utilisation de cette fonctionnalité.
• headscale_users
  • Par défaut : []
  • Description : liste des utilisateurs à créer, par exemple pour les utiliser avec tagOwners.
• headscale_enable_routes
  • Par défaut : []
  • Description : liste des nœuds avec des routes annoncées à activer. Accepte un identifiant entier du nœud Headscale, une liste de routes séparées par des virgules et un commentaire optionnel à afficher lors de l’exécution. Utilisé lorsque les autoApprovers ne sont pas définis.
  • Exemple : {'id': 14, 'routes': '10.0.0.0/24,10.2.3.4/32', 'comment': 'Passerelle vers prod'}
• headscale_exit_nodes
  • Par défaut : []
  • Description : liste des nœuds agissant comme nœud de sortie. Accepte un identifiant entier du nœud Headscale et un commentaire optionnel à afficher lors de l’exécution. Utilisé lorsque les autoApprovers ne sont pas définis.
  • Exemple : {'id': 14, 'comment': 'eu-fra-01'}

Dépendances

Aucune.

Exemple de Playbook

- hosts: all
  roles:
    - kazauwa.headscale
  vars:
    headscale_version: '0.22.3'

Licence

MIT