WhiteLabel
Материал из ALT Linux Wiki
м (→installer: fix link) |
м (это не хлам, а тщательно окаменевшие древние записки!) |
||
(26 промежуточных версий не показаны.) | |||
Строка 1: | Строка 1: | ||
- | [[Категория: | + | [[Категория:Mkimage]] |
- | {{ | + | {{Historical}} |
== ТЗ: white labeling == | == ТЗ: white labeling == | ||
Строка 6: | Строка 6: | ||
=== intro === | === intro === | ||
- | ALT Linux | + | Дистрибутивы ALT Linux появляются из профилей и пакетов при помощи утилит [[Mkimage|mkimage]] <s>или [[Spt|spt]]</s>; отличия вовсе не всегда оправдывают полновесный форк профиля. |
- | В процессе разработки [http://git.altlinux.org/people/mike/packages/?p=mkimage-profiles-ltsp.git mkimage-profiles-ltsp] на базе [http://git.altlinux.org/people/boyarsh/packages/?p=mkimage-profiles-desktop.git mkimage-profiles-desktop] и наблюдения за пробным камнем на пути whitelabeling, а именно школьным проектом (где часть разницы и есть в смене дизайна и текстовых строк) -- начало формироваться понимание не только гибкости | + | В процессе разработки [http://git.altlinux.org/people/mike/packages/?p=mkimage-profiles-ltsp.git mkimage-profiles-ltsp] на базе [http://git.altlinux.org/people/boyarsh/packages/?p=mkimage-profiles-desktop.git mkimage-profiles-desktop] и наблюдения за пробным камнем на пути whitelabeling, а именно школьным проектом (где часть разницы и есть в смене дизайна и текстовых строк) -- начало формироваться понимание не только гибкости mkimage, но и желательности удобной схемы её использования для предотвращения непродуктивного форканья: |
* профилей (и целей сборки внутри них), | * профилей (и целей сборки внутри них), | ||
* инсталеров (и настроечных скриптов внутри них) | * инсталеров (и настроечных скриптов внутри них) | ||
Строка 27: | Строка 27: | ||
Это подразумевает также построение дерева ("водопада"?) требуемой для сборки информации -- от наиболее общей (тип дистрибутива) к частной (дизайн и мелкие особенности) с осмысленным наследованием значений по умолчанию частностями от общностей. При этом дизайн/носитель определяются вместе постановкой задачи для дистрибутива; не уверен насчёт их порядка или вообще зависимости друг от друга. | Это подразумевает также построение дерева ("водопада"?) требуемой для сборки информации -- от наиболее общей (тип дистрибутива) к частной (дизайн и мелкие особенности) с осмысленным наследованием значений по умолчанию частностями от общностей. При этом дизайн/носитель определяются вместе постановкой задачи для дистрибутива; не уверен насчёт их порядка или вообще зависимости друг от друга. | ||
- | Предлагаемый порядок: DISTRO; FLAVOUR; DESIGN; MEDIA; набор FEATURE; DOCS. Пример: DISTRO=Desktop, FLAVOUR=Lite, MEDIA=cd, остальное наследуется от предшественников (с заглавными буковками решено завязывать в пользу прописных). | + | [http://fly.osdn.org.ua/~mike/ALT/docs/whitelabel/whitelabel.PNG Предлагаемый порядок]: DISTRO; FLAVOUR; DESIGN; MEDIA; набор FEATURE; DOCS. Пример: DISTRO=Desktop, FLAVOUR=Lite, MEDIA=cd, остальное наследуется от предшественников (с заглавными буковками решено завязывать в пользу прописных). |
Или а-ля Rails: замена кучи перекладываний одного и того же набором договоренностей, "куда смотреть". | Или а-ля Rails: замена кучи перекладываний одного и того же набором договоренностей, "куда смотреть". | ||
Строка 35: | Строка 35: | ||
Предполагается, что дистрибутивообразующим является ''назначение'' дистрибутива (PURPOSE); из него следует набор фич (FEATURE), к ним привязывается документация (DOCS). К этому всему идёт типовой или отдельный дизайн (DESIGN; см. тж. THEME). Из дизайна как такового ничего (пока) не следует. | Предполагается, что дистрибутивообразующим является ''назначение'' дистрибутива (PURPOSE); из него следует набор фич (FEATURE), к ним привязывается документация (DOCS). К этому всему идёт типовой или отдельный дизайн (DESIGN; см. тж. THEME). Из дизайна как такового ничего (пока) не следует. | ||
- | Следует также иметь в виду, что обычно собирается несколько образов за один проход -- например, <tt>live dvd rescue installer</tt>. | + | Следует также иметь в виду, что <s>обычно</s> иногда собирается несколько образов за один проход -- например, <tt>live dvd rescue installer</tt>. Обычно <tt>./make-distro</tt> (один за раз). |
+ | |||
+ | '''Состояние:''' в [[Mkimage/Profiles/Desktop|m-p-d]] ужасное, переменные в огромном количестве и беспорядке снуют по всем этажам и отследить маршрут бывает сложно. Похоже, стоит разделить создание хост-конфигурации (<tt>./configure</tt>), состава дистрибутива (<tt>make config</tt>) и собственно сборку дистрибутива (<tt>make image</tt>). | ||
==== installer ==== | ==== installer ==== | ||
Строка 41: | Строка 43: | ||
При таком подходе возможно как выстроить схему зависимостей (например, <tt>installer-feature-ltsp-stage2 Requires: installer-feature-pxeboot-stage2</tt>), так и проставить конфликты между скриптами, которые производят несовместимые изменения в одном и том же конфигурационном файле. | При таком подходе возможно как выстроить схему зависимостей (например, <tt>installer-feature-ltsp-stage2 Requires: installer-feature-pxeboot-stage2</tt>), так и проставить конфликты между скриптами, которые производят несовместимые изменения в одном и том же конфигурационном файле. | ||
+ | |||
+ | '''Состояние:''' по большей части [[Installer/beans|сделано]]. | ||
==== mkimage-profiles ==== | ==== mkimage-profiles ==== | ||
- | Наблюдаются следующие проблемы (на примере <tt>[http://git.altlinux.org/people/boyarsh/packages/?p=mkimage-profiles-desktop.git;a= | + | Наблюдаются следующие проблемы (на примере <tt>[http://git.altlinux.org/people/boyarsh/packages/?p=mkimage-profiles-desktop.git;a=summary mkimage-profiles-desktop]</tt> как наиболее развитого набора): |
* профили в силу своей нетривиальности размножаются методом клонирования и правки, при этом оригинал может "не ожидать" того стиля изменений, который производится, и не очень-то поддаваться <tt>git pull</tt>; | * профили в силу своей нетривиальности размножаются методом клонирования и правки, при этом оригинал может "не ожидать" того стиля изменений, который производится, и не очень-то поддаваться <tt>git pull</tt>; | ||
* сами профили могут иметь избыточность внутри: | * сами профили могут иметь избыточность внутри: | ||
- | ** например, сейчас разница между 18-строчными файлами <tt>base-{cd,dvd}/ | + | ** например, сейчас разница между 18-строчными файлами <tt>base-{cd,dvd}/Makefile.in</tt> составляет одну строку, которая опять же различается лишь отчасти, но для анализа изменений требует не только <tt>diff</tt>, но и глаз |
** см. тж. идентичные <tt>base-*/scripts.d/01-basesystem.manifest</tt> | ** см. тж. идентичные <tt>base-*/scripts.d/01-basesystem.manifest</tt> | ||
- | * поток информации по переменным от ключей configure и toplevel Makefile может быть излишне [странно] опосредован и таким образом хрупок (см. выбор <tt>INFO_NAME</tt>/<tt>INFO_LABEL</tt> в <tt>profiles/ | + | * поток информации по переменным от ключей configure и toplevel Makefile может быть излишне [странно] опосредован и таким образом хрупок (см. выбор <tt>INFO_NAME</tt>/<tt>INFO_LABEL</tt> в <tt>profiles/Makefile.in</tt> в зависимости от имени файла ISO на выходе); |
- | * <tt>configure</tt> знает слишком много о структуре профиля (<tt>profiles/*/ | + | * <tt>configure</tt> знает слишком много о структуре профиля (<tt>profiles/*/Makefile.in</tt>). |
- | + | '''Состояние:''' mike@ начата работа над [[m-p|mkimage-profiles.git]], по состоянию на осень 2015 -- рабочий инструмент, которым штатно собираются [[starterkits]]/[[regular]]. | |
==== пакетная база ==== | ==== пакетная база ==== | ||
- | В общих чертах определяется назначением и носителем дистрибутива; имеют место общие части (например, для любого livecd, любого xfce-based или любого школьного есть ряд обязательных пакетов) и специфичные (например, для 64-битного десктопа нет <tt>wine</tt> и <tt>mozilla-plugin-adobe-flash</tt>, а в Линукс Мастер нужно положить <tt>eclipse</tt>). | + | В общих чертах определяется назначением и носителем дистрибутива; имеют место общие части (например, для любого livecd, любого xfce-based или любого школьного есть ряд обязательных пакетов) и специфичные (<s>например, для 64-битного десктопа нет <tt>wine</tt> и опять нет <tt>mozilla-plugin-adobe-flash</tt>,</s> а в Линукс Мастер нужно положить <tt>eclipse</tt>). |
+ | |||
+ | <s>Также существуют мелкие, но важные различия между типичным составом списков для разных бранчей (e.g. M40/M41). Их хочется уметь обрабатывать как "это общее, а это специфичное -- подхвати, что надо".</s> ''Похоже, для этого лучше подходят бранчи профиля -- слишком много изменений помимо списков пакетов.'' | ||
- | + | '''Состояние:''' так себе; в m-p-d: | |
+ | * сделан хак под названием <tt>I586_ONLY</tt>, который на не-i586 превращается в символ комментария (<tt>#</tt>); бродят соображения то ли по условно-включаемым пакетам (<tt>?wine</tt>), то ли по тегам (где архитектура явно или перечнем отрицаний остальных поддерживаемых добавляется в список); | ||
+ | * написан скрипт <tt>bin/pkgdups.sh</tt>, ищущий дубликаты в списках пакетов -- но ими никто не занимается; | ||
+ | * написан скрипт <tt>bin/check-pkg-list</tt>, ищущий заведомо неустанавливаемые пакеты в списках -- но он не интегрирован в сборку удобным образом и потому также практически не используется. | ||
- | + | В m-p не сделано никак особо, можно выкручиваться условным подцеплением списков по архитектуре. | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | Реализация подразумевает добавление в <tt>profiles/base | + | ==== брендинг ==== |
+ | Предлагается переключать по <tt>--with-branding=</tt> (умолчание наследуется от значения <tt>--with-distro</tt> или установленного в профиле). См. тж. [[Branding|здесь]]. | ||
+ | <!-- | ||
+ | Реализация подразумевает добавление в <tt>profiles/base/Makefile.in::IMAGE_PACKAGES</tt> (параметризованных) имён либо пакетов, либо списков таковых (при этом внутри списка параметризации уже нет). | ||
Первый способ обеспечивает гибкость на этапе сборки без модификации профиля: в параметрах configure можно передать произвольный суффикс -- но ограничивает таковую по части полноты набора дизайна: все пакеты должны быть, а некоторые из них при этом недостаточно даже скопировать, поскольку этот же суффикс используется в имени каталога). | Первый способ обеспечивает гибкость на этапе сборки без модификации профиля: в параметрах configure можно передать произвольный суффикс -- но ограничивает таковую по части полноты набора дизайна: все пакеты должны быть, а некоторые из них при этом недостаточно даже скопировать, поскольку этот же суффикс используется в имени каталога). | ||
Строка 74: | Строка 81: | ||
Здесь разумным компромиссом пока выглядит первый вариант с разумным fallback на заведомо существующий вариант дизайна и упакованные "пустышки" для дизайна с именем <tt>none</tt> на случай, когда таковой не требуется (пакет <tt>design-none</tt>, который <tt>Provides:</tt> всё (не)нужное). | Здесь разумным компромиссом пока выглядит первый вариант с разумным fallback на заведомо существующий вариант дизайна и упакованные "пустышки" для дизайна с именем <tt>none</tt> на случай, когда таковой не требуется (пакет <tt>design-none</tt>, который <tt>Provides:</tt> всё (не)нужное). | ||
+ | --> | ||
- | + | NB: могут быть субварианты брендинга, как-то для LXDEsktop Lite/Standard (различные хайлайты пакетной базы). | |
- | + | ||
=== ссылки === | === ссылки === | ||
* [http://fly.osdn.org.ua/~mike/ALT/docs/whitelabel/ слайды] (kdissert, PNG) | * [http://fly.osdn.org.ua/~mike/ALT/docs/whitelabel/ слайды] (kdissert, PNG) | ||
- | * [[Installer/beans]] | + | * [[Installer/beans|готовые компоненты инсталера]] |
+ | * [[Branding|оформление дистрибутивов]] |
Текущая версия на 11:05, 28 июня 2016
ТЗ: white labeling
Содержание |
intro
Дистрибутивы ALT Linux появляются из профилей и пакетов при помощи утилит mkimage или spt; отличия вовсе не всегда оправдывают полновесный форк профиля.
В процессе разработки mkimage-profiles-ltsp на базе mkimage-profiles-desktop и наблюдения за пробным камнем на пути whitelabeling, а именно школьным проектом (где часть разницы и есть в смене дизайна и текстовых строк) -- начало формироваться понимание не только гибкости mkimage, но и желательности удобной схемы её использования для предотвращения непродуктивного форканья:
- профилей (и целей сборки внутри них),
- инсталеров (и настроечных скриптов внутри них)
- и вообще фич вместе с багами в лучшей индусской манере copy-paste
(например, идентичные копии postinstall.d/06-pxe.sh присутствуют ныне в installer-{hpc,ltsp{,-school},junior} -- как их предполагается улучшать, если, скажем, сделаем control portmap server?).
По результатам предварительного обдумывания и обсуждения с boyarsh@, legion@, led@ решил написать с листов на столе не длинное письмо, а структурированную страничку.
цель ТЗ
Максимальная разумная ортогонализация профилей и инсталеров с тем, чтобы тратить время и силы на
- создание и улучшение стыкующихся компонент
а не на
- отслеживание багфиксов в тех git repo, которые когда-то клонировались,
- умножение бранчей на каждый чих отдела маркетинга (или свой) по части дизайна и см. п. 1, только с бранчами.
Попросту говоря, вместо git-fetch git.alt:/people/boyarsh/packages/mkimage-profiles-desktop master:desktop и последующего мержа (муторного, если мои и апстримные правки пересекаются) -- охота делать хотя бы --with-installer=ltsp-school --with-design=ltsp-school, а когда-то -- ./configure --with-distro=junior --with-features=ltsp,school :)
Это подразумевает также построение дерева ("водопада"?) требуемой для сборки информации -- от наиболее общей (тип дистрибутива) к частной (дизайн и мелкие особенности) с осмысленным наследованием значений по умолчанию частностями от общностей. При этом дизайн/носитель определяются вместе постановкой задачи для дистрибутива; не уверен насчёт их порядка или вообще зависимости друг от друга.
Предлагаемый порядок: DISTRO; FLAVOUR; DESIGN; MEDIA; набор FEATURE; DOCS. Пример: DISTRO=Desktop, FLAVOUR=Lite, MEDIA=cd, остальное наследуется от предшественников (с заглавными буковками решено завязывать в пользу прописных).
Или а-ля Rails: замена кучи перекладываний одного и того же набором договоренностей, "куда смотреть".
проблемы/предложения
data flow
Предполагается, что дистрибутивообразующим является назначение дистрибутива (PURPOSE); из него следует набор фич (FEATURE), к ним привязывается документация (DOCS). К этому всему идёт типовой или отдельный дизайн (DESIGN; см. тж. THEME). Из дизайна как такового ничего (пока) не следует.
Следует также иметь в виду, что обычно иногда собирается несколько образов за один проход -- например, live dvd rescue installer. Обычно ./make-distro (один за раз).
Состояние: в m-p-d ужасное, переменные в огромном количестве и беспорядке снуют по всем этажам и отследить маршрут бывает сложно. Похоже, стоит разделить создание хост-конфигурации (./configure), состава дистрибутива (make config) и собственно сборку дистрибутива (make image).
installer
Предлагается обдумать и произвести вынос часто используемых скриптов в пакеты с "фичами" инсталятора вида installer-feature-$(DISTRO)-$(FEATURE) для тех, которые могут иметь специфическое отношение к "кусту" инсталяторов (например, десктопных), или installer-feature-$(FEATURE) для наиболее общих и неинтрузивных фич. Например, пресловутый postinstall.d/06-pxe.sh просится в исходный пакет installer-feature-pxeboot и бинарный installer-feature-pxeboot-stage2.
При таком подходе возможно как выстроить схему зависимостей (например, installer-feature-ltsp-stage2 Requires: installer-feature-pxeboot-stage2), так и проставить конфликты между скриптами, которые производят несовместимые изменения в одном и том же конфигурационном файле.
Состояние: по большей части сделано.
mkimage-profiles
Наблюдаются следующие проблемы (на примере mkimage-profiles-desktop как наиболее развитого набора):
- профили в силу своей нетривиальности размножаются методом клонирования и правки, при этом оригинал может "не ожидать" того стиля изменений, который производится, и не очень-то поддаваться git pull;
- сами профили могут иметь избыточность внутри:
- например, сейчас разница между 18-строчными файлами base-{cd,dvd}/Makefile.in составляет одну строку, которая опять же различается лишь отчасти, но для анализа изменений требует не только diff, но и глаз
- см. тж. идентичные base-*/scripts.d/01-basesystem.manifest
- поток информации по переменным от ключей configure и toplevel Makefile может быть излишне [странно] опосредован и таким образом хрупок (см. выбор INFO_NAME/INFO_LABEL в profiles/Makefile.in в зависимости от имени файла ISO на выходе);
- configure знает слишком много о структуре профиля (profiles/*/Makefile.in).
Состояние: mike@ начата работа над mkimage-profiles.git, по состоянию на осень 2015 -- рабочий инструмент, которым штатно собираются starterkits/regular.
пакетная база
В общих чертах определяется назначением и носителем дистрибутива; имеют место общие части (например, для любого livecd, любого xfce-based или любого школьного есть ряд обязательных пакетов) и специфичные (например, для 64-битного десктопа нет wine и опять нет mozilla-plugin-adobe-flash, а в Линукс Мастер нужно положить eclipse).
Также существуют мелкие, но важные различия между типичным составом списков для разных бранчей (e.g. M40/M41). Их хочется уметь обрабатывать как "это общее, а это специфичное -- подхвати, что надо". Похоже, для этого лучше подходят бранчи профиля -- слишком много изменений помимо списков пакетов.
Состояние: так себе; в m-p-d:
- сделан хак под названием I586_ONLY, который на не-i586 превращается в символ комментария (#); бродят соображения то ли по условно-включаемым пакетам (?wine), то ли по тегам (где архитектура явно или перечнем отрицаний остальных поддерживаемых добавляется в список);
- написан скрипт bin/pkgdups.sh, ищущий дубликаты в списках пакетов -- но ими никто не занимается;
- написан скрипт bin/check-pkg-list, ищущий заведомо неустанавливаемые пакеты в списках -- но он не интегрирован в сборку удобным образом и потому также практически не используется.
В m-p не сделано никак особо, можно выкручиваться условным подцеплением списков по архитектуре.
брендинг
Предлагается переключать по --with-branding= (умолчание наследуется от значения --with-distro или установленного в профиле). См. тж. здесь.
NB: могут быть субварианты брендинга, как-то для LXDEsktop Lite/Standard (различные хайлайты пакетной базы).
ссылки
- слайды (kdissert, PNG)
- готовые компоненты инсталера
- оформление дистрибутивов