Commande distro_const

La syntaxe complète de la commande distro_const est la suivante :

distro_const build [-v] [-r checkpoint] [-p checkpoint] [-l] manifest

Le tableau suivant répertorie les options de la commande distro_const.

Tableau 3-1 Options de la commande distro_const

Création d'une image en une seule étape

1. Téléchargez le package distribution-constructor.
2. Sélectionnez un fichier manifeste adapté à votre image.
3. (Facultatif) Si nécessaire, personnalisez le fichier manifeste en ajoutant les références aux scripts personnalisés.
4. Connectez-vous en tant qu'utilisateur root.
5. Exécutez la commande de base distro_const sans options.

   # distro_const build manifest.xml

   Remplacez manifest par le nom du fichier manifeste à utiliser comme empreinte pour votre image.

   Par exemple :

   # distro_const build /usr/share/distro_const/dc_livecd.xml

   Le constructeur de distribution extrait les packages requis et génère l'image selon les spécifications définies dans le fichier manifeste.

6. (Facultatif) Au terme de la compilation, vous pouvez consulter un fichier journal contenant un rapport sur le processus.

   La sortie de compilation affiche l'emplacement des fichiers journaux.

Création d'une image en plusieurs étapes

Vous pouvez utiliser les options offertes par la commande distro_const pour arrêter et redémarrer le processus de génération d'image au niveau de différents points de contrôle, afin de vérifier la sélection de fichiers, packages et scripts, et de suivre une procédure de débogage le cas échéant.

1. Téléchargez le package distribution-constructor.
2. Sélectionnez un fichier manifeste adapté à votre image.
3. (Facultatif) Si nécessaire, personnalisez le fichier manifeste en ajoutant les références aux scripts personnalisés.
4. Connectez-vous en tant qu'utilisateur root.
5. Vérifiez les points de contrôle valides au niveau desquels vous pouvez choisir de suspendre ou relancer la compilation.

   # distro_const build -l manifest.xml

   Cette commande affiche les points de contrôle valides au niveau desquels vous pouvez interrompre ou reprendre la création d'une image. Utilisez les noms de points de contrôle fournis par cette commande comme valeurs correctes pour les autres options de commande de création de points de contrôle.

   Par exemple, la commande suivante confirme les points de contrôle disponibles pour un fichier manifeste nommé dc_livecd.xml.

   # distro_const build -l /usr/share/distro_const/dc_livecd.xml

   Checkpoint        Resumable Description
   --------------    --------- -------------
   transfer-ips-install X Transfer package contents from IPS
   set-ips-attributes   X Set post-installation IPS attributes
   pre-pkg-img-mod      X Pre-package image modification
   ba-init              X Boot archive initialization
   ba-config            X Boot archive configuration
   ba-arch              X Boot archive archiving
   grub-setup             Set up the GRUB menu
   pkg-img-mod            Package image area modifications
   create-iso             ISO image creation

   ---

   Remarque - Dans cet exemple de sortie de commande, une marque X dans le champ de reprise indique que vous pouvez relancer la création à partir de ce point de contrôle.

   ---

6. Créez l'image et suspendez la compilation au niveau du point de contrôle spécifié.

   # distro_const build -p checkpoint manifest

   Par exemple, la commande suivante lance la compilation d'une image et l'interrompt avant que im-mod ne modifie la zone d'image :

   # distro_const build -p ba-arch /usr/share/distro_const/dc_livecd.xml

7. Reprenez la compilation de l'image à partir d'un point de contrôle spécifié.

   # distro_const build -r checkpoint manifest

   ---

   Remarque - Le point de contrôle spécifié doit correspondre au point au niveau duquel la compilation antérieure a été interrompue ou à un point de contrôle précédent. Un point de contrôle ultérieur n'est pas valide.

   ---

   Par exemple, la commande suivante permet de reprendre la compilation de l'image à l'étape ba-arch.

   # distro_const build -r ba-arch /usr/share/distro_const/dc_livecd.xml

   ---

   Remarque - Vous pouvez combiner les options de suspension et de reprise dans une commande build.

   ---

8. (Facultatif) Au terme de la compilation, vous pouvez consulter un fichier journal contenant un rapport sur le processus.

   La sortie de compilation affiche l'emplacement des fichiers journaux.