Oz 项目技术文档

1. 安装指南

Oz 是一套用于自动化操作系统安装的程序和类库。它能够创建包含操作系统的虚拟机磁盘镜像，并且可以选择性地包含程序。

制作 RPM 包

推荐的安装方式是使用以下命令制作 RPM 包：

make rpm
# 或者
make srpm

然后，在目标机器上安装生成的 RPM 包。这种方式很可能只在 Fedora 或 RHEL 8 或更高版本上工作。

安装 RPM 包

在 RPM 包制作完成后，您需要在目标机器上安装该 RPM 包：

rpm -ivh your_package.rpm

2. 项目的使用说明

在 RPM 包安装完毕后，您需要构建 TDL (Task Description Language) 文件作为构建过程的输入。请参考 examples 目录下的示例来了解 TDL 文件的样子。

3. 项目 API 使用文档

Oz 项目的具体 API 使用说明目前未在文档中提供。通常情况下，您需要阅读项目源代码中的相关模块和函数注释来获取 API 的详细信息。

4. 项目安装方式

以下是在不同系统上安装 Oz 项目的方法：

在 Fedora 上安装

dnf install python3-requests python3-cryptography python3-libvirt python3-lxml python3-libguestfs python3-pytest python3-monotonic

在 EL 7 上安装

yum install python-requests python-cryptography libvirt-python python-lxml python-libguestfs pytest python-monotonic

运行单元测试

您可以运行以下命令来执行单元测试：

• 在容器中运行单元测试：

make container-unittests

• 清理容器和镜像：

make container-clean

• 直接在宿主机上运行单元测试：

首先确保安装了所有测试依赖：

# Fedora
dnf install python3-requests python3-cryptography python3-libvirt python3-lxml python3-libguestfs python3-pytest python3-monotonic

# EL 7
yum install python-requests python-cryptography libvirt-python python-lxml python-libguestfs pytest python-monotonic

然后运行测试：

py.test tests/

使用虚拟环境运行测试

您也可以尝试使用以下命令在虚拟环境中运行测试：

make virtualenv
make unittests

请注意，这仍然需要在宿主机上安装 libguestfs 库，并确保 libvirtd 在运行。

代码风格检查

您可以使用以下命令运行代码风格检查：

make pylint
make flake8

以上是关于 Oz 项目的详细技术文档。希望对您有所帮助。