10个实用debos示例 recipes：覆盖系统打包、分区管理与OSTree部署

【免费下载链接】debos Debian OS builder 项目地址: https://gitcode.com/gh_mirrors/de/debos

debos是一款强大的Debian OS构建工具，通过简单的YAML配置文件（recipes）即可自动化完成系统打包、分区管理、软件安装等复杂操作。本文精选10个实用示例，帮助新手快速掌握debos的核心功能，轻松构建自定义Linux系统镜像。

1. 基础系统打包：Debian最小系统构建

核心功能：使用debootstrap创建基础根文件系统并打包成压缩镜像

architecture: arm64
actions:
  - action: debootstrap
    suite: trixie
    components: [main]
    mirror: https://deb.debian.org/debian
    variant: minbase
  
  - action: apt
    packages: [sudo, openssh-server, systemd-sysv]
  
  - action: pack
    file: debian-base-arm64.tar.gz
    compression: gz

示例来源：doc/examples/ospack-debian/ospack-debian.yaml

这个示例展示了构建最小Debian系统的完整流程：从debootstrap初始化基础系统，到安装必要软件包，最后打包成可分发的tar.gz镜像。通过修改architecture参数，可轻松构建arm64或amd64架构的系统。

2. 高级分区管理：多分区GPT磁盘配置

核心功能：创建复杂分区结构的磁盘镜像，支持多种文件系统

architecture: amd64
actions:
  - action: image-partition
    imagename: test.img
    imagesize: 8G
    partitiontype: gpt
    mountpoints:
      - mountpoint: /
        partition: system
    partitions:
      - name: boot
        fs: ext2
        start: 0%
        end: 256M
      - name: system
        fs: ext4
        start: 256M
        end: 2G
      - name: data
        fs: ext4
        start: 2G
        end: 8G

示例来源：tests/partitioning/test.yaml

此示例演示了如何创建包含启动分区、系统分区和数据分区的GPT格式磁盘。通过start和end参数精确控制分区大小，支持ext2/ext4等多种文件系统，满足嵌入式设备或服务器的复杂存储需求。

3. Arch Linux系统构建：Pacstrap与软件管理

核心功能：使用pacstrap构建Arch Linux系统并安装软件包

architecture: amd64
actions:
  - action: pacstrap
    config: pacman.conf
    mirror: mirrorlist
  
  - action: pacman
    description: Install base packages
    packages:
      - procps
      - openssh

示例来源：tests/arch/test.yaml

debos不仅支持Debian系系统，还能构建Arch Linux。通过pacstrap动作初始化系统，pacman动作安装软件包，实现跨发行版的系统构建能力。

4. 文件系统叠加：多层目录合并

核心功能：使用overlay动作合并多个目录到根文件系统

architecture: amd64
actions:
  - action: unpack
    compression: gz
    file: base.tar.gz
  
  - action: overlay
    source: A
    destination: /opt/A
  
  - action: overlay
    source: B
    destination: /usr/local/B

示例来源：tests/recipes/simple/main.yaml

overlay动作允许将多个目录树合并到根文件系统，适合模块化构建系统。例如将配置文件、应用程序和数据文件分别放在不同目录，通过overlay动作组合成完整系统。

5. 脚本自动化：系统配置与初始化

核心功能：在chroot环境中执行脚本，完成系统定制

- action: run
  description: Setup user account
  chroot: true
  script: scripts/setup-user.sh

示例来源：doc/examples/ospack-debian/ospack-debian.yaml

通过run动作执行脚本是系统定制的关键。设置chroot: true可在目标根文件系统中运行脚本，完成用户创建、服务配置等初始化工作。示例中的setup-user.sh可包含添加用户、设置sudo权限等操作。

6. 原始数据写入：二进制文件部署

核心功能：将原始二进制数据写入指定分区

- action: raw
  description: Write bootloader
  origin: recipe
  file: blobs/blob1
  partition: boot
  offset: 512
  size: 1024

示例来源：tests/raw/test.yaml

raw动作允许将二进制文件（如引导加载程序）直接写入磁盘分区的指定位置，这对嵌入式系统开发尤为重要。通过offset和size参数精确控制写入位置和大小。

7. 条件编译：模板变量与动态配置

核心功能：使用Go模板语法实现条件编译和参数化构建

{{ $architecture := or .architecture "arm64" }}
{{ $suite := or .suite "trixie" }}

architecture: {{ $architecture }}
actions:
  - action: debootstrap
    suite: {{ $suite }}
    mirror: https://deb.debian.org/debian

示例来源：doc/examples/ospack-debian/ospack-debian.yaml

debos支持Go模板语法，可通过命令行参数动态调整构建配置。例如通过-t architecture=amd64参数覆盖默认架构，实现同一recipe构建不同架构的系统。

8. 错误处理：构建流程中的退出控制

核心功能：测试构建过程中的错误处理机制

- action: run
  description: Simulate failure
  command: exit 1
  post-failure: continue

示例来源：tests/exit_test/post-machine-failure.yaml

通过设置post-failure参数控制错误处理策略，可实现构建流程的健壮性。支持continue（继续执行）、abort（立即终止）和ignore（忽略错误）三种模式，满足不同场景的错误处理需求。

9. 包管理：Deb软件包安装

核心功能：直接安装本地Deb软件包到系统

- action: install-deb
  description: Install custom package
  origin: recipe
  file: my-package.deb

示例来源：tests/install-deb/test.yaml

install-deb动作提供了安装本地Deb软件包的便捷方式，无需通过APT仓库。这对开发自定义软件包或离线环境构建非常有用。

10. 模板文件处理：动态配置生成

核心功能：使用模板引擎生成配置文件

- action: overlay
  source: templates
  destination: /etc
  template: true

示例来源：tests/templating/test.yaml

启用template: true后，overlay动作会将源目录中的文件视为模板，使用Go模板语法生成最终配置文件。这允许根据构建参数动态调整配置，如生成适合不同硬件的网络配置文件。

如何开始使用这些示例

1. 克隆仓库：

git clone https://gitcode.com/gh_mirrors/de/debos
cd debos

2. 运行示例recipe：

debos doc/examples/ospack-debian/ospack-debian.yaml

3. 自定义修改：根据需求编辑YAML文件，调整分区大小、软件包列表或添加新动作

通过这些示例，您可以快速掌握debos的核心功能，构建从简单到复杂的各种Linux系统镜像。每个示例都可以作为独立模板，根据实际需求进行扩展和定制。

更多示例和详细文档，请参考项目中的tests/目录和官方文档。无论您是嵌入式开发者、系统管理员还是Linux爱好者，debos都能帮助您简化系统构建流程，提高工作效率。

【免费下载链接】debos Debian OS builder 项目地址: https://gitcode.com/gh_mirrors/de/debos