Полуавтоматика: вы только отправляете

Публикация через git push

Полуавтоматический путь. После одной настройки каждое обновление одинаковое: вы правите страницу, делаете commit и push. GitHub Actions собирает сайт, проверяет, что он открывается, и публикует его. Вы открываете сайт и проверяете правку.

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

Как проходит обновление

1
Правите страницу

Откройте файл страницы в папке вашего языка внутри content/, например services.md, и измените текст. Чтобы добавить страницу, скопируйте готовый файл под новым именем и заполните его. Результат смотрите через heron serve . на localhost:8000.
2
Сохраняете правку в git

Commit — это один сохранённый шаг истории с короткой подписью. Его всегда можно посмотреть или откатить.
3
Отправляете

git push отправляет commit на GitHub. Шаги 2 и 3 — одна строка: git add . && git commit -m "Новые цены" && git push.
4
GitHub собирает

GitHub Actions запускает строгую сборку стабильным образом HERON. Битая ссылка или пустое описание останавливают сборку, а журнал называет файл и строку.
5
GitHub проверяет

Готовый сайт запускается и отвечает на вопросы: главная 200, несуществующая страница 404, каждая переадресация 301 или 410. Сломанный сайт дальше не идёт.
6
GitHub публикует

Образ уходит в реестр, или файлы уходят на GitHub Pages.
7
Сайт обновляется

На GitHub Pages сразу. На вашем сервере одной командой или сам, если стоит HERON Агент.
8
Вы проверяете

Откройте страницу, которую меняли.

Настройка один раз

Пять шагов по порядку. Шаги 2 и 3 сделает конфигуратор, если выбрать GitHub и включить автоматическую сборку.

1. Создайте репозиторий на GitHub

Зарегистрируйтесь на github.com и создайте пустой репозиторий, например my-site. Репозиторий — это папка на GitHub, где хранится ваш сайт и история каждой правки.

Закрытый или открытый: Закрытый прячет черновики. Открытый подходит открытым проектам: тексты сайта видны, токены — никогда.
GitHub Pages на бесплатном тарифе: Работает только с открытыми репозиториями. Для закрытого нужен GitHub Pro или сервер с Docker.
Имя: По нему назовётся образ: ghcr.io/you/my-site.
Пустой — значит пустой: Не ставьте галочки «Add a README» и лицензию: первый push принесёт всё из вашей папки.; Впервые на GitHub? Аккаунт, репозиторий и токен по шагам: git и GitHub.

2. Отправьте папку сайта

Выполните в папке сайта, подставив своё имя на GitHub вместо you. Эти команды заводят историю папки, сохраняют первую версию и отправляют её на GitHub.

git init && git add . && git commit -m "Первая версия" && git branch -M main && git remote add origin https://github.com/you/my-site.git && git push -u origin main

Что уходит: Тексты, картинки, настройки и тема.
Что остаётся: dist/ и кэши — через .gitignore. Токенов в папке сайта нет вообще.
Вход: Первый push спросит логин GitHub; приложение GitHub или gh auth login его запомнят.
Пароль не подходит: GitHub больше не принимает пароль аккаунта в командной строке: нужен токен или вход через gh auth login.
Проверка: Обновите страницу репозитория: там папки content, media, theme и файл site.yaml.

3. Проверьте файл сценария

Файл .github/workflows/image.yml говорит GitHub, что делать при каждом push. Его кладут в сайт heron new и конфигуратор.

name: image
on:
  push:
    branches: [main]
jobs:
  image:
    uses: FMSTM/HERON/.github/workflows/site-image.yml@prod
    permissions:
      contents: read
      packages: write
    with:
      env: prod
      engine: prod

on push в main: Каждый push в основную ветку запускает сборку.
env: prod открывает сайт поисковикам; dev собирает закрытый предпросмотр.
engine: Версия HERON, которая собирает сайт: prod — стабильная.
Токен: Не нужен: GitHub выдаёт сборке собственный короткоживущий токен для публикации образа.
Где лежит: Точка в .github прячет папку в Finder и Проводнике. В VS Code она видна в списке файлов.

4. Посмотрите первую сборку

Откройте вкладку Actions репозитория. Запуск длится несколько минут и состоит из трёх частей. Зелёная галочка — образ готов, красный крестик — сборка остановилась и объясняет почему.

Сборка: Строгая сборка стабильным образом HERON.
Упаковка: dist/ упаковывается в небольшой образ nginx по рецепту той же версии HERON.
Проверка и публикация: GitHub запускает образ и проверяет ответы. В Packages появляется только рабочий образ: ghcr.io/you/my-site:prod.
Красный крестик: Откройте запуск и шаг с крестиком: строка называет файл, номер строки и что исправить. Исправьте, сделайте commit и push ещё раз. Частые ошибки
Открытый или закрытый пакет: Новый пакет закрыт. Чтобы любой сервер скачивал его без пароля, откройте его в Packages → Package settings → Change visibility.

5. Запустите сайт на сервере

Подойдёт любой сервер с Docker. Внутри образа сайт слушает порт 8080; команда ниже выводит его на обычный порт 80 и поднимает после перезагрузки сервера.

docker run -d --name my-site -p 80:8080 --restart unless-stopped ghcr.io/you/my-site:prod

Открытый образ: Любой сервер скачает его без пароля.
Закрытый образ: Создайте токен на GitHub: Settings → Developer settings → Personal access tokens, только с правом чтения пакетов. Один раз войдите на сервере: docker login ghcr.io -u you, токен вместо пароля.
Домен и HTTPS: Направьте запись A домена на сервер и поставьте HTTPS привычным способом: nginx с certbot, Caddy или Traefik.; Нет сервера? Публикуйте на GitHub Pages, ниже.
Каждое следующее обновление: Скачать новый образ и перезапустить контейнер одной строкой: docker pull ghcr.io/you/my-site:prod && docker rm -f my-site && docker run -d --name my-site -p 80:8080 --restart unless-stopped ghcr.io/you/my-site:prod.

Обновить сервер

После каждого push в реестре ждёт новый образ. На сервере его берёт одна команда: скачать, заменить контейнер, запустить.

docker pull ghcr.io/you/my-site:prod && docker rm -f my-site && docker run -d --name my-site -p 80:8080 --restart unless-stopped ghcr.io/you/my-site:prod

Простой

Секунда-две, пока перезапускается контейнер.

Откат

Каждый образ хранит свой тег в реестре; запустите предыдущий той же командой.

Без сервера: git push в GitHub Pages

GitHub умеет публиковать собранные файлы прямо в GitHub Pages. Положите этот сценарий в .github/workflows/pages.yml, затем в настройках репозитория Settings → Pages выберите источником «GitHub Actions».

name: pages
on:
  push:
    branches: [main]
permissions:
  contents: read
  pages: write
  id-token: write
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - run: docker run --rm -v "$PWD":/site -w /site --user $(id -u):$(id -g) ghcr.io/fmstm/heron:prod build . --env prod --strict
      - uses: actions/upload-pages-artifact@v3
        with:
          path: dist
  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
    steps:
      - uses: actions/deploy-pages@v4

fetch-depth: 0

Даёт сборке всю историю, и у каждой страницы появляется настоящая дата правки.

Домен

GitHub Pages со своим доменом

Лимиты

Сайт до 1 ГБ, мягкий лимит 100 ГБ трафика в месяц, на бесплатном тарифе открытые репозитории. Бесплатный хостинг подробно

Бесплатный хостинг подробно

Переадресации

На GitHub Pages нет серверных 301. Если переносите старый сайт с множеством адресов, лучше сервер.

Предпросмотр перед живым сайтом

Добавьте второй сценарий для ветки dev с env: dev. Предпросмотр собирается закрытым от поисковиков, а в main вы сливаете, когда всё выглядит как надо.

name: preview
on:
  push:
    branches: [dev]
jobs:
  image:
    uses: FMSTM/HERON/.github/workflows/site-image.yml@prod
    permissions:
      contents: read
      packages: write
    with:
      env: dev
      engine: prod

Дополнение: HERON Агент

Платно

HERON Агент

Берёт на себя обновление сервера, и push становится всем релизом. Без него всё выше работает; Агент только избавляет от последней команды на сервере.

Что делает: Видит новый образ в реестре, меняет контейнер, проверяет, что сайт открывается, и откатывает, если нет.
Как подключается: Ставите Агента на сервер, генерируете ключ бота, добавляете ключ GitHub — и Telegram становится панелью управления сайтами.
Свой бот или наш: Настройте собственного бота в Telegram или пользуйтесь нашим по подписке.
Ключи остаются у вас: Ключ бота и ключ реестра лежат на вашем сервере, а не у нас.
Несколько сайтов: Один Агент обслуживает все сайты на сервере, у каждого своя версия HERON.
Подробнее: HERON Агент

Вопросы

Нужен ли токен GitHub для сборки?

Нет. GitHub выдаёт сборке собственный короткоживущий токен для публикации образа. Личный токен нужен только серверу, который скачивает закрытый образ.

Что, если сборка упала?

Запуск станет красным, а журнал назовёт файл, строку и что сделать. На сайте ничего не меняется: прежняя версия продолжает работать.

Может ли ИИ-агент делать push за меня?

Да. Codex или Claude Code правят контент в отдельной ветке и открывают pull request; GitHub собирает и проверяет его до слияния. Сайт с Codex

Нужен ли HERON Агент?

Нет. Без него сервер обновляется одной командой, а GitHub Pages обновляется сам. Агент — платное дополнение для тех, кто вообще не хочет заходить на сервер.