mkimage-profiles/conf.d
Dmitriy Terekhin 047b144a08 alt-server: Add installation in OEM mode (live-install)
See: https://www.altlinux.org/Installer/OEM
Suggested-by: Anton Midyukov <antohami@altlinux.org>
2024-09-02 18:26:45 +03:00
..
alt-platform-builder.mk alt-platform-builder.mk: disable select language entry in grub menu 2024-03-18 18:33:15 +07:00
alt-server.mk alt-server: Use live as installer and rescue 2024-09-02 18:26:37 +03:00
basealt.mk basealt.mk: update e2k iso .disk/info records 2024-03-25 22:40:03 +07:00
desktop.mk desktop.mk: add target oem-install for check OEM mode install (without DE) 2023-09-25 12:05:30 +07:00
e2k.mk remove desktop+lxqt+extra package list 2023-07-11 19:10:02 +07:00
education.mk education: remove live from base image 2024-09-01 21:15:16 +03:00
engineering.mk engineering.mk: not cleanup docs and rpmdb for live 2022-02-20 22:16:21 +07:00
homeros.mk speech-*: refactored and unified 2013-11-22 21:28:37 +04:00
kworkstation.mk - kwrk: use firsttime-lightdm-kde instead of installer-feature 2024-09-01 21:51:58 +03:00
live.mk live.mk: add use/stage2/kms to grub-net-install 2023-09-28 23:35:43 +07:00
Makefile check-recipe: generalize dependency control 2017-01-29 15:50:58 +03:00
mixin-alt-server.mk alt-server: Add installation in OEM mode (live-install) 2024-09-02 18:26:45 +03:00
mixin-basealt.mk mixin-basealt.mk: avoid installer-feature-repo-add on e2k 2024-03-25 22:40:03 +07:00
mixin.mk mixin.mk: add kf5-kirigami to regular-kde on Sisyphus 2024-08-26 21:06:20 +03:00
mobile.mk mobile.mk: blacklist kernel modules of camera on MIG lt11i Tablet 2024-08-21 18:33:43 +03:00
README Add COMMON_LISTS variable support by analogy COMMON_PACKAGES 2021-08-31 00:42:31 +07:00
realtime.mk realtime.mk: add xorg-conf-noblank 2024-06-14 18:20:39 +07:00
regular-vm.mk mixin.mk, regular.mk, regular-vm.mk: rename regular-kde5 -> regular-kde 2024-08-15 13:56:34 +03:00
regular.mk regular.mk: add use/firmware/full to regular-rescue-live 2024-08-30 17:08:21 +03:00
server-v.mk server-v: remove bootsplash from installer 2024-05-23 19:24:22 +07:00
server.mk regular.mk, server.mk: do not use deprecated lilo 2023-08-21 20:10:32 +07:00
slinux.mk slinux.mk: revert changes for slinux-live 2024-04-11 17:57:28 +07:00
test.mk test.mk: add package availability test in all package lists 2021-08-23 21:09:07 +07:00
ve.mk ve.mk: fix build systemd-bare, systemd-base 2023-07-24 09:59:42 +07:00
vm.mk vm.mk: use grub for sysvinit targets 2023-08-21 20:10:32 +07:00

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

== conf.d ==

Этот каталог содержит включаемые фрагменты конфигурации образов с тем,
чтобы было удобнее параллельно разрабатывать специфические образы
без излишних merge conflict'ов.

Следует понимать, что основная цель появления mkimage-profiles на свет
-- это уменьшение "форков" внутри семейства дистрибутивных профилей.
Поэтому при возможности следует всё-таки работать над общей базовой
частью, включая скриптовые хуки и списки пакетов, а также оптимизировать
граф зависимостей между конфигурациями образов.

Попросту говоря, copy-paste -- тревожный признак.

Вместо него нередко может помочь выделение кусочков конфигурации
в пределах включаемого файла в цели mixin/*, которые не являются
самостоятельными или даже промежуточными, но включают полезные
группы настроек, нужных в различных образах, не наследующих
друг другу -- посмотрите существующие примеры использования.

По переменным (см. тж. doc/pkglists.txt):

* для пользовательского окружения (live, main) предназначены
  THE_PACKAGES, THE_LISTS, THE_GROUPS, THE_PACKAGES_REGEXP

* для "обычного общего" (live, main, rescue) есть COMMON_PACKAGES и
  COMMON_LISTS
  (NB: тоже попадают в базовую установку, ve/ и vm/ сборки)

* SYSTEM_PACKAGES стоит применять крайне осторожно -- эти пакеты попадут
  во все стадии, в том числе в образ чувствительной к объёму install2
  (в stage1 -- только в инструментальный чрут); применяйте для того,
  что обязано быть и в инсталяторе, и в готовой системе (но не в rescue)

* для направленного действия служат:
** STAGE1_PACKAGES, STAGE1_PACKAGES_REGEXP (первая стадия загрузки)
** STAGE2_PACKAGES (инсталятор и спасательная/"живая" система)
** INSTALL2_PACKAGES (инсталятор)
** BASE_PACKAGES, BASE_LISTS, BASE_PACKAGES_REGEXP (базовая система)
** MAIN_PACKAGES, MAIN_LISTS, MAIN_PACKAGES_REGEXP (дополнительные пакеты)
** LIVE_PACKAGES, LIVE_LISTS, LIVE_PACKAGES_REGEXP ("живая" система)

* аналогично по kernel-modules-*:
** THE_KMODULES попадут в "пользовательскую" среду (live, main)
** STAGE1_KMODULES доступны в производных от stage2 (install2, live, rescue)
** BASE_KMODULES попадут в установку по умолчанию
** MAIN_KMODULES будут доступны для установки с носителя
** LIVE_KMODULES предназначены для LiveCD/LiveFlash

Не стоит бояться такого разнообразия, для большинства задач достаточно THE_*.

По подстановкам:

* $(VAR) подставляются перед их записью в $(CONFIG), который distcfg.mk
* $$(VAR) раскрываются позже, при включении $(CONFIG) и востребовании
  значений; в этом случае их значения могут изменяться до окончания
  конфигурации, а также зависеть от значений других переменных

По спискам пакетов:

* на этапе экспериментирования можно забивать прямо в описание образа
* при фиксации состояния стоит воспользоваться существующими списками,
  а дополнительные оформить как можно более чётко обособленными по тем
  задачам, для решения которых они и подобраны
* повторяющиеся логически связанные группы списков может иметь смысл
  выделить в фичу (см., например, power или x11)
* если явной фичи не наблюдается, но у группы дистрибутивов намечается
  заметная общая часть -- её можно выделить в промежуточную цель вида
  distro/.name, не являющуюся самостоятельно собираемой