tgindex
a

about aiogram

описание

✏️ Про розробку телеграм ботів з використанням aiogram та інших бібліотек і технологій 🔍 Навігатор (inline mode) - @aiotipbot 🙃 Канал ведуть @Shaonis + @wakaree #aiogram #bots #python

← к каналу@about_aiogram
190
подписчиков
Охват к подписчикам
652,1%
ERR
Реакции к просмотрам
0,46%
141 на 25 постов
Пересылки к просмотрам
1,34%
414
Постов в день
0,0
всего 25

Где отзываются чаще

доля реакций к просмотрам
  • 14 окт. 2024 г.🦾 Local Bot API Server Вихідний код Bot API Server (BAS) є відкритим - telegram-bot-api. Його можна запустити локально та надсилати запити на свій власний сервер замість https://api.telegram.org 🔥 Переваги бота, що працює з локальним BAS • Завантаження файлів будь-якого розміру • Надсилання файлів розміром до 2 ГБ • Можна надсилати файли, використовуючи їхній локальний шлях і схему файлового URI • Дозволяється використовувати HTTP URL для вебхуку • Можна брати будь-які локальні IP та порти для вебхуку • Ліміт max_webhook_connections розширюється до 100_000 (замість 100) • Абсолютний локальний шлях отримується як значення поля file_path без необхідності завантажувати файл після запиту getFile 👉 Локальний BAS може покращити продуктивність ботів за рахунок більш низького пінгу та розширених лімітів ✏️ Загальні концепти 🦾 BAS це - додатковий рівнень абстракції для взаємодії з Telegram API у вигляді акаунта бота. Він є зручною реалізацією RestAPI для розробників і працює як фронт-енд для Telegram API. Зробити свій такий набагато складніше, BAS бере на себе інтерфейси Telegram API та роботу з MTProto. Всі боти взаємодіють з BAS і можуть працювати з ним на одному сервері ☑️ Global Bot API Server - звичайні боти взаємодіють з серверами Telegram через екземпляр telegram-bot-api, що обслуговується офіційно Сам же користувач ніколи не взаємодіє з BAS напряму (тобто користувацький додаток Telegram ніколи не підключається безпосередньо до сервера, на якому запущений BAS). Всі комунікації проходять через сервери Telegram, які внутрішньо пересилають їх двом залученим клієнтам MTProto: • додатку Telegram, що використовує користувач • екземпляру BAS, що працює під капотом ☑️ telegram-bot-api точно такий самий сервер, з яким спілкуються боти на api.telegram.org. Тут немає ніяких додаткових або прибраних шарів. Боти працюватимуть набагато швидше, якщо переключаться на локальний BAS, розташований у відповідному регіоні. Покращити продуктивність також може робота з локальними файлами і більша пропускна здатність для вебхуків 🔌 Використання BAS 1. Генератор інструкцій для збірки серверу 2. Необхідно дістати api_id та api_hash свого аканту телеграм та вказати їх як аргументи (--api-id, --api-hash) чи змінні середовища (TELEGRAM_API_ID, TELEGRAM_API_HASH) 3. Щоб підключені до серверу боти мали розширені ліміти та інші функції, недоступні на https://api.telegram.org, обов'язково додай аргумент --local 4. BAS приймає лише HTTP-запити, тому для обробки HTTPS-запитів потрібно використовувати проксі з термінацією TLS 5. За замовчуванням BAS запускається на порту 8081, який можна змінити аргументом --http-port 📌 Примітки • Мігрувати бота на локальний сервер • Перемістити бота з одного BAS на інший • Всі файли зберігаються на серверах Telegram, а не на BAS. Але можливо, що BAS кешує файли (чи щось подібне) • Є неофіційний Docker образ BAS від розробників aiogram • На api.telegram.org заборонено використовувати адреси webhook тільки для IPv6. Очікується, що вони працюватимуть якщо BAS запущено в --local режимі • getMe не слід використовувати для тестування продуктивності сервера. Сервер негайно відповідає на getMe, не викликаючи жодних інших мережевих запитів 📚 Using a local bot api server 📖 Bot api server general questions1,67%
  • 3 янв. 2025 г.🔍 Inline Mode #цікаве 👉 Інлайн режим - це інтегрована пошукова система для ботів, яка дозволяє зручно скористатися ботом з будь-якого чату знаючи тільки його юзернейм 🤨 І навіщо мені цим користуватись? Інлайн режим дозволяє робити багато речей, що будуть корисні в тій чи іншій ситуації, наприклад можна: • Формувати повідомлення з кнопками • Зробити каталог предметів • Ділитися чимось від імені юзера • Реалізувати пошуковий механізм 👀 Як цим користуватись? 📌 Для початку необхідно увімкнути цей режим для бота. Тому помісти апдейт типу inline_query в дозволені, а далі в @BotFather > /mybots > твій бот > Bot Settings > Inline Mode і натисни Turn On ⬇️ Розберемо всі нові типи і методи, які дає нам інлайн режим • InlineQuery - апдейт, що створюється при використанні пошуку • answerInlineQuery - метод, яким бот показує результати пошуку (ним відповідають на InlineQuery) • InlineQueryResultsButton - об'єкт-кнопка, що знаходиться над результатами • InlineQueryResult - загальний тип конкретного об'єкту в результаті • InputMessageContent - загальний тип конкретного об'єкту для перевантаження надсилання • ChosenInlineResult - апдейт, який доступний з увімкненим inline feedback в @BotFather для аналітики 💭 Це класичний inline mode. Також є додаткові штуки для їх використання в контексті WebApp, але зараз нам вони непотрібні 📌 Цікаві факти • InlineQuery немає даних про тип чату • answerInlineQuery може повертати результати з різними типами об'єктів (одночасно фото, аудіо..) • InlineQueryResult для деяких підтипів має Cached форми, тобто результатом може бути фото, що вже збережене на серверах телеграм • Якщо до повідомлення, яке надісло в інлайн режимі прикріплені кнопки, то при їх використанні бот отримає CallbackQuery без об'єкту Message 🔍 Концепція пошуку У нас є бот з інлайн режимом. У будь-якому чаті (де не заборонене медіа), як тільки ми вводимо в поле тексту його нікнейм, наприклад @bot hello то бот отримує апдейт InlineQuery з даними, в цьому випадку в запиті буде hello. Можна шукати і без слів, тоді запит буде порожнім рядком. Тепер ми змінимо запит на @bot hello world бот отримає новий апдейт з актуальним запитом hello world і поверне список результатів 📌 Якщо писати швидко, телеграм не буде слати боту кожну змінену літеру в запиті, але пишучи з невеликими паузами, ми побачимо як боту поступово приходять оновлені запити ⏳ Про кешування Уявімо, що ти власник бота @gif. Він показує юзеру багато різних гіфок, але їх пошук займає деякий час. Під впливом великої кількості юзерів, бот може працювати не ефективно, бо на той же самий запит йому доведеться повертати одні й ті ж гіфки, хоча він вже відповідав на нього раніше. Для подібних ситуацій в методі answerInlineQuery є два параметра: • cache_time: int - час в секундах, скільки тримати результати запиту в кеші на серверах телеграм (за замовчуванням 5 хв) • is_personal: bool - актуальний, якщо cache_time не дорівнює 0. Корисний, якщо ми хочемо кешувати результати індивідуально для юзера, а не для всіх одразу 📌 У кожного результату має бути унікальний id. Якщо запит закешовано, то бот навіть не отримає апдейт InlineQuery. Раджу кешувати запит "", якщо результати не порожні 🐾 Пагінація результатів Метод answerInlineQuery показує максимум 50 об'єктів. Натомість, є можливість зробити підвантаження додаткових результатів як тільки юзер долистає до кінця поточних. Для цього є параметр next_offset: str. Оскільки він має тип рядок, ми можемо передавати самі собі що завгодно Нехай перший запит від юзера порожній, тож ми повертаємо всі результати що в нас є. Але їх більше ніж 50, тому ми ставимо next_offset="2". Якщо юзер долистає до кінця списку, боту прийде новий апдейт InlineQuery, де параметр offset="2". Таким чином ми знаємо, що треба підвантажити додаткові результати 🪄 Перевантаження надсилання За замовчуванням, при натисканні на результат він надсилається як тип, що його представляє. Наприклад InlineQueryResultPhoto природно надішле фото. Але це можна змінити параметром input_message_content 📚 Читати про це в документації 🍐 Книга Груші, про Inline Mode1,66%
  • 2 апр. 2024 г.✍️ Вебхук із самопідписаним сертифікатом + nginx, FastAPI #цікаве ✅ Це компактна cheatsheet для встановлення бота на вебхук із самопідписаним сертифікатом на свій сервер з nginx та FastAPI 📌 Що таке вебхук і які переваги він дає 📚 Трохи теорії 📝 Самопідписані сертифікати SSL/TLS створюються, видаються та обслуговуються вручну, без центру сертифікації! Це означає, що тобі не треба буде комусь платити за оформлення та обслуговування сертифікату! 👩‍💻 nginx - це швидкий веб-сервер, який може бути зворотнім проксі, балансувальником навантаження і не тільки 👉 FastAPI - це сучасний, високопродуктивний веб-фреймворк для створення API за допомогою Python 3.8+ на основі стандартних підказок типів Python • Самопідписаний сертифікат треба для безоплатного вебхуку • nginx буде отримувати POST запити на вебхук і пересилати їх на обробку до бота (схоже на reverse proxy server, але в цьому пості все на одному сервері) • FastAPI для обробки апдейтів бота вже за допомогою Python ✨ Генерація самопідписаного сертифікату Для створення сертифікату будемо користуватись утилітою OpenSSL openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout ./cert.key -outform PEM -out ./cert.pem • req - підкоманда для сертифікатів • x509 - один із стандартів для сертифікатів • days 365 - час життя сертифікату • newkey rsa:2048 - створити ключ алгоритмом RSA довжиною 2048 біт • outform PEM - необхідний формат генерації PEM • keyout і out - куди покласти ключ і сертифікат 📌 при генерації обов'язково введи IP адресу серверу або домен в поле Common Name 👩‍💻 Робота з nginx Для початку його треба встановити та запустити як сервіс. Приклад для Debian GNU/Linux sudo apt-get update sudo apt-get install nginx sudo nginx -v sudo systemctl enable nginx sudo systemctl status nginx ✨ Налаштуємо конфігурацію nginx • робота із сертифікатом • блокування запитів не від Telegram • пересилання запитів до FastAPI 🫱 Вставляємо в /etc/nginx/nginx.conf (в блок http) server { listen 443 ssl; # For HTTPS server_name YOUR_IP; ssl_certificate /.../certs/cert.pem; ssl_certificate_key /.../certs/cert.key; location / { # Telegram IP ranges allow 149.154.160.0/20; allow 91.108.4.0/22; # Enable local requests allow 127.0.0.1; allow ::1; # Ignore other requests deny all; # Reverse proxy mechanism proxy_pass http://YOUR_IP:BOT_PORT; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } 📌 Заповни YOUR_IP - IP твого сервера, BOT_PORT - порт на якому працює бот (uvicorn наприклад) 📌 Після цього перезапуск sudo systemctl restart nginx 🤝 Знайомимо бота з його вебхуком ‼️ Треба обов'язково запам'ятати, що Telegram вимагає пряме надсилання йому сертифікату як файлу, якщо він самопідписаний 👀 Приклад організаціїї FastAPI в боті. В main .py можна написати app = create_app( bot=bot, dispatcher=dispatcher, ) app.add_event_handler('startup', on_startup) app.add_event_handler('shutdown', on_shutdown) Приклад встановлення вебхуку (в startup наприклад) await bot.set_webhook( getenv('WEBHOOK_URL'), certificate=FSInputFile('.../cert.pem'), secret_token=getenv('WEBHOOK_SECRET'), allowed_updates=list(ALLOWED_UPDATES), ) Ручний варіант встановлення вебхуку curl -F "url=https://ip_address/webhook_path" -F "secret_token=<SECRET>" -F "certificate=@cert.pem" https://api.telegram.org/bot<TOKEN>/setWebhook ‼️ треба бути в директорії з файлом | обов'язково додай @, тобто тут назва сертифікату це cert.pem | secret_token необов'язковий 😉 Корисні команди Перевірити локально, чи працює сертифікат openssl s_client -connect ip_address:443 Переглянути запити до nginx tail -f /var/log/nginx/access.log Переглянути статус вебхуку https://api.telegram.org/bot<TOKEN>/getWebhookInfo 📌 Не забудь покласти сертифікат і ключ в підготовлені для цього місця1,65%
  • 2 сент. 2024 г.🌱 Життєвий цикл апдейту в aiogram 💭 Зазвичай люди, що починають писати ботів намагаються ловити потрібне повідомлення першим робочим способом і не задумуються над тим, які у них є можливості для організації обробки цих повідомлень • Що таке апдейт • Які є способи їх отримання • Поняття реєстрації та обробника • Ланцюг обробників • Роутер і диспетчер - опис, порівняння • Механізм Dependency Injection • Детальний розбір мідлваря • Фільтрація апдейтів • Хендлер ⏫ Всі ці пункти я спробував розписати у максимально доступному форматі з поясненням різних моментів та описом елементарних помилок 🇺🇦 Стаття українською https://botfather.dev/news/zhittyevij-cikl-apdejtu-v-aiogram 🌍 Стаття англійською https://botfather.dev/news/lifecycle-of-an-update-in-aiogram 💫 Мені здається, що представлення цих понять в одній картині спростить написання ботів. Особливо, бачу в цьому сенс для новачків. Крім того, розуміння окремих моментів може бути корисним не тільки для ботів. Приємного читання! ⚡️ Дякую @Latand за його проект та можливість писати там статті1,57%
  • 3 июл. 2024 г.📡 Офіційний безкоштовний вебхук: aiohttp, nginx, домен, Let's Encrypt #цікаве ☑️ Це cheatsheet для встановлення бота на вебхук із сертифікатом від Let's Encrypt на свій сервер + його автооновлення + безкоштовний домен 📌 Перед цим варто прочитати • Що таке вебхук і які переваги він дає • Пост про самопідписаний сертифікат 📚 Трохи теорії 🔒 Let's Encrypt - це безкоштовний, автоматизований і відкритий центр сертифікації, створений некомерційною організацією Internet Security Research Group (ISRG) 🤖 Certbot - це безкоштовна утиліта з відкритим вихідним кодом для автоматичного використання сертифікатів Let's Encrypt 🪩 FreeDNS - середовище, де інші програмісти можуть безкоштовно обмінюватися доменними іменами один з одним. З'явився у 2001 році, тому що його засновник, Джошуа Андерсон, хотів розважитися зі своїм хобі, пов'язаним з доменами 💠 aiohttp - асинхронний HTTP клієнт/сервер для asyncio та Python 📌 Переваги офіційного сертифіката над самопідписаним: • твій сервер визнається всіма (нап. при переході на його адресу в браузері не буде ніяких попереджень про безпеку) • зручне автооновлення • при встановленні вебхуку не треба надсилати файл ⬇️ Загалом: • За допомогою FreeDNS отримуємо безкоштовний домен (для Let's Encrypt необхідно мати домен) • Сертифікат для вебхуку беремо в Let's Encrypt • certbot буде автоматично оновлювати наш сертифікат • nginx буде отримувати POST запити на вебхук і пересилати їх на обробку до бота • aiohttp буде приймати апдейти бота вже за допомогою Python 📌 Для різноманіття цього разу візьмемо aiohttp замість FastAPI, бо він більш легший. Але якщо тобі треба будувати API, то залишити FastAPI буде гарним рішенням ✨ Отримання безкоштовного домену 💭 Такий безкоштовний домен підійде або для тестів або для не дуже великих проектів. Тому, якщо в тебе серйозний проект, краще придбати домен • Зареєструйся на сайті • Перейди в розділ субдоменів і натисни «Add a subdomain» • Переконайся, що в полі «Type» написано А • У полі «Domain» обери бажаний домен (якщо натиснути «Many many more available» -> «Share Domain Registry», то з'явиться більше варіантів) Краще обирати не дуже популярні, пізніше скажу чому. Продовжимо: • в поле «Subdomain» введи назву субдомену (твоя авторська назва), виглядати буде як subdomain.domain • в поле «Destination» введи IP адресу свого серверу • після цього підтверди створення субдомену 🤩 Готово, домен є. Далі йди до свого хостинг провайдера і заяви право на цей домен. Наприклад у MVPS на панелі керування сервером є таблиця, в колонку «rDNS» треба ввести домен (ще стаття є) 📌 Пам'ятай, що необхідно буде почекати декілька хвилин (але іноді годин) поки домен не розійдеться по мережі 📥 Отримання сертифікату Далі зайди на свій сервер і встанови certbot. На офіційному сайті є генератор інструкцій, все що треба це обрати систему і софт В інструкції, команда для отримання сертифікату буде подібною sudo certbot certonly --nginx Треба буде обрати домен під який робимо сертифікат і почекати декілька секунд. Після отримання сертифікату certbot встановить таймер для його автооновлення 📌 Не популярний домен треба брати через те, що в Let's Encrypt є обмеження на частоту оновлення сертифікату і це розповсюджується на субдомени Перевірити оновлення сертифікату без його фактичного встановлення (чи все добре) sudo certbot renew --dry-run 📟 Конфігурація nginx Може виглядати наступним чином server { listen 443 ssl; server_name YOUR_DOMAIN; ssl_certificate /etc/letsencrypt/live/YOUR_DOMAIN/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/YOUR_DOMAIN/privkey.pem; location / { proxy_pass http://SERVER_IP:AIOHHTP_PORT; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } 📌 Замість YOUR_DOMAIN, SERVER_IP, AIOHTTP_PORT підставляй свої дані (якщо бот використовує Docker, то не забудь відкрити порти) 👉 На кінець, приклад використання aiohttp для вебхуку можна глянути тут1,30%
  • 28 нояб. 2023 г.💬 Chat Actions #цікаве Інколи може знадобитися виконати тривалу задачу, наприклад, надіслати файл великого розміру або дочекатися відповіді від API, щоб надіслати респонс користувачу. Щоб під час її виконання бот здавався більш "живим", а не просто наче підвисав у користувача — хорошою ідеєю буде надсилати "дію в чаті". 👀 Що ж це таке? Нам відомо, що коли юзер щось друкує, надсилає фото тощо — ми бачимо відповідний статус під його іменем. Це дає зрозуміти, що співрозмовник не просто проігнорував твоє повідомлення, а збирається відповісти. Так само і з ботом — щоб показати користувачу, що на його стороні щось відбувається, ми використовуєм аналогічний метод sendChatAction. Даний метод буде відображати вказаний розробником статус до п'яти секунд. 🤔 А якщо на виконання задачі мені потрібно більше, ніж п'ять секунд? Це також передбачено фреймворком. Він забезпечує утиліту ChatActionSender. Простий приклад: @router.message(Command("generate_photo")) async def generate_photo(message: Message, bot: Bot) -> Any: async with ChatActionSender.upload_photo(bot=bot, chat_id=message.chat.id): # Do something for a long time to get result result = await generate_photo(...) await message.answer_photo(photo=result) ⚒️ Є також спосіб забезпечити використовування chat action у всіх обробниках. Спочатку потрібно зареєструвати ChatActionMiddleware (що таке мідлварі?) на подію message: <router або dispatcher>.message.middleware(ChatActionMiddleware()) Тепер замість створення ChatActionSender у обробникуgenerate_photo ми можемо повісити мітку на обробник: @router.message(Command("generate_photo")) @flags.chat_action(ChatAction.UPLOAD_PHOTO) async def generate_photo(message: Message) -> Any: # Do something for a long time to get result result = await generate_photo(...) await message.answer_photo(photo=result) За потребою можна змінювати й конфігурацію ChatActionSender, а не тільки тип дії, що надсилаємо: @router.message(Command("generate_photo")) @flags.chat_action(initial_sleep=2, action=ChatAction.UPLOAD_PHOTO, interval=3) async def generate_photo(message: Message) -> Any: # Do something for a long time to get result result = await generate_photo(...) await message.answer_photo(photo=result) 📚 Не полінися завітати в документацію!1,15%
  • 10 янв. 2024 г.🌍 i18n, l10n - мови у боті #цікаве 👉 i18n (internationalization) - процес, який надає можливість використовувати програмам кілька мов. l10n (localization) - більш конкретні дії, спрямовані на використання готових інструментів для роботи з мовами і адаптацію до мовних культур 📌 Обрано саме 18 і 10, бо це просто кількість літер між крайніми буквами (а повні слова всім лінь писати) 😀 І навіщо мені цим користуватись? • багатьом людям приємніше працювати зі своєю рідною мовою, це покращує користувацький досвід • знаючи те, які мови обирають користувачі можна більш точно показувати їм те, що треба саме нам (кому буде приємно бачити рекламу мовою, яку ми не знаємо?) 👀 Як цим користуватись? 1️⃣ Інструменти Почнемо з того, що нам треба працювати саме з ботом. На даний момент є такі інструменти: • вбудований aiogram.utils.i18n (на основі GNU gettext і Babel) • неофіційна aiogram_i18n від активного учасника спільноти Patrick (підтримує GNU gettext, але пріоритет на Project Fluent) Думаю, легше буде почати з aiogram_i18n, та і виглядає вона перспективніше. 📌 GNU gettext був створений у 1995 р, детальніше (багато цікавого загалом). Project Fluent - у 2019, це дослідницький проект Mozilla. Він був створений для вирішення багатьох проблем i18n/l10n, детальніше. 2️⃣ Як працює aiogram_i18n Простими словами її роботу можна описати так: • при отриманні апдейту бібліотека за допомогою менеджера отримує код мови користувача (en, uk) • спеціальний мідлвар користується цим менеджером і за допомогою Dependency Injection передає екземпляр I18nContext як i18n (назву можна змінити) у ланцюг до інших мідлварів, що стоять нижче, фільтрів і нарешті хендлерів • в екземплярі вже визначена мова (локаль) користувача, тому за допомогою I18nContext в хендлері можна діставати відповідні переклади чи змінювати локаль юзера за замовчуванням 3️⃣ Звідки і який менеджер бере локаль Якщо у нас локалі знаходяться в БД, то треба створити менеджер самостійно як підклас aiogram_i18n.managers.base.BaseManager В ньому треба буде реалізувати два методи get_locale і set_locale. Проте необов'язково реалізовувати свій менеджер - у бібліотеці є готові рішення на основі Memory/Redis/FSM. Отже, задача менеджера допомагати мідлвару отримувати локаль тим способом який ми йому «показали» 4️⃣ get_locale і set_locale • Що повинен повертати метод get_locale? » Просто назву коду мови, наприклад "en" чи "de". Ці коди повинні бути назвами директорій з перекладами, про це пізніше. • Для чого set_locale? » Буде логічно, якщо все, що пов'язано з перекладом, буде виконувати I18nContext - в тому числі і зміну локалі юзера Доволі простий приклад: class i18nManager(BaseManager): user_languages = {} async def get_locale(self, event_from_user: User, db: Database) -> str: try: return self.user_languages[event_from_user.id] except KeyError: language = await db.get_user_language(event_from_user.id) self.user_languages[event_from_user.id] = language return language async def set_locale(self, locale: str, event_from_user: User, db: Database) -> None: await db.set_user_language(event_from_user.id, locale) self.user_languages[event_from_user.id] = locale 📌 Зверни увагу, що в set_locale перший позиційний аргумент це locale 5️⃣ Підключення та оформлення • Імпортуємо і реєструємо I18nMiddleware • В аргументах як ядро вказуємо FluentRuntimeCore (pip install fluent.runtime). Я обрав це, бо зараз доступні 3 ядра, чув що FluentCompileCore хочуть прибрати, а GNU gettext є і в build-in • В аргументи мідлвара передаємо потрібний нам менеджер (чи самописний) • Далі вказуємо директорії з перекладами. Їх приклади дивись в репозиторіях. Головне правильный шаблон шляху і розподілені .ftl файли • Про синтаксис .ftl файлів читай тут • Тепер використовуй у хендлерах i18n.get і якщо хочеш роби стаби 📌 LazyProxy - це фільтр, що сам дістає відповідний переклад і порівнює його із вхідним текстом ⭐️ aiogram_i18n1,05%
  • 29 янв. 2024 г.👋 Всім привіт, в останні неділі писав бота. Це як мій пет проект, що буде корисний (на мій погляд) будь-якій активній людині в Telegram Якщо коротко - можна зберігати повідомлення будь-якого типу, кастомізувати, і за допомогою інлайн режиму надсилати їх у будь-які чати. Є пошук, приватність, мови 👉 Ось сам бот @ntosbot 📃 Кому цікаво, які технології юзав: • aiogram • aiogram-dialog • aiogram_i18n • PostgreSQL • psycopg3 • SQLAlchemy • Alembic • Redis • Docker 🔌 Хостинг - https://www.mvps.net/?aff=30539 :D. Поки перша версія, треба тестити, буду радий почути фідбек 💭 Чи було б цікаво почитати про деплой ботів (Docker, SSH keys)?0,99%
  • 4 нояб. 2024 г.👩‍💻 CI/CD з Github Actions 💭 Зараз зробимо CI/CD автоматизацію, яка при кожному оновленні коду в GitHub репозиторії буде переносити зміни на сервер 🛠 Інструменти 🔀 GitHub Actions - CI/CD платформа, що дозволяє автоматизувати твій build-test-deploy pipeline 👩‍💻 Docker - відкрита платформа для розробки, доставки та запуску додатків (розбирали в пості) 📁 Github Container Registry - зберігає image контейнерів в межах організації чи особистого акаунту, а також дозволяє пов'язати image із репозиторієм Сама концепція CI/CD набагато ширша, але в рамках даного посту все спрощено: CI - це build контейнера, CD - його release і deploy • GitHub Actions - в ролі вебхуку на push подію для репозиторію, який буде виконувати наші інструкції • Docker - для побудови образу (але можна і без нього, наприклад запускати бота з systemd) • Github Container Registry - для збереження образів (для приватної видимості, в DockerHub на це сильніші обмеження) ✏️ Пишемо конфігурацію Щоб скористатись GitHub Actions пишуть workflow файли, а вони налаштовані для запуску однієї чи декількох задач • YAML формат файлу • Мають знаходитись в .github/workflows/ • Основна структура: події, змінні середовища та завдання • І workflows і actions можна публікувати та перевикористовувати Давай розберемо готовий приклад name: Deploy to server on: push: branches: [ "main" ] env: REGISTRY: ghcr.io IMAGE_NAME: <your-nick>/<image-name>:latest permissions: contents: read packages: write jobs: publish: name: Publish image runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Login run: | echo ${{ secrets.GITHUB_TOKEN }} | docker login ghcr.io -u ${{ github.actor }} --password-stdin - name: Build and Push run: | docker build . -t ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }} docker push ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }} deploy: needs: publish name: Deploy app runs-on: ubuntu-latest steps: - name: Setup ssh keys run: | install -m 600 -D /dev/null ~/.ssh/id_rsa echo "${{ secrets.SSH_PRIVATE_KEY }}" > ~/.ssh/id_rsa ssh-keyscan -H ${{ secrets.SSH_HOST }} > ~/.ssh/known_hosts - name: Connect-pull-up run: | ssh ${{ secrets.SSH_USER }}@${{ secrets.SSH_HOST }} << EOF echo ${{ secrets.GITHUB_TOKEN }} | docker login ghcr.io -u ${{ github.actor }} --password-stdin cd ${{ secrets.WORK_DIR }} docker compose pull docker compose up -d EOF - name: Cleanup run: rm -rf ~/.ssh • Вказуємо події, при яких він буде працювати workflow (тут це push) 📌 За замовчуванням події будуть застосовані до всіх гілок, тому краще вказати конкретну (наприклад main, тоді dev може бути як чорнетка) • Блок env, як не дивно, служить для вказання змінних середовища 👩‍💻 Ім'я Docker образів мають бути в нижньому реєстрі. Також тут очікується, що в docker-compose.yaml ім'я образу: <registry>/<your-nick>/<image-name> • Блок permission встановлює права для GITHUB_TOKEN (також доступний через контекст github.token). Це спеціальний токен для автентифікації, що створюється для кожної job • Блок jobs містить завдання, сприймай їх як етапи. Також вони можуть мати залежності, наприклад тут deploy чекає поки завершиться publish (needs). За замовчуванням завдання виконуються паралельно! 📌 Кожний job працює на окремій віртуальній машині. GitHub-hosted рішення пропонує один із трьох варіантів: Ubuntu, Mac, Windows • checkout - офіційний action, його можна розуміти як git pull, щоб задача мала доступ до твого коду (використовує GITHUB_TOKEN) 🤫 Тепер про secrets. Їх можна додати в settings репозиторію, щоб використати як змінні середовища 📌 Якщо не хочеш давати GitHub приватний SSH ключ, є ідея посилати серверу запит, щоб він сам завантажив і запустив оновлений Docker образ з регістру 🐱 GitHub Actions | Billing 📁 Publish Docker Images 📝 Workflows syntax0,97%
  • 28 июн. 2024 г.📌 Тепер у каналу є навігатор по контенту - @aiotipbot Щоб використати бота, просто напиши його юзернейм у текстове поле 👉 Він був створений за допомогою @ntosbot, бо тепер він мультибот! Будь-хто може спробувати зробити у ньому своїх ботів, що працюватимуть через Inline Mode. Можливо, це найпростіший конструктор для створення подібних ботів0,89%
  • 11 февр. 2024 г.📥 Деплой ботів та SSH ключі #цікаве 👉 Деплой - процес розгортання веб-сервісу (в нашому випадку бота) в робочому оточенні (хостинг чи власна інфраструктура) 1️⃣ Різні методи та інструменти На даний момент є дуже багато різних технологій для деплою і підтримки (CI/CD) програмного забезпечення. Виділяється з них Docker - дуже зручний інструмент для контейнеризації, він дозволяє один раз зібрати образ (image) і на його основі створювати контейнери - ізольовані (на рівні OC, а не hardware) середовища для роботи сервісів. Є параметри, щоб Docker сам запускав контейнери, якщо сервер перезавантажити, перевіряв їх на працездатність і не тільки. Звичайною практикою буде побачити базу даних в одному контейнері, а основний сервіс в іншому + ще якісь додаткові контейнери - кожен відповідатиме за свою задачу. Базові образи, наприклад Python, PostgreSQL є на DockerHub, тому якщо треба, докер сам їх завантажить для побудови image. Всі технології прив'язані до якоїсь OC, тому їх багато варіантів + різні версії + lite збірки - можна заплутатися. Але якщо треба - розберешся 2️⃣ Використання • Встанови докер та запусти його як сервіс • Напиши Dockerfile - в ньому будуть інструкції для побудови образу • Якщо в боті є додаткові сервіси (такі як бд, редіс і т.д) створи docker-compose.yaml щоб оркеструвати одразу декількома контейнерами (перед цим прочитай про мережі) • Дивись на приклади. Попрактикуйся з написанням образів та конфігів для компоузу, але головне розумій що робить та чи інша команда і коли що слід використовувати • Поцікався багатоетапними збірками (коли образ використовує збудований в цьому ж Dockerfile образ) • Дізнайся як відкривати порти. Це корисно, якщо треба взаємодіяти з сервісами не заходячи в сам контейнер. Наприклад за допомогою SSH тунелю можна локально в редакторі підключатись до БД в контейнері на сервері • Подивись що таке профілі, корисна штука за допомогою якої можна вибірково вказати, які сервіси компоузом не треба запускати, якщо ти цього явно не вкажеш 📌 Збирати образи на сервері є поганою ідеєю, подивитись в сторону Docker Registry 😀 SSH ключі - шлях до безпечної праці з серверами 💭 Базова концепція - є клієнт і сервер. Ціль - безпечно обмінюватись даними. Клієнт генерує пару ключів - приватний і публічний. За допомогою базової аутентифікації паролем клієнт поміщає на сервер публічний ключ. Далі можна спробувати з'єднатися за допомогою утиліти ssh. Також на приватний ключ можна додатково накладати пароль. Приватний ключ ніколи, нікому не даємо. 1️⃣ Створення пари ключів Для цього є різні утиліти. У мене наприклад є ssh-keygen. Команда генерації може виглядати так: ssh-keygen -t rsa -b 2048 -f ~/.ssh/key_name -t алгоритм генерації ключа -b довжина ключів в байтах -f шлях, куди помістити ключі 📌 Чому назва одна, ключів же 2? Справа в тому, що публічний ключ буде мати назву key_name.pub, а от приватний просто key_name 2️⃣ Організація ключів 💭 А якщо у нас буде багато серверів, при тому декілька різних ключів для кожного користувача на сервері, все пхати в .ssh? Для цього в директорії .ssh можна створити файл config. Він допомагає встановити відповідність між ключами та серверами. Наприклад: Host 123.45.67.89 HostName mybot.io User admin1 IdentityFile ~/.ssh/server1/key.pub IdentitiesOnly yes Host myserver HostName 132.89.46.72 User admin2 IdentityFile ~/.ssh/server2/key.pub IdentitiesOnly yes ... І так далі. Кожен блок відповідає за одну пару ключів. • Host - IP серверу чи кастомне ім'я • HostName - домен чи IP серверу • User - аккаунт на сервері • IdentityFile - шлях до публічного ключа • IdentitiesOnly - не пробувати інші ключі 3️⃣ Перенесення ключів 💭 Створили, організували, як перенести їх на сервер? Наприклад за допомогою scp чи ssh-copy-id. Приклад: ssh-copy-id -i ~/.ssh/.../key.pub user@ip_address 📌 Ключі буде перенесено в домашню директорію user! Вводимо пароль і ключі вже на сервері у потрібному місці! 📌 Після встановлення SSH ключів часто прибирають аутентифікацію паролем 👩‍💻 Docker Guide 🔑 SSH keys0,47%
  • 28 мар. 2023 г.🔌 Який хостинг обрати для бота в 2024р? #порада 💭 Я провів невелике опитування серед учасників моєї спільноти та склав рейтинг по згадуванню хостингів на спадання 🥇 AWS - 11 Американські веб сервіси Амазону. Є пробний період. Засновані у 2002р 📡 Регіони - для VPS Огайо, Північна Вірджинія, Орегон, Мумбаї, Сеул, Сінгапур, Сідней, Токіо, Центральна Канада, Франкфурт, Ірландія, Лондон, Париж Стокгольм 💎 Ціна VPS від $3.5 ➖➖➖➖➖➖➖➖➖ 🥈 DigitalOcean - 8 Американська компанія зі штаб квартирою у Нью-Йорку. Заснована у 2011р. Має 15 датацентрів. 📡 Регіони - 9, є Амстердам 💎 Ціна VPS від $4 ➖➖➖➖➖➖➖➖➖ 🥉 MVPS - 7 Компанія Республіки Кіпр. Заснована у 2018р. Має чудову безвідмовну роботу та гарну підтримку 24/7 📡 Регіони - 9 країн, є Нідерланди 💎 Ціна VPS від €4 ➖➖➖➖➖➖➖➖➖ 4️⃣ HETZNER - 6 Німецька компанія. Заснована у 1997р. Hetzner Online один із крупних хостингів і центрів обробки данних у Європі. Має свої датацентри 📡 Регіони - Німеччина, Фінляндія, США 💎 Ціна VPS від €3.8 ➖➖➖➖➖➖➖➖➖ 5️⃣ Oracle Cloud - 5 Американська компанія. Заснована у 2018р. 📡 Регіони - тут 💎 Ціни - тут ➖➖➖➖➖➖➖➖➖ 6️⃣ ZOMRO - 3 Нідерландська (Zomro B.V.) і Латвійська (Podaon SIA) компанія. Заснована у 2014 році в Україні. Має датацентр у Нідерландах 📡 Регіони - Нідерланди 💎 Ціна VPS від €4 ➖➖➖➖➖➖➖➖➖ 7️⃣ VULTR - 3 Американська компанія. Заснована у 2014р 📡 Регіони - 32 штук (в датацентрах) 💎 Ціна VPS - від $2.5 ➖➖➖➖➖➖➖➖➖ 8️⃣ CONTABO - 2 Німецька компанія. Заснована у 2003р Має 10 датацентрів. 📡 Регіони - Німеччина, Об'єднане королівство, США, US, Сінгапур, Сідней 💎 Ціна VPS від €4.5 ➖➖➖➖➖➖➖➖➖ 9️⃣ OVH - 1 Французька компанія. Заснована у 1999р. Найкрупніший європейський хостинг з 2011р. Має 34 датацентри у 8-ми країнах 📡 Регіони - датацентри, для VPS США 💎 Ціна VPS від $4.2 ➖➖➖➖➖➖➖➖➖ 10) Cockbox - 1 Автоматизований анонімний сервіс. Вся оплата в криптовалюті. Ціль - забезпечити конфіденційність клієнтів 📡 Регіони - Молдова, Румунія 💎 Ціна VPS від $10 ➖➖➖➖➖➖➖➖➖ 11) Google Cloud - 1 Платформа хмарних служб від компанії Google. Багато можливостей, є пробний період. Заснована в 2008р. 📡 Регіони - 35+, є Нідерланди 💎 Ціна VPS від ≈ $21 ➖➖➖➖➖➖➖➖➖ 🎚 Всі ціни вказані за 1 місяць 🖥 VPS - приватний сервер який ділить ресурси з іншими юзерами на одному фізичному комп'ютері (на такому можна запустити бота) ⚡️ Особисто я користувався на практиці тільки MVPS і мені дуже подобається. Якщо хочете подякувати, ось реферальне посилання :D (моя винагорода тимчасова і у вас нічого не забирається) 🏅 Дякую всім, хто приймав участь в опитуванні! ⏱ Останнє оновлення 28.02.20240,44%