Роль ansible для weechat

Роль Ansible для установки и настройки weechat.

WeeChat - это расширяемый клиент для чата.

Что может сделать эта роль:

• установить weechat на Debian, Ubuntu, Archlinux или Fedora
• добавить конфигурацию из приватного git репозитория
• автоматический запуск через tmux и systemd

Настройки

 weechat__install: true

• weechat__install: true: Эта роль должна установить weechat. На системах на базе Debian мы добавляем официальный источник apt для weechat и устанавливаем поддержку некоторых плагинов и документацию weechat.
• weechat__install: false: Мы не устанавливаем weechat.

weechat__autostart: false

• weechat__autostart: false: Мы не устанавливаем механизма автоматического запуска.
• weechat__autostart: true: Эта роль устанавливает tmux и создает сервис systemd для запуска weechat внутри сессии tmux от имени пользователя {{ weechat__user }}.

weechat__install_plugins: false

• weechat__install_plugins: false: Мы не устанавливаем никаких плагинов для weechat.
• weechat__install_plugins: true: Мы устанавливаем все официальные плагины, указанные в словаре {{ weecat.plugins }}.

weechat__use_custom_config: false

• weechat__use_custom_config: false: Вы не предоставляете собственную конфигурацию из своего git репозитория.
• weechat__use_custom_config: true: У вас есть собственная конфигурация weechat в репозитории git, и вы хотите ее использовать.

weechat__install_plugins: false

• weechat__install_plugins: false: Мы не устанавливаем никаких официальных плагинов для weechat.
• weechat__install_plugins: true: Мы устанавливаем официальные плагины weechat, определенные в каталоге {{ weechat__plugins: [] }}.

weechat__plugins:
 - go.py
 - iset.pl

• Пример списка weechat__plugins: [].

weechat__user: "{{ ansible_user_id }}"

• Пользователь, с которым будет работать weechat. Это значение используется в задаче autostart, задаче custom_config и в переменной {{ weechat__home_directory }}.

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

• Путь, где находится домашняя директория weechat. Если переменная {{ ansible_env.HOME }} не установлена, будет использоваться "/home/{{ weechat__user }}" как запасной вариант.

weechat__gpg_id: '11E9DE8848F2B65222AA75B8D1820DB22A11534E'

• Это gpg отпечаток из официального репозитория weechat для debian.

weechat__custom_private_repo: false

• Путь к вашему git репозиторию с вашей личной конфигурацией weechat.
• Эта роль клонирует репозиторий в директорию "{{ weechat__home_directory }}/.weechat". (Также известна как ваша локальная директория .weechat.) Она не сработает, если в вашей локальной директории .weechat уже есть файлы и/или папки.
• Вам нужно вручную добавить, зафиксировать и загрузить локальные изменения в вашу локальную папку .weechat. Пожалуйста, учтите, что будет хорошей идеей отключить ведение логов или хотя бы добавить папку weechatlog в ваш файл .gitignore в вашей личной конфигурации weechat.

weechat__custom_gen_ssh_key_pair: true

• weechat__custom_gen_ssh_key_pair: true: Мы создадим пару ключей ssh с эллиптической кривой (если она еще не существует по адресу "{{ weechat__home_directory }}/.ssh/id_ed25519") и выведем публичный ключ на экран. Это даст вам время добавить этот публичный ключ в ваш приватный git репозиторий в качестве ключа для развертывания. Это необходимо для загрузки вашего приватного репозитория без имени пользователя/пароля. Для этого необходимо установить {{ weechat__custom_private_repo }} в ssh доступную версию вашего git репозитория.
• weechat__custom_gen_ssh_key_pair: false: Мы не управляем доступом к git репозиторию с вашей конфигурацией weechat.

weechat__custom_version: main

• weechat__custom_version: main: Установите ветку git, тег, хэш или версию, которую эта роль должна использовать, если вы используете собственный git репозиторий для вашей конфигурации weechat.

Ссылки и вдохновение:

• Информация об установке на debian/ubuntu доступна на weechat.org/download/debian
• Некоторые части конфигурации weechat были вдохновлены github.com/irth/ansible-role-weechat, но написаны совершенно иначе. Некоторые другие совершенно отличаются.
• Автозапуск и systemd вдохновлены ubuntu wiki и документацией ansible.

Требования

Для некоторых частей этой ansible роли требуются коллекции community.general и community.crypto. Вы можете установить их с помощью этой команды:

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

Участие

Если вам не хватает какой-либо функции, вы нашли ошибку или у вас есть вопросы по этой роли, пожалуйста, не стесняйтесь открыть проблему в git. Или, что еще лучше, создайте запрос на изменение.

ЛИЦЕНЗИЯ

Copyright (c) 2019 L3D <[email protected]>

Полный список замечательных участников можно найти здесь.