HERON
Начать

Одна папка, три пути в сеть

Хранение и публикация

Сайт на HERON — это одна папка с текстовыми файлами. Итоговая сборка превращает её в одно из двух: в обычные файлы для любого хостинга или в образ — весь сайт, упакованный вместе с небольшим веб-сервером и готовый к запуску на любой машине с Docker. Образ можно хранить в GitHub, в Docker Hub или в своём реестре.

Выберите, как хранить и публиковать: сейчас способов три, со временем их станет больше. Сайт при любом способе одинаковый. Разница в том, сколько шагов после первой настройки идёт само и где сайт живёт: на сервере с Docker, на обычном хостинге или на бесплатном хостинге статики.

git pushПравите страницу, делаете commit и push: GitHub Actions собирает сайт, проверяет, что он открывается, и публикует его на сервер или GitHub Pages.Docker HubСоберите сайт в небольшой образ nginx, отправьте его в закрытый репозиторий Docker Hub и запустите на любом сервере с Docker.Статические файлыСоберите папку dist и скопируйте её на обычный хостинг или VPS либо бесплатно на GitHub Pages и Cloudflare Pages. Лимиты и бесплатные контейнеры.

Способы рядом

git pushDocker HubСтатические файлы
Каждое обновлениеПравка, commit, pushСобрать, упаковать, отправить образСобрать и скопировать файлы
Кто собираетGitHub Actions, самВы, на своём компьютереВы, на своём компьютере
Проверка перед выкладкойСама: главная 200, несуществующая страница 404, все переадресацииВы запускаете образ на localhostВы открываете сайт на localhost
Где работает сайтСервер с Docker или GitHub PagesСервер с DockerОбычный хостинг, VPS, GitHub Pages, Cloudflare Pages
Настоящие 301 и 410Да, внутри образаДа, внутри образаС nginx; на другом хостинге из файлов-карт
Обновление сервераОдна команда или HERON Агент (платно)Одна команда или HERON Агент (платно)Вы копируете снова
СтоимостьОт бесплатного (GitHub Pages) до VPSVPS, бесплатный тариф Docker HubОт бесплатного до обычного хостинга
Кому подходитБольшинству сайтов, командам, работе с ИИ-агентамиАгентствам, закрытым проектам, своему рееструПортфолио, первому сайту, хостингу без Docker

Какой выбрать

Где может жить сайт

Выбор хостинга касается каждого пути выше. Сервер с Docker запускает образ, любой хостинг раздаёт статические файлы.

Перед любым из путей

  1. 1

    Укажите домен

    Рабочий домен в site.yaml или в конфигураторе.
  2. 2

    Посмотрите сайт

    heron serve . и откройте localhost:8000. Сайт пересобирается при каждом сохранении.
  3. 3

    Соберите итоговую версию

    heron build . --env prod --strict открывает сайт поисковикам и превращает любое предупреждение в ошибку, поэтому битая ссылка не уходит в сеть.

Вопросы

Можно потом сменить путь?

Да. Папка остаётся той же, меняется только последний шаг. Многие начинают со статики на GitHub Pages и переходят на git push со своим сервером.

Нужен ли свой сервер?

Нет. Статические файлы бесплатно работают на GitHub Pages или Cloudflare Pages, а git push умеет публиковать прямо в GitHub Pages. Сервер нужен для образа с настоящими переадресациями.

Обязателен ли HERON Агент?

Нет. Это платное дополнение, которое избавляет от команды обновления и следит за сервером. Каждый путь на этой странице работает и без него.

Какой путь сохранит позиции при переезде старого сайта?

Любой. Старые адреса перечисляются в redirect_from: у страниц, и HERON пишет настоящие переадресации 301. В образе они работают сразу, на другом хостинге файлы-карты подключаются один раз.