Debian Blue-Build CLI

A fork of blue-build/cli adapted for Debian package management and atomic image building.

Overview

Debian Blue-Build CLI provides a command-line interface for building Debian atomic images using recipe-based configuration, maintaining compatibility with the original blue-build system while adding Debian-specific functionality.

Features

• Debian package management (APT-based)
• Recipe-based image configuration
• OSTree composition support
• Bootc container generation
• Multi-format image output

Installation

# Clone the repository
git clone <repository-url>
cd blue-build-cli

# Install dependencies
pip install -r requirements.txt

# Install the CLI
pip install -e .

Usage

Basic Recipe

# recipe.yml
name: debian-server
version: 1.0.0
description: Debian server image

packages:
  - openssh-server
  - nginx
  - postgresql

repositories:
  - deb http://deb.debian.org/debian bookworm main
  - deb http://deb.debian.org/debian-security bookworm-security main

customizations:
  user:
    name: admin
    password: secure_password
  network:
    hostname: debian-server

Build Command

# Build image from recipe
debian-blue-build build recipe.yml

# Build with custom output format
debian-blue-build build recipe.yml --format qcow2

# Build with specific architecture
debian-blue-build build recipe.yml --arch amd64

Architecture

• Recipe Parser: YAML recipe processing
• Package Manager: APT-based package handling
• Image Builder: OSTree and container generation
• Output Formats: ISO, QCOW2, RAW, VMDK support

Development Status

• Core CLI: In development
• Debian Integration: Planning phase
• Recipe System: Basic structure
• Testing: Not started

Dependencies

• Python 3.8+
• OSTree tools
• Debian build tools
• Container tools (Docker/Podman)

Configuration

Configuration files are located in ~/.config/debian-blue-build/.

Contributing

See CONTRIBUTING.md for development guidelines.