README 3.84 KB
Newer Older
Michael Shigorin's avatar
Michael Shigorin committed
1 2 3
== Welcome to m-p! ==

*Brief summary*
4

Mike Radyuk's avatar
Mike Radyuk committed
5 6
  Configurables: ~/.mkimage/profiles.mk;
  see doc/params.txt and conf.d/README
7

Mike Radyuk's avatar
Mike Radyuk committed
8
  License: GPLv2+, see COPYING
9

Mike Radyuk's avatar
Mike Radyuk committed
10
  Most docs are in Russian, welcome to learn it or ask for English.
Michael Shigorin's avatar
Michael Shigorin committed
11

Michael Shigorin's avatar
Michael Shigorin committed
12
Задача:
Mike Radyuk's avatar
Mike Radyuk committed
13 14

* конфигурирование и создание образов на базе ALT Linux
Michael Shigorin's avatar
Michael Shigorin committed
15

16
Концепция:
Mike Radyuk's avatar
Mike Radyuk committed
17 18 19

* конфигурация, как и образ -- объект постадийной сборки
* метапрофиль служит репозиторием для построения индивидуального
Michael Shigorin's avatar
Michael Shigorin committed
20
  профиля, по которому создаётся итоговый образ
21 22

Особенности:
Mike Radyuk's avatar
Mike Radyuk committed
23

Michael Shigorin's avatar
Michael Shigorin committed
24
* метапрофиль при сборке может быть доступен только на чтение
Mike Radyuk's avatar
Mike Radyuk committed
25 26
* для сборки подыскивается предпочтительно tmpfs
* в профиль копируются только нужные объекты;
27
  он автономен относительно метапрофиля
Michael Shigorin's avatar
Michael Shigorin committed
28

Michael Shigorin's avatar
Michael Shigorin committed
29
Стадии работы:
Mike Radyuk's avatar
Mike Radyuk committed
30 31 32 33 34

* инициализация сборочного профиля
* сборка конфигурации образа
* наполнение сборочного профиля
* сборка образа
Michael Shigorin's avatar
Michael Shigorin committed
35

Michael Shigorin's avatar
Michael Shigorin committed
36
Объекты:
Mike Radyuk's avatar
Mike Radyuk committed
37 38

* дистрибутивы и виртуальные среды/машины:
Michael Shigorin's avatar
Michael Shigorin committed
39
** описываются в conf.d/*.mk
Mike Radyuk's avatar
Mike Radyuk committed
40
** могут основываться на предшественниках, расширяя их
Michael Shigorin's avatar
Michael Shigorin committed
41
** дистрибутивы также включают один или более субпрофилей по надобности
Mike Radyuk's avatar
Mike Radyuk committed
42
** желательно избегать множественного наследования, см. тж. фичи
43

Mike Radyuk's avatar
Mike Radyuk committed
44 45 46
* субпрофили:
** список собирается в $(SUBPROFILES)
** базовые комплекты помещены в подкаталогах под sub.in/;
Michael Shigorin's avatar
Michael Shigorin committed
47
   их наборы скриптов могут расширяться фичами
48

Mike Radyuk's avatar
Mike Radyuk committed
49 50 51 52 53 54
* фичи:
** законченные блоки функциональности (или наборы таковых)
** описываются в индивидуальных features.in/*/config.mk
** могут требовать другие фичи, а также субпрофили
** накопительный список собирается в $(FEATURES)
** при сборке $(BUILDDIR) содержимое фич добавляется в профиль
55

Mike Radyuk's avatar
Mike Radyuk committed
56
* списки пакетов (*_LISTS):
57
** _внимание_: не надо создавать фичу, если достаточно списка пакетов!
Mike Radyuk's avatar
Mike Radyuk committed
58
** просьба по возможности избегать дублирования (см. bin/pkgdups)
59

Mike Radyuk's avatar
Mike Radyuk committed
60
* индивидуальные пакеты (*_PACKAGES): см. тж. conf.d/README
61 62

Результат:
Mike Radyuk's avatar
Mike Radyuk committed
63 64

* при успешном завершении сборки образ называется по имени цели
Michael Shigorin's avatar
Michael Shigorin committed
65
  и укладывается в $(IMAGEDIR):
Mike Radyuk's avatar
Mike Radyuk committed
66 67 68 69
** указанный явно,
** либо ~/out/ (если возможно),
** или $(BUILDDIR)/out/ иначе
* формируются отчёты, если запрошены (REPORT)
70 71

См. тж.:
Mike Radyuk's avatar
Mike Radyuk committed
72

73
* http://altlinux.org/m-p: обзорная документация, в т.ч. howto
Mike Radyuk's avatar
Mike Radyuk committed
74 75 76 77
* doc/:
** params.txt: переменные, указываемые при запуске сборки
** pkglists.txt: формирование состава образа
** features.txt: обзор подключаемых особенностей
78

79 80 81
Примечание: пути в документации задаются от каталога верхнего уровня,
если не указаны как относительные в явном виде (./) или по смыслу.

82 83 84
Удачи; что не так -- пишите.

Michael Shigorin <mike@altlinux.org>