Сизиф-на-Куче

Сборочные технологии проекта ALT Docs

Общая идея:

Публикатор: поступающие в Кучу документы должны проходить сборочную процедуру (сборка в HTML и унификация) и публиковаться в собранном виде в Сети без участия человека (короткий цикл).

Кроме этого предусматривается публикация документов во внешних репозиториях (sisyphus), при минимальном участии человека в тривиальных процедурах (пересборка обновлённого документа) -- это длинный цикл.

Текущая реализация сборочной процедуры (не описано тут), даёт только частичную автоматизацию.

Предлагаемая реализация сборочной процедуры (которкий цикл):

  1. Преобразование Кучи в набор git-репозиториев (по одному на каждый документ)
    1. Импорт существующих документов в git утилита git-heapimport

    2. Структура git-Кучи: права доступа, структура каталогов, полиси. формат тегов, запрашивающих пересборку.
  2. Сборочная процедура:
    1. Робот по наступлению события (cron) определяет список модулей к сборке

    2. Он же запускает gear, передавая необходимые сборочные параметры (Timestamp, Archive, Comitter)
    3. gear получает тарболл из git-репозитория и запускает скрипт-обвязку, который генерирует спек и выполняет сборку в hasher

    4. собранный rpm-пакет устанавливается в общий chroot с другими подобными (тоже hasher)
    5. часть chroot, содержащая html-файлы модулей, отображается на web

Реорганизация структуры выпуска

См. техзадание

Предложение по структуре выпуска.

Требуется реорганизовать структуру HTML-модуля. Обоснование: не помещать в index.html модуля информацию, зависящую от названия этого модуля (сейчас роль head.html и foot.html играют символьные ссылки вида Модуль_1.next и т. п.). Не устраивать каши в modules/.

Пример структуры

Развитие сайта ALT Docs

Мелкие:

Покрупнее:

Развитие сайта ALT Linux

ALTLinuxHeap: Docs/TZ (last edited 2007-09-07 11:36:38 by KirillMaslinsky)