Публикация из ветки
Info
Этот раздел описывает встроенный механизм автоматической сборки и публикации GitVerse Pages при использовании источника «Ветка».
Автоматическая публикация используется, когда GitVerse Pages настроен на публикацию содержимого репозитория напрямую из выбранной ветки и папки, без использования пользовательских workflow. В этом режиме применяется встроенный процесс сборки на основе Jekyll. Процесс сборки выполняется автоматически при каждом коммите в выбранную ветку.
Процесс автоматической сборки
Встроенная сборка выполняется в несколько этапов:
- Проверка структуры проекта и наличия входных файлов.
- Подключение пользовательских версий
Gemfile,_config.yml,_layouts, если они присутствуют в репозитории.
Если файлы отсутствуют, GitVerse Pages автоматически подставляет стандартные версии из официального репозитория сборщика
jekyll-build-pages. Это позволяет начать публикацию без дополнительной конфигурации.
- Запуск Jekyll со следующими параметрами:
JEKYLL_ENV=production(по умолчанию);- включен режим относительных путей (абсолютные пути не поддерживаются);
- используются только плагины, поддерживаемые GitVerse Pages.
- Генерация статического каталога
_site. - Публикация результата в объектное хранилище (S3).
- Раздача контента через CDN и Nginx.
Каждый этап сборки логируется. Если сборка завершилась ошибкой, вы можете посмотреть логи в разделе CI/CD.
Автоматически создаваемые файлы
В рамках встроенной автоматической сборки GitVerse Pages может создать следующие файлы, если они отсутствуют в репозитории:
| Файл | Условие создания | Назначение |
|---|---|---|
Gemfile | при отсутствии | Подключение Jekyll и поддерживаемых плагинов |
_config.yml | при отсутствии | Базовая конфигурация сайта, включая относительные пути |
_layouts/default.html | при отсутствии | Основной макет (layout) страниц при генерации Jekyll |
Пользовательские файлы всегда имеют приоритет над автоматически создаваемыми. Если вы хотите изменить поведение сборки, добавьте собственные версии этих файлов в репозиторий.
Если требуется изменить конфигурацию сборки или использовать собственную тему, достаточно добавить соответствующие файлы в репозиторий. GitVerse Pages будет использовать их вместо стандартных.
Пример простого блога на Jekyll приведен в разделе практические руководства.
Ограничения автоматической публикации
При использовании встроенной автоматической сборки следует учитывать, что:
- публикуются только статические файлы (HTML, CSS и JavaScript);
- все пути к стилям и скриптам должны быть относительными (через
./); - темы Jekyll необходимо подключать самостоятельно.
Автоматическая сборка не поддерживает выполнение серверного кода. Если вашему проекту нужен бэкенд, рассмотрите использование кастомного CI/CD workflow.