1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
.. _image-description:
Image Description
=================
.. note::
This document explains the toplevel structure of the
{kiwi} image description document for version |version|
.. toctree::
:maxdepth: 1
image_description/elements.rst
Main Root
---------
.. code:: xml
<image/>
The mandatory :ref:`sec.image` element represents the root (top-level element) of
an image description. All other elements must be descendants of this
element. There can be only one `image` element.
Image Identity
--------------
.. code:: xml
<description/>
The mandatory :ref:`sec.description` element contains information about the author,
contact, license and the specification about the use case of this
image. All data together forms the identity card of the image.
There can be only one `description` element
Image Preferences
-----------------
.. code:: xml
<preferences/>
The mandatory :ref:`sec.preferences` element contains information to classify
the image and to describe the layout. All data about the image type, its
version, the partition layout and much more is specified here. There can be
multiple `preferences` elements
Image Software Sources
----------------------
.. code:: xml
<repository/>
The mandatory :ref:`sec.repository` element contains information where to find the
software packages that are used to build the image. There can be
multiple `repository` elements
Image Content Setup
-------------------
.. code:: xml
<packages/>
The mandatory :ref:`sec.packages` element contains information to list which
software should be installed from the configured repositories
into the image. Software can be defined as names for packages,
collections, archives or products. There can be multiple
`packages` elements
Image Users
-----------
.. code:: xml
<users/>
The optional :ref:`sec.users` element contains information about system users
to be created inside of the image. There can be multiple `users`
elements
Image Namespace
---------------
.. code:: xml
<profiles/>
The optional :ref:`sec.profiles` element contains information to create one
or more namespaces to an image description. The namespace can be
used with any of the above elements and therefore tie them into
a namespace which can be selected at call time of {kiwi}
Image Includes
--------------
.. code:: xml
<include from="file://filename.xml"/>
The optional :ref:`sec.include` element allows to drop in the contents
of the specified :file:`filename.xml` file at the place were the `include`
statement was specified in the document. The `include` statement is
only allowed as descendant of the root (top-level element) of the
image description.
|
