1b307bcd17
- Add --podman option for isolated container testing (recommended) - Add --vm option for full VM isolation with virsh - Add --help option with comprehensive usage information - Add colored output and safety warnings - Add interactive prompts for direct host execution - Update usage-guide.sh with new safety features - Add proper error handling and command validation Features: - Podman containers with Ubuntu 24.04 and Debian 12 images - virsh VMs with proper networking and storage - Automatic repository cloning and script setup - Volume mounting for workspace sharing - Safety-first approach with clear warnings
83 lines
No EOL
3 KiB
Bash
Executable file
83 lines
No EOL
3 KiB
Bash
Executable file
#!/bin/bash
|
|
|
|
# Usage Guide for ostree Backport System
|
|
# This script provides information about the multi-distribution backport system
|
|
|
|
echo "=== ostree Backport System Usage Guide ==="
|
|
echo ""
|
|
|
|
echo "🎯 Supported Distributions:"
|
|
echo " • Ubuntu Noble (24.04 LTS) - Source: Ubuntu Questing"
|
|
echo " • Debian Trixie (12) - Source: Debian sid"
|
|
echo ""
|
|
|
|
echo "📦 Available Scripts:"
|
|
echo " • ostree-backport.sh [distro] - Main backport script"
|
|
echo " • backport-noble.sh - Ubuntu Noble wrapper"
|
|
echo " • backport-trixie.sh - Debian Trixie wrapper"
|
|
echo ""
|
|
|
|
echo "🚀 Quick Start Examples:"
|
|
echo ""
|
|
echo "For Ubuntu Noble:"
|
|
echo " ./backport-noble.sh --podman # Safe: Run in Podman container"
|
|
echo " ./backport-noble.sh --vm # Safe: Run in VM"
|
|
echo " ./backport-noble.sh # Direct: Run on host (not recommended)"
|
|
echo " ./ostree-backport.sh noble # Direct: Main script"
|
|
echo ""
|
|
echo "For Debian Trixie:"
|
|
echo " ./backport-trixie.sh --podman # Safe: Run in Podman container"
|
|
echo " ./backport-trixie.sh --vm # Safe: Run in VM"
|
|
echo " ./backport-trixie.sh # Direct: Run on host (not recommended)"
|
|
echo " ./ostree-backport.sh trixie # Direct: Main script"
|
|
echo ""
|
|
|
|
echo "🔧 What Each Script Does:"
|
|
echo " 1. Downloads ostree 2025.2-1 source from appropriate distribution"
|
|
echo " 2. Modifies changelog for backport versioning"
|
|
echo " 3. Installs build dependencies"
|
|
echo " 4. Builds all ostree packages"
|
|
echo " 5. Installs the backported packages"
|
|
echo ""
|
|
echo "🛡️ Safety Features:"
|
|
echo " • --podman: Run in isolated Podman container (recommended)"
|
|
echo " • --vm: Run in isolated VM with virsh (full isolation)"
|
|
echo " • --help: Show usage information and safety warnings"
|
|
echo " • Interactive prompts for direct host execution"
|
|
echo ""
|
|
|
|
echo "⚠️ Safety Notes:"
|
|
echo " • Test in a VM first"
|
|
echo " • Have a system backup"
|
|
echo " • Be prepared for potential side effects with Flatpak"
|
|
echo ""
|
|
|
|
echo "📚 Source References:"
|
|
echo " • Debian sid: https://packages.debian.org/source/sid/ostree"
|
|
echo " • Ubuntu Questing: http://archive.ubuntu.com/ubuntu/pool/universe/o/ostree/"
|
|
echo ""
|
|
|
|
echo "🔗 CI/CD Workflow:"
|
|
echo " • Automated builds on every push"
|
|
echo " • Supports both distributions via matrix strategy"
|
|
echo " • Manual trigger available for specific distributions"
|
|
echo ""
|
|
|
|
echo "📋 Package Contents:"
|
|
echo " • libostree-dev - Development headers and libraries"
|
|
echo " • libostree-1-1 - Runtime libraries"
|
|
echo " • ostree - Command-line tools"
|
|
echo " • gir1.2-ostree-1.0 - GObject introspection"
|
|
echo " • libostree-doc - Documentation"
|
|
echo " • ostree-boot - Boot utilities"
|
|
echo " • ostree-tests - Test suite"
|
|
echo ""
|
|
|
|
echo "✅ Verification:"
|
|
echo " pkg-config --modversion ostree-1"
|
|
echo " # Should output: 2025.2"
|
|
echo ""
|
|
|
|
echo "🔄 Rollback:"
|
|
echo " sudo apt install --reinstall libostree-dev libostree-1-1 ostree"
|
|
echo " # Reinstall original packages from distribution repositories" |