文档
 / 17.3. 映像说明
上一页17.2. 了解 KIWI 的构建进程17.4. 使用 KIWI 创建设备下一页

映像说明

KIWI 构建映像类型需要映像说明。映像说明是一个目录，包含至少一个文件 config.xml，或者扩展名为 *.kiwi。

映像说明的内容

下表包含其他可选信息。但是，多数信息对于较新的操作系统的功能来说是必需的：

表 17.1. 映像说明的其他文件和目录

文件/目录

说明

config/

可选子目录。包含在安装所有映像包之后执行的 Bash 脚本。

config.sh

创建物理扩展时的可选配置脚本

config.xml

每个映像说明的配置文件，在第 17.3.2 节中说明

config-cdroot.tgz

存档，仅用于 ISO 映像

config-cdroot.sh

操作从 config-cdroot.tgz 解压缩的数据

config-yast-autoyast.xml

由 AutoYaST 创建的配置文件

config-yast-firstboot.xml

用于控制 YaST 首次启动服务的配置文件

images.sh

创建准备步骤时的可选配置脚本

root/

包含安装所有映像包之后更改的其他目录、特殊文件和脚本


config.xml 文件

关于映像说明的所有信息储存在中心配置 XML 文件 config.xml 中。每次执行 KIWI 时，会对照 RELAX NG 纲要验证 config.xml（有关此纲要语言的更多信息，请参见 http://www.relaxng.org）。因此建议使用支持 RELAX NG 的适当 XML 编辑器或使用 HTML 文件 /usr/share/doc/packages/kiwi/schema/kiwi.xsd.html 中关于该纲要的文档。

该配置文件包括几个部分：

  • 关于作者的一些说明、联系信息和简短注释。

  • 逻辑扩展阶段所需的自选设置选项。

  • 关于用户的信息，其名称、用户主目录及其密码。

  • 到安装源的链接。

  • 用于定义的映像类型的包的列表。

  • 等等可以在 RELAX NG 纲要文档的 HTML 文件中查看的不太重要的信息。

以下示例显示了该文件的一个框架：

例 17.1. KIWI 配置文件

<image schemeversion="2.0" name="..."> 1
  <description type="system"> 2
    <author>...</author>
    <contact>...</contact>
    <specification>...</specification>
  </description>
  <preferences> 3
    <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"> 4
    <user name="root" pwd="" home="/root"/>
  </users>
  <repository type="rpm-md"> 5
    <source path="/home/rpmdir"/>
  </repository>
  <packages type="image" patternPackageType="onlyRequired"> 6
    <package name="yast2-live-installer"/>
    <package name="pam"/>
    <!-- List of packages reduced -->
  </packages>

1

每个 KIWI 配置文件的 root 元素。每个文件都需要版本号。可以使用可选的 kiwirevision 属性指定 KIWI 的 SVN 版本。

2

包含必需的说明，其中包括关于此映像说明的创建者的信息、其联系地址和一些简短说明。

3

创建必需的自选设置，其中包括关于此映像版本的信息、使用的包管理器、支持的映像类型和其他设置。

4

可选的 users 元素包含添加到此映像的所有用户的列表。user 元素包含名称、用户主目录的路径、密码和外壳。

5

包含由包管理器使用的必需安装源的列表。

6

包含映像中的必需包列表。

有关该配置文件的更多细节在上述 HTML 页面中显示。

上一页17.2. 了解 KIWI 的构建进程起始页17.4. 使用 KIWI 创建设备下一页