Rôle Ansible WeeChat

========================== Rôle Ansible pour installer et configurer WeeChat.

WeeChat, le client de chat extensible.

Que peut faire ce rôle :

• Installer WeeChat sur Debian, Ubuntu, Archlinux ou Fedora
• Ajouter une configuration depuis un dépôt git privé
• Démarrer automatiquement via tmux et systemd

Paramètres

 weechat__install: true

• weechat__install: true : Ce rôle doit installer WeeChat. Sur les systèmes basés sur Debian, nous ajoutons la source apt officielle de WeeChat et installons certains supports de plugins et la documentation de WeeChat.
• weechat__install: false : Nous n'installons pas WeeChat.

weechat__autostart: false

• weechat__autostart: false : Nous n'installons pas de mécanisme de démarrage automatique.
• weechat__autostart: true : Ce rôle installe tmux et crée un service systemd pour lancer WeeChat dans une session tmux en tant qu'utilisateur {{ weechat__user }}.

weechat__install_plugins: false

• weechat__install_plugins: false : Nous n'installons pas de plugins WeeChat.
• weechat__install_plugins: true : Nous installons tous les plugins officiels spécifiés dans le dictionnaire {{ weecat.plugins }}.

weechat__use_custom_config: false

• weechat__use_custom_config: false : Vous ne fournissez pas de configuration personnalisée depuis votre propre dépôt git.
• weechat__use_custom_config: true : Vous avez votre configuration WeeChat dans un dépôt git personnel et vous souhaitez l'utiliser.

weechat__install_plugins: false

• weechat__install_plugins: false : Nous n'installons pas de plugins WeeChat officiels.
• weechat__install_plugins: true : Nous installons les plugins WeeChat officiels définis dans le répertoire {{ weechat__plugins: [] }}.

weechat__plugins:
 - go.py
 - iset.pl

• Exemple de liste weechat__plugins: [].

weechat__user: "{{ ansible_user_id }}"

• L'utilisateur avec lequel utiliser WeeChat. Cette valeur est utilisée dans la tâche autostart, la tâche custom_config et la variable {{ weechat__home_directory }}.

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

• Le chemin où se trouve le dossier personnel de WeeChat. Si la variable {{ ansible_env.HOME }} n'est pas définie, cela utilisera "/home/{{ weechat__user }}" comme solution de repli.

weechat__gpg_id: '11E9DE8848F2B65222AA75B8D1820DB22A11534E'

• Ceci est l'empreinte gpg du dépôt Debian officiel de WeeChat.

weechat__custom_private_repo: false

• Le chemin de votre dépôt git avec votre configuration personnelle de WeeChat.
• Ce rôle clone le dépôt dans le répertoire "{{ weechat__home_directory }}/.weechat". (Également connu comme votre répertoire local .weechat.) Cela échouera si vous avez déjà des fichiers et/ou des dossiers dans votre répertoire local .weechat.
• Vous devez ajouter, valider et pousser les changements locaux dans votre dossier .weechat manuellement. Veuillez noter qu'il est conseillé de désactiver vos logs ou au moins d'ajouter le dossier weechatlog à votre fichier .gitignore dans votre configuration personnelle de WeeChat.

weechat__custom_gen_ssh_key_pair: true

• weechat__custom_gen_ssh_key_pair: true : Nous allons générer une clé ssh à courbe elliptique (si elle n'existe pas déjà à "{{ weechat__home_directory }}/.ssh/id_ed25519") et imprimer la clé publique sur l'invite. Cela vous donnera le temps d'ajouter cette clé publique à votre dépôt git privé pour votre configuration de WeeChat en tant que clé de déploiement. Cela est nécessaire pour télécharger votre dépôt privé sans nom d'utilisateur/mot de passe. Cela nécessite que vous définissiez {{ weechat__custom_private_repo }} à la version accessible par ssh de votre dépôt git.
• weechat__custom_gen_ssh_key_pair: false : Nous ne gérons pas l'accès au dépôt git avec votre configuration de WeeChat.

weechat__custom_version: main

• weechat__custom_version: main : définir la branche git, le tag, le hash ou la version que ce rôle doit utiliser si vous utilisez un dépôt git personnalisé pour votre configuration WeeChat.

Références et Inspirations :

• Des informations sur l'installation sur Debian/Ubuntu peuvent être trouvées sur weechat.org/download/debian
• Certaines parties de la configuration de WeeChat sont inspirées par github.com/irth/ansible-role-weechat mais rédigées d'une manière complètement différente. D'autres parties sont complètement différentes.
• Le démarrage automatique et systemd sont inspirés par ubuntu wiki et documentation ansible.

Exigences

Les collections community.general et community.crypto sont requises pour certaines parties de ce rôle Ansible. Vous pouvez les installer avec cette commande :

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

Contribuer

Si vous manquez une fonctionnalité, avez trouvé un bug ou avez des questions sur ce rôle, n'hésitez pas à ouvrir une issue sur git. Ou - encore mieux - créez une demande de tirage.

LICENSE

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

La liste complète des contributeurs peut être trouvée ici.