Сборки и деплой

Каждая сборка — это клонирование репозитория, сборка образа и запуск контейнера. История сборок, их логи и откат — во вкладке «Сборки» на странице бота.

Что запускает сборку

  • Кнопка «Собрать и запустить» на странице бота.
  • Push в выбранную ветку на GitHub — если включён автодеплой (см. ниже).
  • Откат к одной из прошлых успешных сборок.
  • «Применить настройки» — пересоздание контейнера из текущего образа без сборки (меняются только переменные окружения, токен, команда запуска).

Одновременно у бота может идти только одна сборка: пока она не закончилась, кнопки покажут «Деплой уже идёт». Удалить бота во время сборки тоже нельзя.

Логи

  • Лог сборки транслируется в реальном времени во вкладке «Сборки»; после завершения он сохраняется. В списке хранятся последние 30 сборок.
  • Журнал бота (то, что бот пишет в консоль) — во вкладке «Логи», тоже в реальном времени. Если бот перезапускается или падает, причина обычно в последних строках журнала.
  • Если бот завершился в первые секунды после запуска, его последние 40 строк попадают в лог сборки, и сборка помечается ошибкой «Бот не запустился».

Откат

У каждой успешной сборки в истории есть кнопка отката: контейнер пересоздаётся из того образа, без новой сборки. На сервере хранятся образы трёх последних успешных сборок; для более старых откат недоступен («Эта сборка уже удалена с сервера — запустите новую сборку»). Папка /app/data при откате не меняется.

Автодеплой по push

  1. На странице бота во вкладке «Параметры» включите автодеплой и скопируйте адрес вебхука (вида https://aibothoster.ru/api/hooks/github/<id>/<секрет>).
  2. В репозитории на GitHub: *Settings → Webhooks → Add webhook*, Payload URL — скопированный адрес, Content type — application/json, событие — *Just the push event*.
  3. GitHub отправит тестовый ping — платформа ответит pong.

Сборка запускается только для push в выбранную ветку; push в другие ветки игнорируется. Если сборка уже идёт, новый push пропускается — запустите сборку вручную после её окончания.

Ветки

Ветка задаётся при добавлении бота и меняется в параметрах. Клонируется только она, с глубиной 1. После смены ветки запустите сборку вручную.

Статусы на табло

СтатусЧто это значит
РаботаетБот запущен и отвечает в Telegram.
СборкаСобираем новую версию, обычно 1–3 минуты. Лог сборки — во вкладке «Сборки».
ПерезапускБот падает и перезапускается. Причина — в последних строках журнала.
ОшибкаСборка не удалась или бот завершился с ошибкой. Откройте лог: в конце написано, что пошло не так.
ОстановленВы остановили бота сами или он остановлен из-за лимита тарифа. Нажмите «Включить».
Не запущенБот добавлен, но ещё ни разу не собирался.

Контейнер бота перезапускается автоматически, если процесс завершился (кроме случая, когда вы остановили бота сами).

Ограничения контейнера

Каждый бот работает в изолированном контейнере с лимитами тарифа: память и CPU на бота, место в /app/data. Контейнер не видит другие боты и сервер, не принимает входящих соединений (поэтому Telegram должен работать через long polling), число процессов ограничено 128.