Slackyt

English version

1. О приложении
2. Настройка бота
3. Запуск на локальной машине
4. Деплой на удаленный сервер

Для чего это нужно

Приложение позволяет связать обсуждения в слаке с карточкой задачи в ютреке через slack бота.

Пример привязки обсуждения к задаче:

Превращается в

Синтаксис вызова следующий:

{меншн бота} {айди задачи} {опционально: описание обсуждения}

Настройка бота

1. Создайте бота в своем рабочем окружении по ссылке и получите api token слака
2. Получите api токен ютрека, руководство по ссылке
3. Создайте в директории config/ файл secret.exs, внесите в него информацию по примеру в config/secret.example.exs
4. Заведите в карточке ютрека поле Threads, и дайте пользователю права на редактирование поля

Запуск приложения на локальной машине

Из исходников

Требования:

• Elixir 1.12.3 (compiled with Erlang/OTP 24)

Шаги:

1. Установите зависимости через mix deps.get
2. Скомпилируйте зависимости через mix deps.compile
3. Запустите сервер приложения черех mix run --no-halt

Через докер-контейнер

Требования:

• docker
• docker-compose

Шаги:

В текущей директории введите docker-compose up

Деплой на удаленный сервер

Требования:

• Python 3.7

Шаги:

1. Перейдите в директорию ansible

2. Установите python poetry python3 -m pip install poetry

3. Активируйте виртуальное окружение python3 -m poetry shell

4. Установите зависимости poetry install

5. Создайте файл hosts.ini и укажите сервер, на который будет выгружаться приложение в формате пользователь@адрес сервера

6. Создайте файл variables.yml и укажите переменные:

   user: директория пользователя на сервере, bot_dir: директория, куда будет устанавливаться приложение
   

   Примеры для файлов конфигураций находятся в директории ansible: variables.example.yml и hosts.example.ini

7. Запустите выгрузку командой ansible-playbook -i hosts.ini --extra-vars "@variables.yml" deploy.yml

Компиляция на слабых машинах занимает определенное время, наберитесь терпения. На сервере при компиляции требуется как минимум 2 гигабайта оперативной памяти, при необходимости создайте swap файл