Commande distro_const

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

Syntax: distro_const build [-v] [-r checkpoint_name] [-p checkpoint_name] [-l] manifest

Examinez les options de commande suivantes.

Tableau 3-1 Options de la commande distro_const

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

Avant de commencer

Téléchargez le package distribution-constructor et sélectionnez le fichier manifeste pour votre image. Si nécessaire, personnalisez le fichier manifeste et ajoutez des scripts personnalisés.

1. Connectez-vous en tant qu'utilisateur root.
2. Pour exécuter la création complète d'une image sans interruption, utilisez la commande distro_const de base sans option, comme suit :

   # distro_const build manifest

   ---

   Remarque - La sous-commande build est requise.

   ---

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

   Entrez par exemple la commande suivante :

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

3. Le constructeur de distribution récupère les packages nécessaires pour l'image.
4. Le constructeur de distribution crée l'image selon les spécifications définies dans le fichier manifeste.
5. (Facultatif) Une fois la compilation terminée, vous pouvez afficher un fichier journal contenant un rapport sur le processus de compilation.

   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 création à différentes étapes du processus de génération d'image, afin de contrôler et de déboguer votre sélection de fichiers, packages et scripts pour l'image en cours de création. Ce processus utilise les options de création de points de contrôle disponibles dans la commande distro_const, comme décrit dans les instructions de base ci-dessous.

1. Connectez-vous en tant qu'utilisateur root.
2. Avant de créer l'image, vérifiez les points de contrôle valides auxquels vous pouvez choisir de suspendre ou reprendre la compilation.

   # distro_const build -l manifest.xml

   ---

   Remarque - La sous-commande build est requise.

   ---

   Cette commande affiche les points de contrôle valides auxquels 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

   Une fois la commande exécutée, les points de contrôle valides s'affichent. Par exemple, des points de contrôle peuvent inclure les éléments suivants.

   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                Boot archive initialization
   ba-config              Boot archive configuration
   ba-arch                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 reprendre la création à partir de ce point de contrôle.

   ---

3. Créez l'image et mettez la compilation en pause au point de contrôle spécifié.

   # distro_const build -p checkpoint_name manifest

   ---

   Remarque - La sous-commande build, ainsi que les champs nom_point_contrôle et manifeste sont obligatoires.

   ---

   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

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

   # distro_const build -r checkpoint_name manifest

   ---

   Remarque - Le point de contrôle spécifié doit être le point de contrôle auquel 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. Les champs nom_point_contrôle et manifeste et la sous-commande build sont requis.

   ---

   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.

   ---

5. (Facultatif) Une fois la compilation terminée, vous pouvez afficher un fichier journal contenant un rapport sur le processus de compilation.

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