Платное дополнение · на вашем сервере

HERON Агент

HERON Агент — небольшой сервис на вашем сервере, который держит сайты на HERON в актуальном виде. Он видит каждый новый образ сайта, запускает его рядом с работающим, проверяет и переключает посетителей, а управляете вы им из Telegram.

Это платное дополнение по подписке. Сам HERON, сборка и все способы публикации работают и без него.

Что делает Агент

Обновляет сайты из новых образов

Каждый git push или отправка в Docker Hub создаёт новый образ сайта. Агент замечает его, запускает и выпускает в работу, поэтому заходить на сервер и обновлять сайт руками больше не нужно.

Следит: За реестрами ваших сайтов: GHCR на GitHub или ваш Docker Hub. Новый образ замечает за минуту-две.
Запускает: Новую версию рядом со старой, на том же сервере. Пока новая прогревается, посетители видят старую.
Проверяет: Что главная, 404 и переадресации отвечают как надо — та же проверка, что GitHub делает перед публикацией.
Переключает: Посетителей на новую версию и через минуту удаляет старый контейнер.
Спрашивает или действует: По умолчанию сначала спрашивает в Telegram; выключите вопрос — и обновляет сам.
Без Агента: То же обновление руками — две команды на сервере: docker pull и перезапуск. Образы и Docker Hub

Сам откатывается

Если новая версия не прошла проверку, посетители её не увидят. Неудачный релиз стоит вам сообщения в Telegram, а не сломанного сайта.

Что происходит: Старый контейнер продолжает отдавать сайт, новый останавливается.
Что вы получаете: Сообщение с причиной: какая проверка не прошла и на каком адресе.
Что делаете вы: Исправляете страницу и снова отправляете; Агент так же проверит следующий образ.
Вернуться намеренно: Попросите прошлую версию из Telegram: все образы остаются в реестре.

Присматривает за сервером

Агент следит не только за релизами. Он сообщает о проблеме раньше, чем её заметят посетители.

Доступность: Сайт перестал отвечать или снова работает.
Сертификаты: SSL-сертификат скоро истекает — за несколько дней до срока.
Диск и образы: Старые образы удаляются, и диск не забивается.
Тихие часы: Оповещения можно на время выключить, например на плановые работы.

Много сайтов на одном сервере

Один Агент обслуживает все сайты на сервере, у каждого своя версия HERON и свой образ. На небольшом сервере помещается много небольших сайтов.

Добавить сайт: Укажите его образ и домен — из Telegram или в файле настроек.
Отдельно: Каждый сайт работает в своём контейнере; неудачный релиз одного не задевает другие.
Свои версии: Старый сайт может остаться на своей версии HERON, пока новый использует последнюю.
Один список: Все сайты с состоянием, версией и датой последнего обновления — в одном сообщении Telegram.

Как устроена связка

Три ключа связывают Агента с вашими сайтами и с вами. Они остаются на вашем сервере.

1
Поставьте Агента

Один контейнер Docker на вашем сервере, рядом с сайтами.
2
Создайте ключ бота

Сделайте Telegram-бота через @BotFather и отдайте его ключ Агенту — или подключите наш бот по подписке.
3
Добавьте ключ реестра

Токен только на чтение от GitHub (пакеты) или Docker Hub, чтобы Агент скачивал образы ваших сайтов.
4
Готово

Telegram становится пультом управления: добавляйте сайты, смотрите их состояние, обновляйте или откладывайте.

Свой бот или наш

Свой бот

Вы создаёте бота через @BotFather и храните его ключ на своём сервере.
Ничего не проходит через наши серверы.
Настройка занимает несколько минут и описана по шагам.

Наш бот по подписке

Создавать бота не нужно: Агент подключается к HERON Боту одним кодом.
Обновления и оповещения со всех ваших серверов в одном чате.
Наша поддержка, если что-то пошло не так.

Что вы видите в Telegram

Новая версия

«Готов новый образ для my-site.com. Обновить сейчас или позже?» Обновление можно сделать и полностью автоматическим: отключите вопрос в настройках, а проверка и откат останутся.

Результат

«my-site.com обновлён за 14 с, старый контейнер удалён» или «Обновление остановлено: /contacts/ отвечает 500. Старая версия продолжает работать.»

Оповещения

Сайт упал или снова работает, сертификат истекает через 7 дней.

Команды

Список сайтов, добавить сайт, обновить сейчас, отложить на час, день или неделю.

Безопасность

Ключи остаются на вашем сервере

Ключ бота и ключ реестра Агент хранит у вас на машине и никуда не отправляет.

Доступ только на чтение

Токен реестра только читает образы и не может изменить ваш репозиторий.

Команды только от вас

Агент отвечает только тем аккаунтам Telegram, которые вы разрешили.

Внутрь сайта никто не лезет

Агент меняет контейнеры целиком и никогда не правит файлы внутри работающего сайта.

Вопросы

Нужен ли Агент, чтобы опубликовать сайт?

Нет. Публикация через git, Docker Hub или статические файлы работает без него. Агент избавляет от ручного обновления на сервере.

Сколько стоит?

Агент — платное дополнение по подписке. Цены опубликуем вместе с выпуском.

Что, если у меня нет сервера?

Тогда ту же работу сделает HERON Бот — без вашего сервера.

Может ли он обновлять без вопроса?

Да. Отключите подтверждение в настройках, и новые версии будут выходить сами, с той же проверкой и откатом.

Какие реестры поддерживаются?

GHCR на GitHub и Docker Hub, открытые и закрытые репозитории.