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

deb-bootc-compose needs packages for image creation
deb-orchestrator receives build requests and coordinates package building
deb-mock provides isolated build environments on each builder
deb-orchestrator executes builds in deb-mock-managed environments
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.

3.5 KiB Raw Permalink Blame History