1KIWI::SYSTEM::PREPARE(8)             kiwi             KIWI::SYSTEM::PREPARE(8)
2
3
4

NAME

6       kiwi::system::prepare - Prepare image root system
7

SYNOPSIS

9          kiwi [global options] service <command> [<args>]
10
11          kiwi system prepare -h | --help
12          kiwi system prepare --description=<directory> --root=<directory>
13              [--allow-existing-root]
14              [--clear-cache]
15              [--ignore-repos]
16              [--ignore-repos-used-for-build]
17              [--set-repo=<source,type,alias,priority,imageinclude,package_gpgcheck>]
18              [--add-repo=<source,type,alias,priority,imageinclude,package_gpgcheck>...]
19              [--add-package=<name>...]
20              [--delete-package=<name>...]
21              [--signing-key=<key-file>...]
22          kiwi system prepare help
23

DESCRIPTION

25       Create  a new image root directory. The prepare step builds a new image
26       root directory from the specified XML description. The  specified  root
27       directory  is  the root directory of the new image root system.  As the
28       root user you can enter this system via chroot as follows:
29
30          $ chroot <directory> bash
31

OPTIONS

33       --add-package=<name>
34              specify package to add(install). The  option  can  be  specified
35              multiple times
36
37       --add-repo=<source,type,alias,priority,imageinclude,package_gpgcheck>
38              See the kiwi::system::build manual page for further details
39
40       --allow-existing-root
41              allow to re-use an existing image root directory
42
43       --clear-cache
44              delete repository cache for each of the used repositories before
45              installing any package. This is useful if an image build  should
46              take and validate the signature of the package from the original
47              repository source for any build. Some package managers  uncondi‐
48              tionally  trust the contents of the cache, which is ok for cache
49              data dedicated to one build but in case of  kiwi  the  cache  is
50              shared  between  multiple  image builds on that host for perfor‐
51              mance reasons.
52
53       --delete-package=<name>
54              specify package to delete. The option can be specified  multiple
55              times
56
57       --description=<directory>
58              Path to the kiwi XML description. Inside of that directory there
59              must be at least a config.xml of *.kiwi XML description.
60
61       --ignore-repos
62              Ignore all repository configurations from the  XML  description.
63              Using  that  option is usally done with a sequence of --add-repo
64              options otherwise there are no repositories  available  for  the
65              image build which would lead to an error.
66
67       --ignore-repos-used-for-build
68              Works the same way as --ignore-repos except that repository con‐
69              figurations which has the imageonly attribute set to  true  will
70              not be ignored.
71
72       --root=<directory>
73              Path to create the new root system.
74
75       --set-repo=<source,type,alias,priority,imageinclude,package_gpgcheck>
76              See the kiwi::system::build manual page for further details
77
78       --signing-key=<key-file>
79              set  the  key  file  to be trusted and imported into the package
80              manager database before performing any opertaion. This is useful
81              if  an image build should take and validate repository and pack‐
82              age signatures during build time. This option can  be  specified
83              multiple times.
84

AUTHOR

86       Marcus Schäfer
87

89       2016, Marcus Schäfer
90
91
92
93
949.17.38                          Apr 22, 2019         KIWI::SYSTEM::PREPARE(8)
Impressum