Go to file
Michael Shigorin c08e86afc5 features: hopefully better README
Thanks both drool@ for his mild frustration with the current
documentation as well as Greg Kroah-Hartman, Heikki Orsila
and Neil Brown for http://lwn.net/Articles/504814/ -- the docs
should really emphasize *why* something is done, not *how*,
as the "how" part is better documented with the code itself
(that doesn't mean that "the big picture" isn't needed).
2012-08-11 21:45:26 +03:00
.gear gear-store-tags 2012-08-07 00:04:47 +04:00
bin git usage refactoring 2012-08-10 00:12:46 +03:00
conf.d live-builder.iso += livecd-qemu-arch 2012-08-06 23:56:32 +04:00
doc image.in/Makefile: support image STATUS 2012-08-06 23:58:26 +04:00
features.in features: hopefully better README 2012-08-11 21:45:26 +03:00
image.in image.in/Makefile: support image STATUS 2012-08-06 23:58:26 +04:00
lib complex subprofile delimiter changed ("/" -> "@") 2012-08-11 20:11:17 +03:00
pkg.in razorqt += qps 2012-08-10 19:48:04 +04:00
sub.in complex subprofile delimiter changed ("/" -> "@") 2012-08-11 20:11:17 +03:00
.gitignore kernel and BUILDDIR fixes 2011-11-04 16:15:29 +02:00
COPYING actually released as free software 2011-11-04 16:15:30 +02:00
main.mk build-vm: standalone build is a must, too 2012-07-18 16:06:15 +03:00
Makefile Makefile: fix default target to provide help again 2012-07-28 13:26:08 +04:00
QUICKSTART docs updated 2012-06-25 19:29:38 +03:00
README README: whoops, temporary name persisted 2012-07-02 16:14:34 +03:00
reports.mk Add LIBDIR variable. 2012-06-21 17:11:02 +04: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.

Welcome to mkimage-profiles!

Configurables: ~/.mkimage/profiles.mk;
see doc/params.txt and conf.d/README

License: GPLv2+, see COPYING

Most docs are in Russian, welcome to learn it or ask for English.

См. тж. http://www.altlinux.org/Mkimage/Profiles/m-p и doc/*.txt:
- params.txt: переменные, указываемые при запуске сборки
- features.txt: обзор подключаемых особенностей
- pkglists.txt: формирование состава образа

Задача:
- конфигурирование и создание образов на базе ALT Linux

Концепция:
- конфигурация, как и образ -- объект постадийной сборки
- метапрофиль служит репозиторием для построения индивидуального
  профиля, по которому создаётся итоговый образ

Особенности:
- метапрофиль может быть полностью read-only при сборке
- для сборки подыскивается предпочтительно tmpfs
- в профиль копируются только нужные объекты;
  он автономен относительно метапрофиля

Стадии работы:
- инициализация сборочного профиля
- сборка конфигурации образа
- наполнение сборочного профиля
- сборка образа

Объекты:
- дистрибутивы и виртуальные среды/машины:
  + описываются в conf.d/*.mk или соответственно lib/{distro,ve,vm}.mk
  + могут основываться на предшественниках, расширяя их
  + дистрибутивы также:
    - включают один или более субпрофилей по надобности
  + желательно избегать множественного наследования, см. тж. фичи
- субпрофили:
  + список собирается в $(SUBPROFILES)
  + базовые комплекты помещены в подкаталогах под sub.in/;
    их наборы скриптов могут расширяться фичами
- фичи:
  + накопительный список собирается в $(FEATURES)
  + законченные блоки функциональности (или наборы таковых)
  + описываются в индивидуальных features.in/*/config.mk
  + могут требовать другие фичи, а также субпрофили
  + при сборке $(BUILDDIR) содержимое фич добавляется в профиль
- списки пакетов (*_LISTS):
  + просьба по возможности избегать дублирования
- индивидуальные пакеты (*_PACKAGES): см. тж. conf.d/README

Результат:
- при успешном завершении сборки образ называется по имени цели
  и укладывается в $(IMAGEDIR):
  + указанный явно,
  + либо ~/out/ (если возможно),
  + или $(BUILDDIR)/out/ иначе
- формируются отчёты, если запрошены (REPORT)