Здравствуйте как и обещал в продолжение моей статьи о Автоматической публикации приложения в Google Play , рассмотрю в деталях процесс написания Telegram Bot`a для оповещения команды тестировщиков о выпуске новой версии.
Регистрация Bota в Telegram и получение ID
Просто напишите пользователю @BotFather и следуйте его инструкциям.
Выполните последовательно следующий команды
/start
/newbot
bot_nameВ итоге вы должны получить сообщение
Из этого сообщение нам понадобятся собственно
- t.me/bot_name — Имя бота по которому мы будем добавлять его в каналы или писать в ЛС
- token — это наш ключ для доступа к API
Подготовка проекта и подключение необходимых библиотек
Наш бот будет написан на Java и будет представлять из себя Spring Boot Web приложение, в качестве системы сборки будет использоваться maven
1) Создайте обычный Spring Boot проект, проще всего это сделать через встроенный конфигуратор в IntelliJ IDEA , либо используя Spring Initializr.
Выберите те зависимости которые посчитаете нужными, но для начала нам подойдёт минимальный набор
pom.xml
Минимальный проект будет иметь примерно такую структуру :
А теперь детальней по каждому классу :
BotConfig — Конфигурация подтягивающая настройки бота из application.properties
BotInitializer — Component регистрации/инициализации бота в системе Telegram
Телеграм API должно быть зарегистрировано в системе и делать это нужно уже после поднятия контекста Spring, по этому вешаем слушатель на ContextRefreshedEvent
Bot — Сервис инкапсулирующий в себе реализацию TelegramLongPollingBot,
Данный класс представляет из себя основной функционал для взаимодействия с Telegram
- метод onUpdateReceived принимает и обрабатывает сообщения пришедшие в личку или в канал где бот администратор
WebHook — RestController обслуживающий API для реакции на события WebHook Gitea
Данный RestController обслуживает RestAPI с точкой входа http://you_ip:port/api/public/gitea/webhook , сюда наша система контроля версий Gitea будет делать PUSH запрос с JSON данными WebHook возникающего при различных событиях происходящих с вашим репозитарием.
TelegramBotGiteaApplication — Стартовый метод нашего Spring Boot проекта
Все те классы что вы наблюдаете в пакете Model , представляют сгенерированную модель GiteaWebHook по JSON-Schema взятому из оф документации по GiteaWebHookApi , удобнее всего это делать при помощи http://www.jsonschema2pojo.org/
Полный исходный код вы можете взять ЗДЕСЬ
Настройка Gitea для выполнения WebHook к нашему боту
Данная статья рассматривает вариант обслуживания API предоставляемое системой контроля версий Gitea но это не значит что вы не сможете сделать оповещение и без неё. Проявив некую долю усердия всё те-же WebHook можно реализовать через .git\hooks\post-update и curl , или некое API GitHub но эти реализации я доверяю вам, и здесь мы рассмотрим лишь вариант с Gitea:
- Итак, перейдите в репозитарий вашего проекта и войдите в его Настройки в раздел Автоматическое обновление . Нажмите на кнопку Добавить Webhook , выберете вариант Gitea
- В качестве URL обработчика укажите URL на котором у нас висит RestController http://you_ip:port/api/public/gitea/webhook
- Тип содержимого — application/json
- Секретный ключ — любой набор символов который мы в последующем внесём в наш application.properties
- На какие события этот webhook должен срабатывать? — выберите PUSH
- Галочку Активности оставьте включённой.
Всё это хорошо бот написан, Gitea настроена но нашему боту нужно где-то жить.
Публикация нашего бота в Google Cloud Platform, бесплатно
New customers get $300 in free credits to spend on Google Cloud. All customers get free usage of 20+ products. See offer details.
Такое сообщение мы видим на главной страницы этого сервиса, а именно они дают 300$ бесплатно на год для функционирования нашего приложения у них в облаке, и нам этого вполне себе хватит.
И так приступим, авторизуйтесь в Google Cloud Platform
1) В боковом меню перейдите в раздел Сompute Engine, и дождитесь его инициализации
2) В разделе Экземпляры ВМ, нажмите создать
Выберете конфигурацию инстанса к примеру вот такую, это будет оптимальным решением для нашего не требовательного приложения
Давайте зададим сразу правило Брандмауэра разрешающего трафик по порту 8080
Зайдите Cеть VPS — Брандмауэр
Создайте правило для порта 8080 по аналогии с 80 портом
Подключитесь к VM через SSH , непосредственно через браузер
Теперь мы может перейти к настройке нашей виртуальной машины
Для обновления информации об новейших версиях пакетов вводим
sudo apt updateУстановим Java
sudo apt install default-jdkПроверьте это выполнив
java - versionЕсли всё прошло хорошо вы должны наблюдать версию Java в консоли SSH
Теперь установим maven
sudo apt install mavenСделаем clone репозитария с нашим ботом заготовкой
git clone https://github.com/leganas/TelegramBotGiteaLesson.gitСделайте необходимые манипуляции по настройке appliation.properties , укажите валидный bot_name и token
nano ./TelegramBotGiteaLesson/src/main/resources/application.propertiesЗайдём в папку с нашим ботом и соберём его при помощи maven
cd TelegramBotGiteaLesson/
mvn packageПосле того как maven соберёт наш проект
Бот полностью готов к запуску, выполните команду
java -jar ./target/telegrambotgitea-0.0.1-SNAPSHOT.jarИспользуя внешний IP указанный в web консоли управления виртуальными машинами, проверьте его работоспособность открыв в браузере страницу http://YOU_IP:8080/
Если наш бот успешно подключился к Telegram мы можем написать ему проверочное сообщение в ЛС /hello , на что он должен ответить нам Привет
И так теперь у нас всё готово для того что бы добавить нашего бота в Telegram канал, дать ему права администратора (что бы он мог читать сообщения) и протестировать оповещение !
Добавил бота в канал и дав ему права , вы можете написать
/chartId
Теперь это ID можно добавить в application.properties и либо пересобрать проект , либо подкинуть этот файл рядом с jar. Внесите необходимые правки IP адреса в WebHook в настройках Gitea и опробуйте вашего бота.
У кого получилось вот так , тот молодец, о том как сделать jar сервисом писать уже не буду, уж очень много про это написано на хабре, а если не найдёте пишите в личку.
Надеюсь моё повествование было достаточно подробным, чтобы любой смог запустить свою зверушку.