"Whenever you receive a webhook update, you have two options"
Из Telegram Bot Api Faq
Привет, Хабр!
Долгое время концепция serverless (а если говорить точнее — её реализация в виде сервиса AWS Lambda) была для меня относительно понятной, но очень абстрактной идеей. Она часто звучала в Radio-T, обсуждениях на реддите, но никак не входила в мою жизнь. Рабочие проекты живут не в облаке, а домашние — зачем? Виртуалки дешевеют, Docker освоен, и всё отлично работает.
Но презентация Yandex Cloud Functions, и в особенности озвученные цены на этот сервис, дали новую пищу для размышлений.
TL;DR — дождливым пятничным вечером мы напишем простенького Telegram бота на javascript, который сможет отвечать на запросы простыми сообщениями. Если это ваш домашний проект — его использование почти наверняка обойдётся вам значительно дешевле самых бюджетных VPS.
Поехали.
Что такое Serverless в самом бытовом понимании?
Не буду очень глубоко уходить в дебри, на Хабре регулярно появляются обзорные статьи на эту тему. Это возможность разместить в облаке функцию, на каком-то из поддерживаемых платформой языков программирования, задать условие её срабатывания — и всё. Когда случится триггер — поднимется виртуальное окружение, в нем отработает функция, и выключится. Вместе с окружением.
В чем преимущества такого подхода?
Безопасность
Вы получаете безопасное изолированное окружение с последней версией компилятора / интерпретатора.
Вместо того, чтобы следить за обновлением пакетов на настоящей ОС в Виртуальной машине, заниматься настройкой политик безопасности и файрволла — вы загружаете программу на сервер, и она работает.
Стабильность и отказоустойчивость
Вместо того чтобы конфигурировать pm2, настраивать политику перезагрузок, следить за утечкой памяти и постигать нюансы деплоя — да, вы просто загружаете программу на сервер, а всё остальное берёт на себя провайдер услуги.
Цена, особенно в условиях домашних малонагруженных проектов
При тарификации учитывается объём памяти, резервируемый под функцию за время её исполнения и количество вызовов. Согласно документации 10 000 000 запусков функции, работающей 800ms с ограничением по памяти 512мб будут стоить 3 900₽.
Что это означает для меня? Мой типичный петпроджект — бот отвечающий на вопросы по расписанию для широко известного в узких кругах мероприятия. Запускать его нужно раз в год, на протяжении нескольких дней. В прошлом году он ответил на 1000 запросов от участников, ему более чем хватит 128мб, время выполнения функции 300ms. Такой сценарий использования будет стоить 0.046₽.
Да, 4.6 копеек. Плюс я не буду тратить время на настройки, что ещё приятней. Никаких правил для pm2, никакой актуализации Dockerfile или окружения, и вишенкой на торте — SLA 99,9.
Из пока нерешённых задач (но, полагаю, это вопрос времени) — привязка внешних доменов, а так же тонкая настройка http методов, которые служат триггером функции. Сейчас http триггер срабатывает на любой из DELETE, GET, HEAD, OPTIONS, PATCH, POST или PUT запросов на авто-генерируемую точку входа типа https://functions.yandexcloud.net/xxxxxxxxxxxxxxxx.
Из хороших новостей — это полноценный https, который отвечает всем требованиям Telegram для работы с api через webHooks. Но у AWS Lambda есть дополнения в виде API Gateway, да и сама настройка триггера шире, если вам это нужно.
Очевидное ограничение самого serverless подхода, не зависимо от платформы — пользоваться приходится ровно тем, что дают. Написать код на неподдерживаемых языках программирования или использовать нестандартные параметры компилятора/интерпретатора вы не сможете. Также возможны дополнительные ограничения призванные защитить всех участников процесса разработки.
Как создать .js файл, чтобы работать в Яндекс.Облаке?
Краткий гайд через веб интерфейс:
- создаём Функцию
- создаём в веб интерфейсе файл с любым именем и расширением js
- выбираем интерпретатор — nodejs10 или nodejs12
- в файле пишем функцию с одним параметром в exports.myFunction (ну, в произвольное поле в exports)
- указываем таймаут работы функции, оперативную память (128МБ-1024МБ с шагом в 128МБ), точку входа (имяфайла.myFunction)
- делаем функцию публичной
Функция написанная в файле может:
Получить данные http запроса через входящий параметр:
функция не получает request в чистом виде, и конечно же не управляет ходом запроса — она получает в своём единственном параметре объект с информацией о запросе:
{
"httpMethod": "<название HTTP метода>",
"headers": "<словарь со строковыми значениями HTTP-заголовков>",
"multiValueHeaders": "<словарь со списками значений HTTP-заголовков>",
"queryStringParameters": "<словарь queryString-параметров>",
"multiValueQueryStringParameters": "<словарь списков значений queryString-параметров>",
"requestContext": "<словарь с контекстом запроса>",
"body": "<содержимое запроса>",
"isBase64Encoded": <true или false>
}Ответить на http запрос
согласно документации:
{
"statusCode": <HTTP код ответа>,
"headers": "<словарь со строковыми значениями HTTP-заголовков>",
"multiValueHeaders": "<словарь со списками значений HTTP-заголовков>",
"body": "<содержимое ответа>",
"isBase64Encoded": <true или false>
}Итак, что-нибудь пятничное, бесполезное
Сначала, посмотрим на то что уже написано до нас — реализаций таких ботов для AWS Lambda вагон и маленькая тележка.
У них есть одна проблема — для того чтобы не изобретать велосипед, и обеспечить привычный интерфейс, все эти реализации при получении запроса инициируют post до сервера api telegram. Но можно поступить проще.
Как можно было заметить на КДПВ, и цитате в начале поста — при работе через webHook, telegram слушает ответ на своё update сообщение, чтобы понять, был ли он обработан нашим ботом. Более того, он готов принять сообщение в рамках этого же ответа.
Согласно документации в ответе должна содержаться лишь одна функция (проверил sendMessage и sendPhoto). Для многих проектов этого будет достаточно.
Соблюдём традиции, и передадим привет Хабровчанам:
exports.input = function (data){
let body = JSON.parse(data.body);
let answer = {
"method":"sendMessage",
"chat_id": body.message.chat.id,
"reply_to_message_id" : body.message.message_id,
"text" : "Привет, Habr!"
};
return {
"statusCode": 200,
"headers": {
'Content-Type': 'application/json'
},
"body": JSON.stringify(answer),
"isBase64Encoded": false
}
}Выставим настройки в минимум:
И сообщим в Telegram, что будем использовать webHook:
curl -F "url=https://functions.yandexcloud.net/{secret_function_id}" https://api.telegram.org/bot{secret_bot_key}/setWebhookВсё. Бот работает.
С ним можно пообщаться: @YandexServerlessBot
Подводя итог — в некоторых случаях serverless это крайне дёшево, удобно, и экономит кучу времени, а любую документацию надо читать внимательно: тогда она может приятно удивить.
Если вам стало интересно — добро пожаловать в документацию по Yandex Cloud Functions, там много интересного, от интеграции с другими сервисами облака до дебага, графиков нагрузки и т.д.
Видео с конференции также доступно на YouTube.
UPD: Как показало дальнейшее исследование (спасибо IRT за наводку) — сервера tg доступны и без таких ухищрений, так что можно смело использовать традиционные api запросы.
