ansible weechat Rolle

Ansible Rolle zur Installation und Konfiguration von weechat.

WeeChat, der erweiterbare Chat-Client.

Was kann diese Rolle:

• weechat auf Debian, Ubuntu, Archlinux oder Fedora installieren
• Konfiguration aus einem privaten Git-Repo hinzufügen
• Automatischer Start über tmux und systemd

Einstellungen

 weechat__install: true

• weechat__install: true: Diese Rolle sollte weechat installieren. Auf Debian-basierten Betriebssystemen fügen wir die offizielle weechat apt-Quelle hinzu und installieren einige Plugin-Unterstützungen sowie weechat-doc.
• weechat__install: false: Wir installieren weechat nicht.

weechat__autostart: false

• weechat__autostart: false: Wir installieren keinen Automatisierungsmechanismus.
• weechat__autostart: true: Diese Rolle installiert tmux und erstellt einen systemd-Dienst, um weechat in einer tmux-Sitzung als Benutzer {{ weechat__user }} zu starten.

weechat__install_plugins: false

• weechat__install_plugins: false: Wir installieren keine weechat-Plugins.
• weechat__install_plugins: true: Wir installieren alle offiziellen Plugins, die im {{ weecat.plugins }} Dictionary angegeben sind.

weechat__use_custom_config: false

• weechat__use_custom_config: false: Sie stellen keine benutzerdefinierte Konfiguration aus Ihrem eigenen Git-Repository zur Verfügung.
• weechat__use_custom_config: true: Sie haben Ihre weechat-Konfiguration in einem eigenen Git-Repository und möchten sie verwenden.

weechat__install_plugins: false

• weechat__install_plugins: false: Wir installieren keine offiziellen weechat-Plugins.
• weechat__install_plugins: true: Wir installieren die offiziellen weechat-Plugins, die im {{ weechat__plugins: [] }} Verzeichnis definiert sind.

weechat__plugins:
 - go.py
 - iset.pl

• Beispiel weechat__plugins: [] Liste

weechat__user: "{{ ansible_user_id }}"

• Der Benutzer, der weechat verwenden soll. Dieser Wert wird in der Aufgabe autostart, der Aufgabe custom_config und der Variablen {{ weechat__home_directory }} verwendet.

weechat__home_directory: "{{ ansible_env.HOME | default('/home/{{ weechat__user }}') }}"

• Der Pfad, wo das weechat Home-Verzeichnis liegt. Wenn die Variable {{ ansible_env.HOME }} nicht gesetzt ist, wird als Fallback "/home/{{ weechat__user }}" verwendet.

weechat__gpg_id: '11E9DE8848F2B65222AA75B8D1820DB22A11534E'

• Dies ist der GPG-Fingerabdruck aus dem offiziellen weechat debian repo.

weechat__custom_private_repo: false

• Der Pfad zu Ihrem Git-Repo mit Ihrer persönlichen weechat-Konfiguration.
• Diese Rolle klont das Repo in das Verzeichnis "{{ weechat__home_directory }}/.weechat". (Auch bekannt als Ihr lokales .weechat-Verzeichnis.) Es wird fehlschlagen, wenn Sie bereits Dateien und/oder Ordner in Ihrem lokalen .weechat-Verzeichnis haben.
• Sie müssen die lokalen Änderungen in Ihrem lokalen .weechat-Ordner manuell hinzufügen, committen und pushen. Bitte beachten Sie, dass es eine gute Idee ist, Ihr Protokoll zu deaktivieren oder zumindest den weechatlog-Ordner zu Ihrer .gitignore-Datei in Ihrer persönlichen weechat-Konfiguration hinzuzufügen.

weechat__custom_gen_ssh_key_pair: true

• weechat__custom_gen_ssh_key_pair: true: Wir generieren einen elliptischen Kurven-SSH-Schlüssel (wenn er nicht bereits unter "{{ weechat__home_directory }}/.ssh/id_ed25519" existiert) und drucken den öffentlichen Schlüssel in der Eingabeaufforderung. Dies gibt Ihnen die Zeit, diesen öffentlichen Schlüssel als Berechtigungsschlüssel zu Ihrem privaten Git-Repo für Ihre eigene weechat-Konfiguration hinzuzufügen. Dies ist erforderlich, um Ihr privates Repo ohne Benutzername/Passwort herunterzuladen. Dies erfordert, dass Sie {{ weechat__custom_private_repo }} auf die SSH-zugängliche Version Ihres Git-Repos setzen.
• weechat__custom_gen_ssh_key_pair: false: Wir verwalten den Zugriff auf das Git-Repo mit Ihrer weechat-Konfiguration nicht.

weechat__custom_version: main

• weechat__custom_version: main: Legt den Git-Zweig, das Tag, den Hash oder die Version fest, die diese Rolle verwenden soll, wenn Sie ein benutzerdefiniertes Git-Repo für Ihre weechat-Konfiguration verwenden.

Referenzen und Inspiration:

• Informationen zur Installation auf Debian/Ubuntu finden Sie unter weechat.org/download/debian
• Einige Teile der Weechat-Konfiguration sind inspiriert von github.com/irth/ansible-role-weechat, aber in einer ganz anderen Weise geschrieben. Einige andere sind völlig anders.
• Automatischer Start und systemd sind inspiriert von ubuntu wiki und ansible docs.

Anforderungen

Die Sammlungen community.general und community.crypto sind für einige Teile dieser Ansible-Rolle erforderlich. Sie können es mit diesem Befehl installieren:

ansible-galaxy collection install -r requirements.yml --upgrade

Beiträge

Wenn Ihnen eine Funktion fehlt, Sie einen Fehler gefunden haben oder Fragen zu dieser Rolle haben, können Sie gerne ein Git-Issue eröffnen. Oder - noch besser - erstellen Sie einen Pull-Request.

LICENSE

Copyright (c) 2019 L3D <l3d@c3woc.de>

Die vollständige Liste der großartigen Mitwirkenden finden Sie hier.