robojerk/particle-os-tools
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Cleanup and archived things not in scope

Browse source
This commit is contained in:
robojerk 2025-07-14 01:48:14 -07:00
parent eb473b1f37
commit 5ac26d0800
39 changed files with 1433 additions and 27827 deletions
Download patch file Download diff file Expand all files Collapse all files

19
comparisons.md
View file

@ -8,11 +8,13 @@ This document compares Particle-OS tools against their official counterparts and
### **apt-layer (Particle-OS)**
- **Package Manager**: apt/dpkg (Ubuntu/Debian)
- **Backend**: ComposeFS (squashfs + overlayfs)
- **Architecture**: Layer-based with live overlay system
- **Backend**: ComposeFS (official tools, fallback to archived alternative)
- **Architecture**: Commit-based with atomic OSTree updates, robust overlay/dpkg install workflow
- **Target**: Ubuntu-based immutable systems
- **Features**:
- Atomic OSTree commit per package operation
- Live package installation without reboot
- Robust overlay/dpkg install (offline .deb support, DNS fixes)
- Container-based layer creation (Apx-style)
- OCI export/import integration
- Multi-tenant support
@ -67,15 +69,7 @@ This document compares Particle-OS tools against their official counterparts and
## 2. composefs-alternative vs Official ComposeFS
### **composefs-alternative (Particle-OS)**
- **Implementation**: Shell script wrapper around official tools
- **Features**:
- Image creation from directories
- Layer management and mounting
- Content verification with hash checking
- Integration with apt-layer and bootc-alternative
- Backup and rollback capabilities
- Multi-format support (squashfs, overlayfs)
### **composefs-alternative.sh** is now archived. Official ComposeFS tools (`mkcomposefs`, `mount.composefs`) are used by default for all atomic package management in apt-layer. Fallback to the alternative is available if needed.
**How composefs-alternative Handles Overlayfs**:
@ -478,3 +472,6 @@ The combination of apt-layer, composefs-alternative, bootc-alternative, dracut-m
**However**, the official tools offer **production-proven reliability** and **enterprise-grade stability** that should not be overlooked when choosing a solution for critical environments.
**Recommendation**: Use Particle-OS for **innovation and Ubuntu-specific features**, but consider official tools for **production-critical deployments** where stability and community support are paramount.
## Archive and Workspace Status
All test/fix scripts have been archived and the workspace is clean. Only essential scripts and documentation remain in the root directory.