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.

2.3 KiB Raw Blame History