17.3 Description d'une image
KIWI a besoin d'une description d'image pour construire un type d'image. La description de l'image est un répertoire contenant au moins un fichier config.xml ou présentant une extension *.kiwi.
17.3.1 Contenu de la description d'une image
Le tableau suivant contient des informations supplémentaires facultatives. Toutefois, la majorité de ces informations sont obligatoires pour garantir le fonctionnement du prochain système d'exploitation :
Tableau 17.1 Fichiers et répertoires supplémentaires en vue de la description d'une image
Fichier/Répertoire
config/ config.sh
config.xml
config-cdroot.tgz
config-cdroot.sh
Description
Sous-répertoire facultatif. Contient des scripts Bash exécutés après l'installation de tous les paquetages de l'image.
Script de configuration facultatif créé lors de la création de l'extension physique.
Fichier de configuration pour chaque description d'image. Voir
Section 17.3.2 (p. 346).
Archive uniquement utilisée pour les images ISO.
Manipulation de données extraites de config-cdroot.tgz
.
KIWI 345
Fichier/Répertoire
config-yast-autoyast.xml
config-yast-firstboot.xml
images.sh
root/
Description
Fichier de configuration créé par
AutoYaST
Fichier de configuration permettant de contrôler le service YaST Firstboot.
Script de configuration facultatif créé pendant la création de l'étape de préparation.
Contient d'autres répertoires, des fichiers spécifiques et des scripts modifiés après l'installation de tous les paquetages de l'image.
17.3.2 Le fichier config.xml
Toutes les informations relatives à la description d'une image sont stockées dans le fichier central XML de configuration config.xml. À chaque exécution de KIWI, le fichier config.xml est validé par rapport à un schéma RELAX NG (visitez le site http://www.relaxng.org
pour plus d'informations sur ce langage de schéma). Ainsi, il est recommandé d'utiliser un éditeur XML approprié prenant en charge le langage RELAX NG ou de se reporter à la documentation relative au schéma dans le fichier HTML /usr/share/doc/packages/kiwi/schema/ kiwi.xsd.html
.
Le fichier de configuration est divisé en plusieurs parties :
• Description de l'auteur, coordonnées et brève explication
• Options de préférence nécessaires dans le cadre de la phase d'extension logique
• Noms, répertoires privés et mots de passe des utilisateurs
• Liens d'accès aux dépôts
• Liste des paquetages utilisés pour le type d'image défini
346 Guide de déploiement
• Autres informations moins importantes indiquées dans le fichier HTML ci-dessus de la documentation sur le schéma RELAX NG
L'exemple suivant montre un élément paramétrable du fichier :
Exemple 17.1 Fichier de configuration de KIWI
<image schemeversion="2.0" name="...">
<description type="system">
<author>...</author>
<contact>...</contact>
<specification>...</specification>
</description>
<preferences>
<type primary="true" boot="..." flags="...">iso</type>
<type boot="..." filesystem="ext3" format="vmdk">vmx</type>
<type boot="..." filesystem="ext3">xen</type>
<type boot="..." filesystem="squashfs" flags="unified">oem</type>
<version>2.7.0</version>
<size unit="M">780</size>
<packagemanager>zypper</packagemanager>
<rpm-check-signatures>False</rpm-check-signatures>
<rpm-force>False</rpm-force>
<locale>en_US.UTF-8</locale>
<oem-swap>no</oem-swap>
<oem-boot-title>USB</oem-boot-title>
</preferences>
<users group="users">
<user name="root" pwd="" home="/root"/>
</users>
<repository type="rpm-md">
<source path="/home/rpmdir"/>
</repository>
<packages type="image" patternPackageType="onlyRequired">
<package name="yast2-live-installer"/>
<package name="pam"/>
<!-- List of packages reduced -->
</packages>
Élément racine de tous les fichiers de configuration de KIWI. Chaque fichier doit comporter un numéro de version. Un attribut facultatif kiwirevision peut
être utilisé pour spécifier une révision SVN de KIWI.
Contient des descriptions obligatoires avec des informations sur l'auteur des descriptions de cette image, son adresse et une brève explication.
Contient des préférences obligatoires avec des informations sur la version de cette image, le gestionnaire de paquetages utilisé, les types d'images pris en charge et d'autres paramètres.
KIWI 347
