distro_const 命令

distro_const 命令的完整语法如下所示：

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

查看以下命令选项。

表 3-1 distro_const 命令选项

如何一步构建映像

开始之前

下载 distribution-constructor 软件包并为映像选择清单。如果需要，对清单进行定制并添加定制脚本。

1. 成为 root 角色。
2. 要运行映像的完整创建而不暂停，请使用不带选项的基本 distro_const 命令，如下所示：

   # distro_const build manifest

   ---

   注 - 需要 build 子命令。

   ---

   使用要用作映像蓝图的清单文件的名称替换 manifest。

   例如，键入以下命令：

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

3. 分发构造器为映像获取所需的软件包。
4. 分发构造器根据您在清单文件中设置的规范构建映像。
5. 可选构建完成后，可以查看用于报告构建过程的日志文件。

   构建输出会显示日志文件的位置。

如何分阶段构建映像

您可以使用 distro_const 命令中提供的选项停止和重新启动处于映像生成过程中各个阶段的创建过程，以便检查和调试针对要创建的映像选择的文件、软件包和脚本。此过程使用 distro_const 命令中提供的检查点选项，如以下基本说明中所述。

1. 成为 root 角色。
2. 构建映像之前，检查可以选择暂停或恢复构建映像的有效检查点。

   # distro_const build -l manifest.xml

   ---

   注 - 需要 build 子命令。

   ---

   该命令显示可以暂停或恢复构建映像的有效检查点。对于其他检查点命令选项，将该命令提供的检查点名称用作有效值。

   例如，以下命令确认在给定名为 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                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

   ---

   注 - 在该命令输出样例中，可恢复字段中的 "X" 表示可以从该检查点重新启动构建。

   ---

3. 构建映像，然后在指定的检查点上暂停构建映像。

   # distro_const build -p checkpoint_name manifest

   ---

   注 - 需要使用 build 子命令以及 checkpoint_name 和 manifest 字段。

   ---

   例如，以下命令启动构建映像，并在 ba-arch 修改映像区域之前暂停构建：

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

4. 从指定的检查点恢复构建映像。

   # distro_const build -r checkpoint_name manifest

   ---

   注 - 指定的检查点必须是上一次构建停止执行的检查点，或者是更早的检查点。以后的检查点无效。需要使用 checkpoint_name 和 manifest 字段以及 build 子命令。

   ---

   例如，以下命令在 ba-arch 阶段恢复构建映像。

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

   ---

   注 - 可以在 build 命令中组合使用暂停和恢复选项。

   ---

5. 可选构建完成后，可以查看用于报告构建过程的日志文件。

   构建输出会显示日志文件的位置。