apt-ostree

apt-ostree is a Debian/Ubuntu equivalent of rpm-ostree, providing atomic system updates, package management, and container image generation for Debian-based systems.

🎉 Major Milestone Achieved: Bootc Image Generation 100% Working!

The project has successfully implemented a complete bootc image generation system that creates OCI-compatible container images from OSTree trees. This feature enables users to generate container images that can be used with bootc and other container orchestration systems.

✅ What's Working Now

• Complete bootc image generation with OCI/Docker export
• Full OSTree integration for atomic deployments
• Real APT package management with dependency resolution
• System management commands (status, upgrade, rollback)
• Tree composition from YAML treefiles
• Multi-format container export (Docker archive, OCI)

🔄 In Progress

• D-Bus infrastructure for client-daemon communication
• Real-time transaction management
• Enhanced system monitoring

Features

🐳 Container Image Generation

# Generate a bootc-compatible container image
apt-ostree compose tree treefile.yaml --container --verbose

# The generated image includes:
# - Complete Debian system with APT tools
# - Bash shell and core utilities  
# - Systemd init system
# - All requested packages and dependencies
# - OCI-compatible metadata

📦 Package Management

# Install packages
apt-ostree install firefox-esr

# Search for packages
apt-ostree search "web browser"

# Uninstall packages
apt-ostree uninstall firefox-esr

🖥️ System Management

# Check system status
apt-ostree status

# Perform system upgrade
apt-ostree upgrade

# Rollback to previous deployment
apt-ostree rollback

🌳 Tree Composition

# Example treefile.yaml
ref: debian/13/x86_64
repos:
  - name: debian
    url: http://deb.debian.org/debian
packages:
  include:
    - bash
    - systemd
    - firefox-esr

Quick Start

Prerequisites

• Debian 13+ or Ubuntu 24.04+
• OSTree installed and configured
• Podman or Docker for container operations

Installation

# Clone the repository
git clone https://github.com/your-org/apt-ostree.git
cd apt-ostree

# Build the project
cargo build --release

# Test bootc image generation
./test-compose-container.sh

Generate Your First Image

# Create a minimal system
apt-ostree compose tree minimal-treefile.yaml --container --verbose

# Load and test the image
podman load -i output/test_minimal.tar
podman run --rm localhost/test/minimal:latest echo "Hello from bootc!"

Architecture

┌─────────────────┐    D-Bus    ┌─────────────────┐
│   CLI Client   │ ←────────→   │  apt-ostreed   │
│  (apt-ostree)  │              │    Daemon      │
└─────────────────┘              └─────────────────┘
        │                                │
        │                                │
        ▼                                ▼
┌─────────────────┐              ┌─────────────────┐
│  OSTree Tree   │              │  APT Package    │
│  Composition   │              │  Management     │
└─────────────────┘              └─────────────────┘
        │                                │
        │                                │
        ▼                                ▼
┌─────────────────────────────────────────────────┐
│            Container Generation                │
│         (OCI/Docker Export)                   │
└─────────────────────────────────────────────────┘

Documentation

• Project Overview - Comprehensive project status and architecture
• Bootc Image Generation - Complete guide to container image generation
• D-Bus Infrastructure - Client-daemon communication system
• Development Guide - Contributing to the project

Development

Containerized Development Environment

# Build development container
podman build -f Dockerfile.test -t apt-ostree-test .

# Interactive development
podman run --rm -it --privileged -v $(pwd):/workspace:z apt-ostree-test bash

# Run tests
cargo test
cargo check

Testing

# Run the comprehensive test suite
./test-compose-container.sh

# Individual component tests
cargo test --package apt-ostree

# Performance benchmarks
cargo bench

Performance

Build Performance

• Minimal system: 2-3 minutes
• Full desktop: 10-15 minutes
• Memory usage: 2-4GB during builds
• Disk usage: 5-10GB temporary space

Generated Images

• Minimal system: ~358MB
• Startup time: <5 seconds
• Memory footprint: 50-100MB base
• Full OCI compliance: Compatible with all OCI tools

Status

✅ Completed (100%)

• Bootc image generation
• OSTree tree composition
• APT package management
• System management commands
• Container export formats
• End-to-end testing

🔄 In Progress

• D-Bus daemon communication
• Real-time transaction management
• Enhanced error handling

⏳ Planned

• Multi-architecture support
• Performance monitoring
• CI/CD integration
• Registry push capabilities

Contributing

We welcome contributions! Please see our Development Guide for details on:

• Setting up the development environment
• Code style and standards
• Testing requirements
• Pull request process

Areas of Focus

• Core functionality: Command implementations
• Testing: Test coverage and validation
• Documentation: User and developer guides
• Performance: Optimization and benchmarking

License

This project is licensed under the GPL-3.0-or-later License - see the LICENSE file for details.

Acknowledgments

• rpm-ostree: Inspiration and reference implementation
• OSTree: Core atomic update system
• Debian/Ubuntu: Target platform and package ecosystem
• Rust community: Language and ecosystem support

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: docs/ directory

---

apt-ostree - Bringing atomic updates and container generation to Debian systems! 🚀