Обновление документации продукта#

  1. Соберите статику (Hugo, генератор API-док и т.д.).
  2. Доставьте файлы на сервер хаба в каталог вида data/<slug>/<тип>/ (rsync, CI, копирование).
  3. Caddy начнёт отдавать новые файлы без перезапуска — достаточно обновить содержимое на диске.

Обновление портала#

При изменении products.yml или шаблонов портала выполните пересборку Hugo-проекта в data/portal/:

docker run --rm -v "$(pwd)/data/portal:/src" -w /src peaceiris/hugo:v0.146.4-full --minify

Либо повторно bash scripts/init.sh (он не перезаписывает существующий .env).

Резервное копирование#

Достаточно архивировать каталог data/ и при необходимости тома Caddy с сертификатами (caddy_data), если не хотите перевыпускать доверие к tls internal.

Мониторинг#

Проверяйте состояние контейнера и логи (docker logs easy-docs). Формат логов — JSON построчно на stdout.