Гайд

Архитектура сайта на Konso CMS: от управления контентом до публикации

Попробовать бесплатно arrow_forward

Как связать Headless CMS, Git, автоматическую сборку и CDN в единую систему управления сайтом.

Konso CMS позволяет отделить управление контентом от разработки и публикации сайта. Такой подход даёт больше свободы в выборе технологий, упрощает обновление материалов и позволяет создавать быстрые сайты без необходимости обращаться к разработчику при каждом изменении текста или изображения.

В этой статье рассмотрим один из возможных вариантов архитектуры сайта на базе Konso CMS, Git, CI/CD и CDN. Он подходит для корпоративных сайтов, блогов, документации, лендингов и других проектов, где важны скорость загрузки, безопасность и удобство управления контентом.

1. Общая схема архитектуры

В основе архитектуры лежит разделение системы на несколько независимых компонентов:

  • Konso CMS — хранение, редактирование и управление контентом.
  • Git-репозиторий — исходный код сайта, шаблоны страниц и конфигурация.
  • CI/CD — автоматическая или ручная сборка сайта.
  • Frontend — пользовательский интерфейс, реализованный на выбранном фреймворке.
  • Konso CDN — доставка статических ресурсов посетителям сайта.

Главная идея проста: контент живёт в CMS, код — в Git, а посетители получают готовый сайт.

Разработчики отвечают за структуру и внешний вид страниц, редакторы — за их содержимое, а процесс сборки объединяет эти части в готовый результат.

Это один из возможных способов использования Konso. Платформа не требует именно такой архитектуры: в зависимости от проекта можно использовать другие инструменты сборки, хостинг или способы доставки контента.

Диаграмма как устроен сайт на Konso CMS

2. Konso CMS — единый центр управления контентом

Konso CMS выступает центральным компонентом системы, в котором создаются и хранятся материалы сайта.

Это могут быть тексты страниц, статьи блога, изображения, SEO-метаданные, информация о продуктах, категориях или любые другие структурированные данные.

Например, редактор корпоративного сайта может самостоятельно:

  • Изменить заголовок или описание услуги.
  • Опубликовать новую статью.
  • Обновить изображения и ссылки.
  • Подготовить контент на нескольких языках.
  • Изменить SEO-заголовки и описания страниц.

При этом редактору не требуется доступ к исходному коду или системе сборки.

Как контент попадает на сайт?

Konso предоставляет API для получения данных. Во время сборки frontend-приложение запрашивает необходимые материалы через API или GraphQL и использует их для формирования страниц.

Таким образом, CMS отвечает за содержимое, но не диктует, как именно должен выглядеть сайт.

Это одно из ключевых преимуществ Headless CMS: один и тот же контент можно использовать в разных интерфейсах и приложениях.

3. Git — хранение кода и истории изменений

Исходный код сайта размещается в Git-репозитории, например GitHub или GitLab.

В репозитории обычно находятся:

  • Компоненты и шаблоны страниц.
  • Стили и элементы дизайна.
  • Логика получения данных из Konso CMS.
  • Настройки сборки и публикации.

Git позволяет разработчикам работать над сайтом независимо от редакторов контента, отслеживать изменения, создавать отдельные ветки и возвращаться к предыдущим версиям кода.

Важно: в этой архитектуре Git не используется как основное хранилище контента. Тексты и другие материалы остаются в Konso CMS, а репозиторий содержит код, который превращает эти данные в страницы.

4. CI/CD — автоматическая сборка и публикация

CI/CD — это механизм, который автоматически выполняет технические операции, необходимые для подготовки и публикации сайта.

В рассматриваемой архитектуре предусмотрены два способа запуска сборки.

Автоматическая сборка

Когда редактор публикует или изменяет материал в Konso CMS, система может отправить webhook — специальное HTTP-уведомление о произошедшем событии.

Webhook запускает настроенный процесс обновления сайта через Git-платформу или систему CI/CD.

Далее происходит следующее:

  • Система сборки получает актуальный исходный код из Git.
  • Запрашивает опубликованный контент из Konso CMS через API.
  • Генерирует страницы сайта.
  • Проверяет результат и подготавливает файлы к публикации.
  • Размещает готовую версию сайта на выбранном хостинге.

В результате редактору достаточно обновить контент, а технические операции выполняются автоматически.

Ручная сборка

Второй вариант — запуск сборки вручную.

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

Оба механизма могут существовать одновременно.

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

Webhook сам по себе не собирает сайт. Он лишь инициирует настроенный процесс. Конкретная реализация зависит от выбранной Git-платформы и CI/CD-системы.

5. Frontend — свобода выбора технологий

Konso CMS не привязывает проект к определённому frontend-фреймворку.

В представленной архитектуре можно использовать:

Технология Типичные сценарии
Astro Корпоративные сайты, блоги, документация, лендинги
Next.js Сайты и приложения на React с SSG, SSR и гибридным рендерингом
Vue Пользовательские интерфейсы и приложения, в том числе с генерацией статических страниц через дополнительные инструменты
React Интерактивные интерфейсы и сайты с подходящим инструментом сборки

Для рассматриваемой схемы особенно интересен подход SSG (Static Site Generation) — предварительная генерация статических страниц.

Вместо того чтобы создавать HTML при каждом запросе посетителя, система формирует страницы заранее, на этапе сборки.

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

Посетитель получает уже подготовленный HTML вместе со стилями, изображениями и JavaScript.

Почему это полезно?

  • Высокая скорость. Готовые страницы могут доставляться быстрее, поскольку не требуют серверного рендеринга при каждом обращении.
  • Меньше инфраструктуры. Для обслуживания статического сайта не обязательно запускать постоянно работающий backend приложения.
  • Устойчивость. Временная недоступность CMS не обязательно влияет на уже опубликованный сайт.
  • Безопасность. У статического сайта меньше серверных компонентов, доступных извне, что сокращает потенциальную поверхность атаки.

При этом SSG подходит не для всех сценариев. Если сайт требует персонализированного контента, постоянно обновляемых данных или сложной серверной логики, можно использовать SSR, клиентские API-запросы или гибридный подход.

Вы можете узнать больше про разницу подходов из нашей статьи
Статический и динамический сайт: в чем разница и какой выбрать?

6. Konso CDN — доставка статических ресурсов

Ещё один компонент архитектуры — Konso CDN.

CDN (Content Delivery Network) предназначена для доставки статических ресурсов, таких как изображения и другие файлы, используемые сайтом.

В представленной схеме Konso CMS связана с Konso CDN, а опубликованный сайт использует ресурсы, доступные через CDN.

Например, редактор загружает изображение в CMS, после чего сайт может использовать его URL для отображения на странице.

Использование CDN позволяет:

  • Снизить нагрузку на основной источник файлов.
  • Ускорить доставку ресурсов благодаря кешированию.
  • Отделить хранение и доставку медиафайлов от frontend-приложения.
  • Использовать одни и те же ресурсы на разных страницах и сайтах.

Важное различие: CDN для медиафайлов и хостинг готовых HTML-страниц — не обязательно одно и то же.

В рассматриваемой архитектуре Konso CDN используется для доставки ресурсов, а готовый сайт может размещаться на отдельном статическом хостинге. При необходимости доставка HTML также может быть организована через CDN.

7. Как всё работает вместе: пример публикации статьи

Представим обычную ситуацию: редактор хочет добавить новую статью в корпоративный блог.

Шаг 1. Создание контента

Редактор открывает Konso CMS, создаёт статью, добавляет текст, изображения и SEO-метаданные.

Шаг 2. Публикация

После публикации Konso отправляет webhook в настроенную систему автоматизации.

Шаг 3. Запуск сборки

CI/CD запускает процесс сборки сайта, используя код из Git-репозитория.

Шаг 4. Получение данных

Frontend-проект обращается к Konso API и получает актуальные опубликованные материалы, включая новую статью.

Шаг 5. Генерация страниц

Генератор статического сайта создаёт HTML-страницу новой статьи и при необходимости обновляет главную страницу блога, категории и другие связанные разделы.

Шаг 6. Развёртывание

После успешной сборки новая версия сайта публикуется на хостинге. Изображения и другие статические ресурсы могут доставляться через Konso CDN.

В результате новая статья появляется на сайте без ручного редактирования HTML и без необходимости самостоятельно запускать технические команды.

Время между публикацией в CMS и появлением изменений на сайте зависит от продолжительности сборки, развёртывания и настроек кеширования.

8. Что получает бизнес, а что — команда разработки?

Эта архитектура решает разные задачи для владельцев сайтов, редакторов и разработчиков.

Для бизнеса и редакторов Для разработчиков
Управление контентом без изменения кода Свобода выбора frontend-стека
Быстрая публикация новых материалов Версионирование кода через Git
Меньшая зависимость от разработчиков при обновлении страниц Автоматизация сборки и развёртывания
Возможность создавать быстрые сайты Использование API и структурированных данных
Разделение ответственности между командами Независимая разработка frontend и CMS

Дополнительное преимущество — возможность менять отдельные компоненты архитектуры без полной перестройки системы.

Например, можно перенести frontend на другой хостинг, заменить инструмент CI/CD или обновить дизайн сайта, сохранив существующий контент в Konso CMS.

9. Ограничения и особенности архитектуры

Несмотря на преимущества, у такого подхода есть особенности, которые важно учитывать при проектировании.

  • Изменения появляются после сборки. В отличие от сайта с динамическим рендерингом, обновлённый контент не обязательно становится доступным мгновенно. Сначала необходимо выполнить сборку и развёртывание.
  • Большие сайты требуют оптимизации. Если проект содержит десятки тысяч страниц, полная пересборка после каждого изменения может быть неэффективной. В таких случаях стоит рассмотреть инкрементальную генерацию или гибридную архитектуру.
  • CI/CD необходимо настроить. Автоматическая публикация требует первоначальной интеграции Git, Konso CMS и системы сборки, а также безопасного управления ключами доступа.
  • Необходим контроль ошибок. Если сборка завершилась неудачно, важно сохранить предыдущую рабочую версию сайта и уведомить ответственную команду.
  • Динамические функции реализуются отдельно. Авторизация пользователей, персональные кабинеты, поиск с актуальными данными и другие интерактивные функции могут потребовать дополнительных сервисов.

Эти ограничения не делают архитектуру сложной или неэффективной. Они лишь означают, что способ публикации следует выбирать с учётом требований конкретного проекта.

10. Когда стоит использовать такую архитектуру?

Сочетание Konso CMS, Git, CI/CD и статической генерации особенно хорошо подходит для:

  • Корпоративных сайтов, где контент регулярно обновляется, но не требует персонализации для каждого посетителя.
  • Блогов и медиа, где важны SEO, производительность и удобство публикации.
  • Документации и баз знаний, где требуется структурированное хранение материалов и автоматическое обновление страниц.
  • Маркетинговых сайтов и лендингов, где важны скорость загрузки и свобода дизайна.
  • Многоязычных сайтов, где одна CMS управляет несколькими локализациями контента.

Для сложных веб-приложений Konso также может выступать источником контента, но архитектура frontend и способ рендеринга могут отличаться от представленной схемы.

Заключение

Konso CMS позволяет разделить управление контентом, разработку сайта и его публикацию на независимые процессы.

В рассмотренной архитектуре Konso отвечает за контент, Git — за исходный код, CI/CD — за сборку и развёртывание, а frontend и CDN — за представление и доставку готового результата пользователю.

Это не единственный способ построить сайт на Konso. Можно использовать другие фреймворки, хостинг, инструменты автоматизации и подходы к рендерингу.

Главное преимущество такого разделения — возможность развивать сайт, менять технологии и автоматизировать публикацию, не привязывая управление контентом к конкретной реализации frontend.

Хотите попробовать такую архитектуру?

Создайте проект в Konso CMS, настройте структуру контента и подключите его к своему сайту через API.

Документация и примеры интеграции доступны в базе знаний Konso.

Частые вопросы

Как работает Konso CMS со статическим сайтом? expand_more

Konso CMS хранит контент и предоставляет его через API. Во время сборки сайт получает актуальные данные из CMS и формирует готовые HTML-страницы. Редакторы могут изменять тексты, изображения и SEO-метаданные без доступа к исходному коду сайта.

Как обновляется статический сайт после изменения контента? expand_more

После публикации изменений Konso CMS может отправить webhook, который запускает автоматическую сборку сайта через CI/CD. Система получает обновлённый контент, генерирует страницы и публикует новую версию. Также сборку можно запускать вручную на вашем ПК.

Какие frontend-технологии можно использовать с Konso CMS? expand_more

Konso CMS не привязана к конкретному frontend-фреймворку. Для создания сайтов можно использовать Astro, Next.js, Vue, React и другие технологии. Для статической генерации особенно удобны Astro и Next.js, а для Vue и React доступны дополнительные инструменты и фреймворки.

Зачем использовать Git и CI/CD вместе с Konso CMS? expand_more

Git хранит исходный код сайта и историю его изменений, а CI/CD автоматизирует сборку и публикацию. Такое разделение позволяет разработчикам работать над дизайном и функциональностью, а редакторам — независимо управлять контентом через Konso CMS.

Обязательно ли использовать статическую генерацию с Konso CMS? expand_more

Нет. Статическая генерация — лишь один из возможных вариантов архитектуры. Konso CMS можно использовать с серверным рендерингом (SSR), клиентской загрузкой данных через API или гибридными подходами. Выбор зависит от требований к производительности, интерактивности и частоте обновления контента.

Какую роль выполняет Konso CDN? expand_more

Konso CDN используется для доставки статических ресурсов, например изображений и файлов. Это помогает ускорить загрузку материалов и снизить нагрузку на основной источник данных. Сам сайт при этом может размещаться на отдельном хостинге.