1KIWI::SYSTEM::PREPARE(8) kiwi KIWI::SYSTEM::PREPARE(8)
2
3
4
6 kiwi::system::prepare - Prepare image root system
7
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
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
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
86 Marcus Schäfer
87
89 2016, Marcus Schäfer
90
91
92
93
949.17.38 Apr 22, 2019 KIWI::SYSTEM::PREPARE(8)