Headscale Installer und Konfiguration

Eine Ansible-Rolle zur Installation und Konfiguration von headscale. Die Inspiration und viele der Konfigurationsoptionen stammen von @kazauwa. Ich bevorzuge jedoch meine Methode für die binäre Installation, also habe ich diesen Teil geändert.

Installieren Sie mit ansible-galaxy install fuzzymistborn.headscale

Funktionen

• Installation und Konfiguration der headscale-Binärdatei.
• Kopieren/Aktualisieren der headscale-Konfigurationsdatei.
• Aktualisierung der Binärdateien, wenn ein Update verfügbar ist und die Version nicht festgelegt ist.

Konfiguration

Diese Rolle verfügt über eine Reihe von Variablen, die konfiguriert werden können.

Zusätzlich können Sie eine bestimmte Version mit headscale_pinned_ver festlegen. Standardmäßig holt die Rolle die neueste verfügbare Version herunter und installiert sie. Es wird der Aktualisierungsbefehl ausgeführt, wenn die Binärdatei bereits vorhanden ist, jedes Mal wenn die Rolle ausgeführt wird. Sie können dies deaktivieren, indem Sie eine spezifische Version festlegen. Hier ist ein Beispiel, wenn Sie die Version festlegen möchten.

headscale_download_latest_ver: false
headscale_pinned_ver: 0.16.1

Wenn Sie eine feste Version festlegen, werden die Aktualisierungsbefehle nicht ausgeführt, und eine Version wird nur heruntergeladen, wenn die installierte Version nicht mit der festgelegten Version übereinstimmt.

Sie können die headscale-Konfiguration im YAML-Format festlegen. Sehen Sie sich die Standardkonfiguration als Ausgangspunkt an.

Die anderen Variablen wie headscale_gh_url, headscale_install_directory usw. empfehle ich nicht zu ändern, es sei denn, Sie möchten die Installation anpassen.

Besuchen Sie die Veröffentlichungsseiten für headscale, um die richtige Distribution für Ihre Installation zu finden.

Github API

Diese Rolle nutzt die GitHub API, um die neueste verfügbare Version zu ermitteln. Standardmäßig nutzt die Rolle nicht authentifizierte Anfragen, die von GitHub auf 60 Anfragen pro Stunde beschränkt werden. Anfragen sind mit der ursprunglichen IP-Adresse verknüpft. Bei den meisten Anwendungsfällen ist dies kein Problem. Allerdings könnten Sie feststellen, dass Sie eine Begrenzung erreichen. Wenn Sie sich authentifizieren, können Sie 5.000 Anfragen pro Stunde stellen.

Um sich zu authentifizieren, müssen Sie einen Personal Access Token erhalten. Der Token benötigt keine ausgewählten Bereiche. Fügen Sie dann die folgenden Variablen hinzu:

github_api_user: fuzzymistborn
github_api_pass: IHR_TOKEN
github_api_auth: ja

Das war's!

Wenn Sie meine Arbeit schätzen, ziehen Sie bitte in Betracht, mir ein Bier (oder Kaffee oder etwas anderes) zu kaufen.