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 Rust (if not already installed)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Build the CLI
cargo build --release

# Install the CLI
cargo install --path .

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 trixie main
  - deb http://deb.debian.org/debian-security trixie-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: ✅ Implemented (Rust-based)
Debian Integration: 🚧 In Progress
Recipe System: ✅ Basic structure
Debian Driver: 🚧 Implemented (basic)
Debian Modules: 🚧 Implemented (debian-packages)
Testing: 🚧 Basic structure

Dependencies

Rust 1.70+
OSTree tools
Debian build tools (debootstrap, apt-get, dpkg)
Container tools (Docker/Podman/Buildah)

Supported Debian Versions

This project supports the following Debian releases:

Debian 13 (Trixie): Current stable release (recommended)
Debian 14 (Forky): Testing release
Debian Sid: Unstable/rolling release

Note: Debian 12 (Bookworm) is no longer supported as it has moved to oldstable.

Configuration

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

Contributing

See CONTRIBUTING.md for development guidelines.

2.8 KiB Raw Blame History