Skip to content

v2.0.0

Choose a tag to compare

View all tags
@chadleeshaw chadleeshaw released this 13 Sep 16:03
· 120 commits to main since this release
v2.0.0
39104ef

🚀 Ignite v2.0.0 - Production-Ready PXE Server

🏆 Major Release Highlights

🧪 Comprehensive Testing Framework

  • Complete Unit Test Coverage across all packages with mock implementations
  • Integration Testing using QEMU for end-to-end PXE boot validation
  • 52.4% Test Coverage in vmtest package with 22 comprehensive test functions
  • Mock-Driven Testing with testify framework for reliable, isolated tests
  • Quality Assurance Pipeline with automated formatting and static analysis

💾 Advanced OS Image Management

  • Multi-OS Support: Ubuntu, NixOS, Red Hat, and custom distributions
  • Download Progress Tracking with real-time status monitoring
  • Version Control System with default version management
  • Background Download Processing with cancellation support
  • File Integrity Validation and error recovery mechanisms
  • Storage Optimization with deduplication and cleanup capabilities

⚙️ SYSLINUX Boot System

  • Dynamic Menu Generation with template-based configuration
  • Multi-Boot Support for BIOS and EFI systems
  • Advanced Boot Options: memtest, hardware diagnostics, rescue modes
  • Custom Boot File Management with automated deployment
  • Template Engine for flexible menu customization
  • Boot File Validation and integrity checking

🧪 VM-Based Integration Testing

cd vmtest
./setup-boot-files.sh    # One-time setup

# Test boot files with QEMU built-in TFTP
go run vmtest.go 1

# Test full ignite integration (DHCP + API + VM boot)
go run vmtest.go 2

# View detailed test logs and VM serial output
go run vmtest.go logs

# Clean up test artifacts
go run vmtest.go clean

Integration Tests Validate:

  • SYSLINUX boot file functionality
  • DHCP server API endpoints
  • Ignite web interface responsiveness
  • End-to-end PXE boot workflows
  • VM network boot scenarios with real hardware simulation

🐳 Production-Ready Docker Deployment

  • Multi-stage builds for minimal, secure containers
  • Non-root execution with dedicated user accounts
  • Health checks for monitoring and orchestration
  • Multi-architecture support (AMD64, ARM64)
  • Automated CI/CD with GitHub Actions

📚 Complete Visual Documentation

  • 7 Comprehensive Screenshots showcasing all major features
  • Detailed Architecture Guide explaining modular design
  • API Documentation with all 25+ endpoints documented
  • Developer Workflow instructions with testing guides

🖼️ Screenshot Gallery

Main Dashboard

Main Dashboard

DHCP Management

DHCP Management

TFTP File Management

TFTP File Management

Provision Templates

Provision Templates

OS Images Management

OS Images Management

SYSLINUX Configuration

SYSLINUX Configuration

System Status

System Status

🔬 Testing Capabilities

Unit Testing

go test ./...                    # Run all unit tests
go test -cover ./...             # Run with coverage analysis
go test -v -race ./...           # Run with race detection

Integration Testing

cd vmtest
go test -v                       # Run vmtest package tests
go run vmtest.go 1               # QEMU boot file validation
go run vmtest.go 2               # Full ignite integration test

Quality Assurance

gofmt -w .                       # Format code
go vet ./...                     # Static analysis

🎯 Core Features

Network Services

  • Integrated DHCP Server with dynamic IP allocation and lease management
  • Built-in TFTP Server for boot file serving with security controls
  • Redfish API Integration for remote server management and PXE initiation

Web Management Interface

  • Modern UI with responsive design and real-time updates
  • File Browser for TFTP directory management with upload/download
  • Template Editor with syntax highlighting for cloud-init/kickstart
  • System Monitoring with service status and health indicators

Advanced Boot Management

  • Dynamic PXE Menus with conditional logic and device detection
  • Multi-Architecture Support for x86_64, ARM64, and legacy systems
  • Boot Template Engine supporting Ubuntu, CentOS, NixOS, and custom OSes
  • Automated Provisioning with cloud-init and kickstart integration

🏗️ Architecture

Core Packages

  • app/: Application lifecycle with dependency injection
  • dhcp/: DHCP server with lease management and reservations
  • tftp/: TFTP server with security and file management
  • handlers/: HTTP API handlers with comprehensive error handling
  • routes/: Router configuration with middleware support

Specialized Components

  • osimage/: OS image management with download tracking and validation
  • syslinux/: SYSLINUX boot management with template generation
  • ipxe/: iPXE configuration with dynamic script generation
  • vmtest/: Integration testing framework with QEMU automation

🚀 Quick Start

Docker Deployment

docker run -d \
  -p 8080:8080 \
  -p 69:69/udp \
  -v $(pwd)/data:/app/data \
  -v $(pwd)/public:/app/public \
  ghcr.io/chadleeshaw/ignite:v2.0.0

Binary Installation

# Download for your platform
wget https://github.com/chadleeshaw/ignite/releases/download/v2.0.0/ignite-linux-amd64
chmod +x ignite-linux-amd64
./ignite-linux-amd64

Development Setup

git clone https://github.com/chadleeshaw/ignite.git
cd ignite
go mod download
go run . -mock-data    # Start with sample data

📋 Requirements

  • Go 1.21+ (tested with Go 1.23.4)
  • QEMU (optional, for integration testing)
  • Docker (optional, for containerized deployment)
  • curl for API testing and health checks

🔧 Configuration

All configuration via environment variables:

Variable Description Default
DB_PATH Database storage path ./data/
TFTP_DIR TFTP root directory ./public/tftp
HTTP_PORT Web interface port 8080
PROV_DIR Provisioning templates ./public/provision

🤝 Contributing

All contributions require:

  1. Comprehensive tests with mock implementations
  2. Code formatting using gofmt -w .
  3. Static analysis compliance via go vet ./...
  4. Documentation updates for new features

Development Workflow

# Quality checks
gofmt -w . && go vet ./...

# Full test suite
go test -v -race -cover ./...

# Integration testing
cd vmtest && go test -v

# Build and test
go build -o ignite .
./ignite -mock-data

📊 Test Coverage Statistics

  • Main Package: Comprehensive CLI and integration testing
  • App Package: Application lifecycle and dependency injection
  • DHCP Package: Server management and lease operations
  • TFTP Package: File serving and security validation
  • Handlers Package: HTTP API endpoint coverage
  • Routes Package: Router configuration and middleware
  • OSImage Package: Download management and file operations (22.6% coverage)
  • SYSLINUX Package: Boot file management and templates (4.3% coverage)
  • iPXE Package: Configuration generation and rendering (89.7% coverage)
  • VMTest Package: Integration testing framework (52.4% coverage)

🔗 Resources

  • Documentation: Complete architecture and API guides
  • Docker Hub: ghcr.io/chadleeshaw/ignite:v2.0.0
  • Binary Releases: Multi-platform downloads available
  • Integration Tests: QEMU-based validation framework
  • Screenshot Gallery: Visual feature documentation

Full Changelog: Complete testing infrastructure rewrite, comprehensive documentation updates, advanced OS image management, enhanced SYSLINUX capabilities, and production-ready quality improvements with Docker and CI/CD automation.

Assets 7
Loading