Текущая версия от 18:10, 10 декабря 2020

Объекты mkimage-profiles

Как правило, более тщательно задокументированы в README из каталога с реализацией.

Обратите внимание: список приведён в порядке убывающей суммарной сложности объекта; если надо добавить пакет — достаточно добавить пакет (например, в THE_PACKAGES); если несколько — можно и в подходящий список; устойчивую группу настроек можно вынести в mixin-цель; а фичу следует заводить тогда, когда необходимо добавить скрипты либо сгруппировать конфигурацию под предметную область для повторного использования (как, например, в фиче server).

образ

Цель вида distro/%, ve/% либо vm/%, выполнение которой приводит к созданию конфигурации соответствующего дистрибутива или виртуального окружения, достаточной для построения его образа. Описываются в conf.d/*.mk (базовые заданы в lib/distro.mk, lib/ve.mk, lib/vm.mk); могут наследовать друг другу. Пример — distro/server-ovz.

Для своего образа (или группы образов) рекомендуется создать новый файл по образцу имеющихся conf.d/*.mk и описывать конфигурацию в нём; это позволит избежать конфликтов при обновлении базового репозитория (например, по git pull).

субпрофиль

Цель вида sub/%, выполнение которой приводит к созданию базовой конфигурации соответствующего цельного блока для укладки в образ дистрибутива (например, sub/install2). Описаны в lib/distro.mk в общем виде, размещаются в sub.in/.

Обратите внимание: sub/stage2 является базовым, а не самостоятельным, и используется посредством use/stage2/* для получения итоговых субпрофилей install2, live, rescue; цели sub/stage2/* являются техническими, не следует ставить их в зависимости дистрибутивов.

фича

Цель вида use/%, снабжённая подкаталогом в features.in/. В подкаталоге может быть:

кусочек конфигурации в виде config.mk, автоматически включаемый в toplevel Makefile;
подкаталоги по имени нужных субпрофилей, содержимое которых добавляется к содержимому включённых в дистрибутив субпрофилей (rootfs является особым случаем, см. sub.in/rootfs/README;
подкаталоги image-scripts.d/ и scripts.d/, скрипты из которых добавляются в toplevel-каталог сборки (см. пример в features.in/syslinux/scripts.d/);
generate.sh и/или generate.mk для постобработки;
включаемый в сборочный каталог lib/ для фич, определяющих сборку образа (build-*).

пакаджлист

Файл со списком пакетов, размещённый в pkg.in/lists/. Упоминается в генерируемом файле конфигурации дистрибутива (distcfg.mk) в переменных %_LISTS; перечисленные списки копируются в создаваемый профиль дистрибутива на стадии порождения дистрибутивного профиля.

Может быть тегированным (tagged/) — см. lib/functions.mk::tags(), bin/tags2lists, features.in/rescue/config.mk по реализации и применению.

Списки пакетов обычно есть смысл выделять в файлы либо при повторном использовании, либо при заметном объёме, когда перечисление прямо в конфигурации сильно снижает её читаемость (предлагаемое «правило большого пальца» — если набралось больше пары строк добавок в одну переменную вроде THE_PACKAGES, стоит обдумать вынесение в файл).

mkimage-profiles

Mkimage-profiles • Mkimage-profiles/design • Mkimage-profiles/examples • Mkimage-profiles/FAQ • Mkimage-profiles/howto • Mkimage-profiles/news • Mkimage-profiles/objects • Mkimage-profiles/style • Mkimage-profiles/oldpage

@@ Строка 1: / Строка 1: @@
 = Объекты [[Mkimage/Profiles/m-p|mkimage-profiles]] =
+Как правило, более тщательно задокументированы в README из каталога с реализацией.
+Обратите внимание: список приведён в порядке убывающей ''суммарной'' сложности объекта; если надо добавить пакет — достаточно добавить пакет (например, в <tt>THE_PACKAGES</tt>); если несколько — можно и в подходящий список; устойчивую группу настроек можно вынести в <tt>mixin</tt>-цель; а фичу следует заводить тогда, когда необходимо добавить скрипты либо сгруппировать конфигурацию под предметную область для повторного использования (как, например, в фиче server).
 == образ ==
-Цель вида <tt>distro/%</tt> либо <tt>ve/%</tt>, выполнение которой приводит к созданию конфигурации соответствующего дистрибутива или виртуального окружения, достаточной для построения его образа. Описываются в {{path|lib/distro.mk}}, {{path|lib/ve.mk}} и {{path|conf/*.mk}}; могут наследовать друг другу. Пример — <tt>distro/server-ovz</tt>.
+Цель вида <tt>distro/%</tt>, <tt>ve/%</tt> либо <tt>vm/%</tt>, выполнение которой приводит к созданию конфигурации соответствующего дистрибутива или виртуального окружения, достаточной для построения его образа. Описываются в {{path|conf.d/*.mk}} (базовые заданы в {{path|lib/distro.mk}}, {{path|lib/ve.mk}}, {{path|lib/vm.mk}}); могут наследовать друг другу. Пример — <tt>distro/server-ovz</tt>.
+Для своего образа (или группы образов) рекомендуется создать новый файл по образцу имеющихся {{path|conf.d/*.mk}} и описывать конфигурацию в нём; это позволит избежать конфликтов при обновлении базового репозитория (например, по {{cmd|git pull}}).
 == субпрофиль ==
 Цель вида <tt>sub/%</tt>, выполнение которой приводит к созданию базовой конфигурации соответствующего цельного блока для укладки в образ дистрибутива (например, <tt>sub/install2</tt>).  Описаны в {{path|lib/distro.mk}} в общем виде, размещаются в {{path|sub.in/}}.
-Обратите внимание: <tt>sub/stage2</tt> является базовым, а не самостоятельным, и используется посредством <tt>use/stage2/*</tt> для получения итоговых субпрофилей install2, live, rescue.  <tt>sub/stage2/*</tt> являются техническими, не следует ставить их в зависимости дистрибутивов.
+Обратите внимание: <tt>sub/stage2</tt> является базовым, а не самостоятельным, и используется посредством <tt>use/stage2/*</tt> для получения итоговых субпрофилей <tt>install2</tt>, <tt>live</tt>, <tt>rescue</tt>; цели <tt>sub/stage2/*</tt> являются техническими, не следует ставить их в зависимости дистрибутивов.
 == фича ==
 Цель вида <tt>use/%</tt>, снабжённая подкаталогом в {{path|features.in/}}.  В подкаталоге может быть:
 * кусочек конфигурации в виде {{path|config.mk}}, автоматически включаемый в toplevel {{path|Makefile}};
-* подкаталоги по имени нужных субпрофилей, содержимое которых добавляется к содержимому включённых в дистрибутив субпрофилей;
+* подкаталоги по имени нужных субпрофилей, содержимое которых добавляется к содержимому включённых в дистрибутив субпрофилей ({{path|rootfs}} является особым случаем, см. {{path|sub.in/rootfs/README}};
 * подкаталоги {{path|image-scripts.d/}} и {{path|scripts.d/}}, скрипты из которых добавляются в toplevel-каталог сборки (см. пример в {{path|features.in/syslinux/scripts.d/}});
 * {{path|generate.sh}} и/или {{path|generate.mk}} для постобработки;
 * включаемый в сборочный каталог {{path|lib/}} для фич, определяющих сборку образа (<tt>build-*</tt>).
-В экспериментальном порядке рядом со {{path|*scripts.d/}} [http://git.altlinux.org/people/mike/public/?p=mkimage-profiles.git;a=commitdiff;h=ec0b0ef375b3206b27ea0890d09c579d9ffdcbbf;hp=8326eebd28a5f660a43ea2d02b174c20ed486777 обрабатываются] {{path|tagged/{image-,}scripts.d/*}}, см. в качестве примера {{path|features.in/cleanup/tagged/image-scripts.d/01+install2+cleanup}}.
 == пакаджлист ==
@@ Строка 23: / Строка 27: @@
 Может быть ''тегированным'' ({{path|tagged/}}) — см. {{path|lib/functions.mk}}<tt>::tags()</tt>, {{path|bin/tags2lists}}, {{path|features.in/rescue/config.mk}} по реализации и применению.
-[[Категория:Mkimage]]
+Списки пакетов обычно есть смысл выделять в файлы либо при повторном использовании, либо при заметном объёме, когда перечисление прямо в конфигурации сильно снижает её читаемость (предлагаемое «правило большого пальца» — если набралось больше пары строк добавок в одну переменную вроде <tt>THE_PACKAGES</tt>, стоит обдумать вынесение в файл).
+{{Category navigation|title=mkimage-profiles|category=mkimage-profiles|sortkey=*}}

Mkimage-profiles/objects: различия между версиями