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              [--add-bootstrap-package=<name>...]
21              [--delete-package=<name>...]
22              [--signing-key=<key-file>...]
23          kiwi system prepare help
24

DESCRIPTION

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

OPTIONS

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

AUTHOR

91       Marcus Schäfer
92

94       2019, Marcus Schäfer
95
96
97
98
999.19.5                           Dec 02, 2019         KIWI::SYSTEM::PREPARE(8)
Impressum