Ansible-Rolle für Headscale

Eine Rolle, die Headscale auf Linux installiert und verwaltet.

Anforderungen

• Ansible >= 7

Installation

ansible-galaxy install kazauwa.headscale

Rollenvariablen

• headscale_version
  • Standard: 0.22.3
  • Beschreibung: Version von Headscale, die installiert werden soll. Eine Liste der verfügbaren Versionen finden Sie auf der offiziellen Veröffentlichungsseite. Standardmäßig wird die neueste verfügbare Version verwendet.
• headscale_arch
  • Standard: amd64
  • Beschreibung: Zielarchitektur für die Headscale-Binärdatei.
• headscale_os
  • Standard: linux
  • Beschreibung: Zielbetriebssystem für die Headscale-Binärdatei.
• headscale_user_name
  • Standard: headscale
  • Beschreibung: Name für den Dienstbenutzer, der die Headscale-Binärdatei ausführt.
• headscale_user_group
  • Standard: headscale
  • Beschreibung: Gruppe für den Dienstbenutzer, der die Headscale-Binärdatei ausführt.
• headscale_user_uid
  • Standard: 800
  • Beschreibung: UID für den Dienstbenutzer, der die Headscale-Binärdatei ausführt.
• headscale_user_gid
  • Standard: 800
  • Beschreibung: GID für den Dienstbenutzer, der die Headscale-Binärdatei ausführt.
• headscale_binary_path
  • Standard: /usr/local/bin/headscale
  • Beschreibung: Pfad zur Installation der Headscale-Binärdatei.
• headscale_config_dir
  • Standard: /etc/headscale
  • Beschreibung: Pfad zu den Headscale-Konfigurationen.
• headscale_var_data_dir
  • Standard: /var/lib/headscale
  • Beschreibung: Pfad zu den Headscale-Daten.
• headscale_pid_dir
  • Standard: /var/run/headscale
  • Beschreibung: Pfad zum Headscale-Socket.
• headscale_config
  • Standard: {}
  • Beschreibung: YAML-formatiertes Headscale-Setup. Ziehen Sie in Betracht, die Standardkonfiguration als Ausgangspunkt zu verwenden.
• headscale_config_template
  • Standard: ""
  • Beschreibung: Pfad zur Jinja2-formatierten Headscale-Konfigurationsvorlage. Wenn vorhanden, wird headscale_config überschrieben.
• headscale_acl
  • Standard: {}
  • Beschreibung: YAML-formatiertes ACL-Politiken. Stellen Sie sicher, dass Sie die Dokumentation gelesen haben, um zu verstehen, wie Sie diese Funktion nutzen.
• headscale_users
  • Standard: []
  • Beschreibung: Liste der zu erstellenden Benutzer, z. B. für die Verwendung mit Tag-Eigentümern.
• headscale_enable_routes
  • Standard: []
  • Beschreibung: Liste der Knoten mit beworbenen Routen, die aktiviert werden sollen. Akzeptiert eine ganzzahlige ID des Headscale-Knotens, eine Liste von durch Kommas getrennten Routen und einen optionalen Kommentar, der während der Ausführung ausgegeben wird. Wird verwendet, wenn keine autoApprovers festgelegt sind.
  • Beispiel: {'id': 14, 'routes': '10.0.0.0/24,10.2.3.4/32', 'comment': 'Gateway zu Prod'}
• headscale_exit_nodes
  • Standard: []
  • Beschreibung: Liste der Knoten, die als Exit-Knoten fungieren. Akzeptiert eine ganzzahlige ID des Headscale-Knotens und einen optionalen Kommentar, der während der Ausführung ausgegeben wird. Wird verwendet, wenn keine autoApprovers festgelegt sind.
  • Beispiel: {'id': 14, 'comment': 'eu-fra-01'}

Abhängigkeiten

Keine.

Beispiel-Playbook

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

Lizenz

MIT