Debian Bootc Ecosystem

Overview

This project creates Debian's complete bootc ecosystem - three foundational tools that work together to create Debian bootc images. This is Debian's answer to Fedora's Pungi-Koji-Mock ecosystem, designed to support Debian Atomic, Particle-OS, and other Debian bootc variants.

The Three Tools Working Together

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│ deb-bootc-      │    │ deb-orchestrator│    │    deb-mock     │
│   compose       │    │   (Koji equiv)  │    │   (Mock equiv)  │
│ (Pungi equiv)   │    │                 │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         │ 1. "I need packages" │                       │
         │──────────────────────▶│                       │
         │                       │                       │
         │                       │ 2. "Build this .deb" │
         │                       │──────────────────────▶│
         │                       │                       │
         │                       │ 3. "Environment ready"│
         │                       │◀──────────────────────│
         │                       │                       │
         │                       │ 4. "Build complete"   │
         │                       │◀──────────────────────│
         │                       │                       │
         │ 5. "Packages ready"   │                       │
         │◀──────────────────────│                       │

How the Tools Work Together

1. deb-bootc-compose (Pungi Equivalent)

• Role: Main orchestrator for Debian bootc image creation
• Purpose: Coordinates the entire compose process
• What it does: Manages image composition, OSTree creation, container generation

2. deb-orchestrator (Koji Equivalent)

• Role: Distributed build orchestration system
• Purpose: Manages package building at scale
• What it does: Coordinates builds across multiple builder hosts, manages build tasks

3. deb-mock (Mock Equivalent)

• Role: Chroot build environment manager
• Purpose: Creates isolated build environments
• What it does: Provides clean, reproducible chroot environments for package building

The Workflow

1. deb-bootc-compose needs packages for image creation
2. deb-orchestrator receives build requests and coordinates package building
3. deb-mock provides isolated build environments on each builder
4. deb-orchestrator executes builds in deb-mock-managed environments
5. deb-bootc-compose receives completed packages for image composition

Development Status

• Status: Foundation development (Phase 1)
• Timeline: Parallel development of all three tools
• Goal: Complete Debian bootc ecosystem in 18 months

Getting Started

See the parallel_projects directory for detailed information about each tool and the parallel development approach.