OpenEuler CreateImage 架构解析从配置到 hooks 的核心工作原理【免费下载链接】CreateImageThe tool to create Machine Image项目地址: https://gitcode.com/openeuler/CreateImage前往项目官网免费下载https://ar.openeuler.org/ar/想要快速创建 openEuler 系统镜像吗OpenEuler CreateImage 正是您需要的强大工具这款开源工具能够自动化构建完整的机器镜像让系统部署变得前所未有的简单。无论您是系统管理员、开发人员还是云平台工程师掌握 CreateImage 的工作原理都将极大提升您的工作效率。本文将深入解析 CreateImage 的核心架构带您了解从配置到 hooks 的完整工作流程。️ CreateImage 整体架构概览OpenEuler CreateImage 采用模块化设计主要分为三个核心层次配置管理层、镜像构建层和hooks扩展层。这种分层架构使得工具既保持了核心功能的稳定性又具备了强大的扩展能力。核心组件结构整个项目的目录结构清晰地反映了其架构设计├── bin/ # 主程序入口 │ ├── create-image # 主构建脚本 │ └── dib-run-parts # hooks 执行器 ├── lib/ # 核心函数库 │ ├── common-functions # 通用功能函数 │ ├── img-functions # 镜像处理函数 │ └── die # 错误处理模块 ├── hooks/ # 扩展 hooks 系统 │ ├── root.d/ # 根文件系统准备阶段 │ ├── install.d/ # 软件包安装阶段 │ └── finalise.d/ # 镜像最终化阶段 └── config/ # 配置文件 ├── rpmlist # 默认软件包列表 └── grub.cfg # 引导配置模板 配置管理系统详解配置文件解析CreateImage 的配置系统非常灵活支持多种配置方式。核心配置文件config/rpmlist定义了默认安装的软件包列表包括 kexec-tools、net-tools、iproute 等基础组件。这个列表可以根据实际需求进行定制。参数传递机制主程序bin/create-image通过命令行参数接收配置信息支持以下关键参数-s指定 ISO 安装源路径-r指定 OBS 仓库源-d指定本地仓库目录-n自定义输出镜像名称-p设置 root 用户密码-l指定自定义的软件包列表文件这些参数通过环境变量传递到各个处理阶段确保配置信息在整个构建流程中保持一致。 镜像构建流程深度解析阶段一环境准备构建过程从create_base()函数开始该函数创建临时构建目录并初始化基础环境。关键步骤包括创建临时目录使用 mktemp 创建唯一的工作目录设置环境变量初始化TMP_BUILD_DIR、TMP_MOUNT_PATH等关键路径错误处理机制通过 trap 机制确保构建失败时能正确清理资源阶段二根文件系统创建hooks/root.d/01-create-root脚本负责创建基础的根文件系统挂载虚拟文件系统挂载 proc、dev、sys 等系统目录配置软件仓库根据输入源ISO、本地目录或远程仓库创建 yum 仓库配置安装基础系统使用 yum 安装 openEuler-release、basesystem、filesystem 等核心包架构适配根据不同 CPU 架构x86_64、aarch64、loongarch64、riscv64安装相应的引导工具阶段三软件包安装hooks/install.d/99-install-rpm负责处理自定义 RPM 包的安装。这个阶段支持从/tmp/in_target.d/rpms/目录自动安装额外的 RPM 包为镜像定制提供了极大灵活性。阶段四镜像最终化hooks/finalise.d/目录下的脚本执行最终的镜像处理10-genfstab生成文件系统挂载表20-setrootpwd设置 root 用户密码50-bootloader安装和配置引导程序97-clean-yumlog清理 yum 日志文件98-clean-tmp-repo清理临时仓库99-dib-run-parts执行最终的清理工作 Hooks 系统可扩展性的核心Hooks 执行机制CreateImage 的 hooks 系统是其可扩展性的核心。lib/common-functions中的run_d()函数负责执行指定阶段的 hooksfunction run_d () { check_hooks check_break before-$1 ${break_cmd:-bash} if [ -d ${TMP_HOOKS_PATH}/$1.d ]; then $SCRIPT_HOME/dib-run-parts ${TMP_HOOKS_PATH}/$1.d fi check_break after-$1 bash }三个阶段的生命周期root.d 阶段在 chroot 环境外执行负责创建基础文件系统install.d 阶段在 chroot 环境内执行安装软件包和配置finalise.d 阶段在镜像最终化前执行进行最后的调整和清理自定义 hooks 开发用户可以轻松添加自定义 hooks 来扩展功能。只需在相应的.d目录中创建可执行脚本CreateImage 就会按照数字前缀的顺序自动执行它们。例如要添加自定义网络配置可以创建hooks/install.d/20-custom-network。️ 多架构支持实现架构检测与适配CreateImage 通过arch命令自动检测当前系统架构并根据不同架构进行适配处理ARCHarch引导程序差异化处理不同架构需要不同的引导程序配置x86_64安装 grub2、grub2-efi-x64-modules、grub2-pc-modulesaarch64安装 grub2-efi-aa64-modulesloongarch64安装 grub2-efi-loongarch64-modulesriscv64安装 grub2-efi-riscv64、grub2-efi-riscv64-modules并额外安装 selinux-policy 和 policycoreutils分区方案统一所有架构都采用相同的分区方案5% 的 FAT16 引导分区和 95% 的 ext4 根分区确保跨架构的一致性。 镜像生成与优化磁盘镜像创建流程创建空白镜像使用 qemu-img 创建指定大小的 raw 镜像分区表创建使用 parted 创建 msdos 分区表分区格式化分别格式化引导分区FAT16和根分区ext4文件系统复制将构建好的系统文件复制到镜像中引导程序安装根据架构安装相应的引导程序性能优化措施lib/img-functions中的fstrim_image()函数负责优化镜像大小function fstrim_image () { sync sudo fstrim ${TMP_BUILD_DIR}/mnt }通过调用fstrim命令可以回收未使用的磁盘空间显著减小最终镜像的体积。️ 错误处理与资源管理健壮的错误处理CreateImage 实现了多层次错误处理机制set -eE脚本开头设置错误立即退出trap 机制注册清理函数确保资源正确释放详细的日志输出通过DEBUG_TRACE环境变量控制调试信息资源清理策略cleanup_build_dir()函数确保构建过程中创建的临时资源被正确清理function cleanup_build_dir () { if ! timeout 5 sh -c while ! sudo rm -rf $TMP_BUILD_DIR/built; do sleep 1; done; then echo ERROR: unable to cleanly remove $TMP_BUILD_DIR/built exit 1 fi rm -rf --one-file-system $TMP_BUILD_DIR losetup -D } 实际应用场景场景一快速创建基础镜像# 从 ISO 创建基础镜像 ./bin/create-image -s /path/to/openEuler.iso -n my-base-image场景二自定义软件包镜像# 创建包含自定义软件包的镜像 ./bin/create-image -s /path/to/openEuler.iso -l custom-rpmlist.txt -n custom-image场景三多架构镜像构建# 在不同架构的机器上自动适配构建 # x86_64 机器上会自动安装 x86 引导程序 # aarch64 机器上会自动安装 ARM 引导程序 ./bin/create-image -s /path/to/openEuler.iso 最佳实践建议1. 镜像大小优化在hooks/finalise.d/阶段清理不必要的文件使用fstrim回收未使用空间移除调试符号和文档文件以减小体积2. 安全性配置在hooks/finalise.d/20-setrootpwd中设置强密码移除默认的不安全服务配置防火墙规则和安全策略3. 性能调优优化文件系统参数配置合理的 swap 分区调整内核参数以适应目标环境4. 扩展性设计通过 hooks 系统添加自定义功能创建可重用的配置模板实现自动化测试和验证流程 未来发展方向OpenEuler CreateImage 作为 openEuler 生态中的重要工具未来可能在以下方面继续发展容器化支持增加对容器镜像的构建支持云原生集成更好地与 Kubernetes 和云平台集成性能优化进一步优化构建速度和镜像体积用户体验改进提供更友好的命令行界面和文档通过深入理解 CreateImage 的架构和工作原理您可以更好地利用这个工具来满足不同的镜像构建需求。无论是构建标准化的生产环境镜像还是创建高度定制的开发环境CreateImage 都提供了强大而灵活的基础设施。掌握这些核心概念后您将能够快速创建符合需求的 openEuler 镜像定制化扩展镜像功能优化镜像性能和安全性构建跨架构的统一镜像工作流开始使用 OpenEuler CreateImage让系统镜像构建变得简单高效✨【免费下载链接】CreateImageThe tool to create Machine Image项目地址: https://gitcode.com/openeuler/CreateImage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考