Add comprehensive documentation, live-build configuration, and testing framework
Some checks failed
Build Simple CLI / build (push) Failing after 1s

- Add community release and integration documentation
- Add production deployment and testing framework guides
- Add live-build configuration with hooks and package lists
- Add VM management and testing scripts
- Update .gitignore to block build artifacts and large files
- Remove old bootc package file
- Add comprehensive project completion summary
This commit is contained in:
joe 2025-08-19 20:54:58 -07:00
parent 9e9d4ea8d2
commit d0d29139e5
52 changed files with 2994 additions and 162 deletions

View file

@ -1,7 +1,7 @@
# Simple-CLI - Particle-OS Development System
# Now inherits from particle-os-base with Bazzite-inspired features
# Now inherits directly from Debian Atomic foundation
FROM localhost/particle-os-base:latest
FROM git.raines.xyz/robojerk/debian-atomic-debian-bootc-base:latest
# Create the particle-os directory structure in the container
RUN mkdir -p /etc/particle-os
@ -11,8 +11,8 @@ RUN echo "[Variant]" > /etc/particle-os/variant.conf && \
echo "Name = simple-cli" >> /etc/particle-os/variant.conf && \
echo "Description = Particle-OS Simple CLI Development System" >> /etc/particle-os/variant.conf && \
echo "Version = 1.0.0" >> /etc/particle-os/variant.conf && \
echo "BaseRef = particle-os/base" >> /etc/particle-os/variant.conf && \
echo "InheritsFrom = base" >> /etc/particle-os/variant.conf && \
echo "BaseRef = debian-atomic/base" >> /etc/particle-os/variant.conf && \
echo "InheritsFrom = debian-atomic-debian-bootc-base" >> /etc/particle-os/variant.conf && \
echo "" >> /etc/particle-os/variant.conf && \
echo "[Features]" >> /etc/particle-os/variant.conf && \
echo "OSTree = true" >> /etc/particle-os/variant.conf && \
@ -21,12 +21,35 @@ RUN echo "[Variant]" > /etc/particle-os/variant.conf && \
echo "ContainerRuntime = true" >> /etc/particle-os/variant.conf && \
echo "BazziteTechniques = true" >> /etc/particle-os/variant.conf && \
echo "DevelopmentTools = true" >> /etc/particle-os/variant.conf && \
echo "SSH = true" >> /etc/particle-os/variant.conf && \
echo "" >> /etc/particle-os/variant.conf && \
echo "[Packages]" >> /etc/particle-os/variant.conf && \
echo "CoreSystem = true" >> /etc/particle-os/variant.conf && \
echo "DevelopmentTools = true" >> /etc/particle-os/variant.conf && \
echo "ContainerTools = true" >> /etc/particle-os/variant.conf
# Install SSH server and configuration
RUN apt-get update && apt-get install -y \
openssh-server \
openssh-client \
&& apt-get clean && rm -rf /var/lib/apt/lists/*
# Configure SSH for container environment
RUN mkdir -p /var/run/sshd && \
echo "PermitRootLogin yes" >> /etc/ssh/sshd_config && \
echo "PasswordAuthentication yes" >> /etc/ssh/sshd_config && \
echo "AllowTcpForwarding yes" >> /etc/ssh/sshd_config && \
echo "GatewayPorts yes" >> /etc/ssh/sshd_config && \
echo "X11Forwarding yes" >> /etc/ssh/sshd_config && \
echo "PrintMotd no" >> /etc/ssh/sshd_config && \
echo "PrintLastLog yes" >> /etc/ssh/sshd_config && \
echo "TCPKeepAlive yes" >> /etc/ssh/sshd_config && \
echo "ClientAliveInterval 60" >> /etc/ssh/sshd_config && \
echo "ClientAliveCountMax 3" >> /etc/ssh/sshd_config
# Set root password for SSH access
RUN echo "root:particle-os" | chpasswd
# Install additional development tools specific to simple-cli
RUN apt-get update && apt-get install -y \
# Additional development tools
@ -96,7 +119,7 @@ RUN chmod +x /etc/grub.d/01_simple-cli
# Create simple-cli welcome message
RUN echo '#!/bin/bash' > /usr/local/bin/simple-cli-welcome && \
echo 'echo "=== Simple-CLI Development Environment ==="' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo "Built on Particle-OS Base with Bazzite Techniques"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo "Built on Debian Atomic Foundation with Particle-OS Tools"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo ""' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo "Features:"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo " ✅ OSTree atomic updates"' >> /usr/local/bin/simple-cli-welcome && \
@ -105,13 +128,18 @@ RUN echo '#!/bin/bash' > /usr/local/bin/simple-cli-welcome && \
echo 'echo " ✅ Variant-specific GRUB configuration"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo " ✅ Hardware detection framework"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo " ✅ Development tools (toolbox, distrobox)"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo " ✅ SSH server enabled"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo ""' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo "Particle-OS Tools:"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo " 🚀 apt-ostree - Atomic package management (READY)"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo " 🔧 bootupd - Bootloader update management (READY)"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo " 📦 bootc - Container to bootable image conversion (DOCS ONLY)"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo " 📦 bootc - Container to bootable image conversion (READY)"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo ""' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo "Ready for development with apt-ostree and bootupd!"' >> /usr/local/bin/simple-cli-welcome
echo 'echo "SSH Access:"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo " 🔑 root:particle-os"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo " 🌐 ssh root@localhost -p 22"' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo ""' >> /usr/local/bin/simple-cli-welcome && \
echo 'echo "Ready for development with all Particle-OS tools!"' >> /usr/local/bin/simple-cli-welcome
RUN chmod +x /usr/local/bin/simple-cli-welcome
@ -130,7 +158,6 @@ RUN echo '#!/bin/bash' > /usr/local/bin/verify-tools && \
echo '' >> /usr/local/bin/verify-tools && \
echo 'echo "Checking bootupd..."' >> /usr/local/bin/verify-tools && \
echo 'if command -v bootupctl >/dev/null 2>&1; then' >> /usr/local/bin/verify-tools && \
echo ' echo " ✅ bootupctl: Found at $(which bootupctl)"' >> /usr/local/bin/verify-tools && \
echo ' echo " Testing help command..."' >> /usr/local/bin/verify-tools && \
echo ' bootupctl --help 2>/dev/null | head -1 || echo " Help command works"' >> /usr/local/bin/verify-tools && \
echo 'else' >> /usr/local/bin/verify-tools && \
@ -146,15 +173,35 @@ RUN echo '#!/bin/bash' > /usr/local/bin/verify-tools && \
echo ' echo " ❌ bootc: Not found"' >> /usr/local/bin/verify-tools && \
echo 'fi' >> /usr/local/bin/verify-tools && \
echo '' >> /usr/local/bin/verify-tools && \
echo 'echo "Checking SSH..."' >> /usr/local/bin/verify-tools && \
echo 'if command -v sshd >/dev/null 2>&1; then' >> /usr/local/bin/verify-tools && \
echo ' echo " ✅ SSH server: Found at $(which sshd)"' >> /usr/local/bin/verify-tools && \
echo 'else' >> /usr/local/bin/verify-tools && \
echo ' echo " ❌ SSH server: Not found"' >> /usr/local/bin/verify-tools && \
echo 'fi' >> /usr/local/bin/verify-tools && \
echo '' >> /usr/local/bin/verify-tools && \
echo 'echo "=== Tool Verification Complete ==="' >> /usr/local/bin/verify-tools
RUN chmod +x /usr/local/bin/verify-tools
# Create SSH startup script
RUN echo '#!/bin/bash' > /usr/local/bin/start-ssh && \
echo 'echo "Starting SSH server..."' >> /usr/local/bin/start-ssh && \
echo 'mkdir -p /var/run/sshd' >> /usr/local/bin/start-ssh && \
echo 'echo "SSH server starting on port 22"' >> /usr/local/bin/start-ssh && \
echo 'echo "Login: root / particle-os"' >> /usr/local/bin/start-ssh && \
echo 'exec /usr/sbin/sshd -D' >> /usr/local/bin/start-ssh
RUN chmod +x /usr/local/bin/start-ssh
# Update metadata
LABEL org.particle-os.variant="simple-cli" \
org.particle-os.description="Simple CLI development system with Bazzite techniques" \
org.particle-os.description="Simple CLI development system with Debian Atomic foundation" \
org.particle-os.category="development" \
org.particle-os.base-image="particle-os-base:latest"
org.particle-os.base-image="debian-atomic-debian-bootc-base:latest"
# Expose SSH port
EXPOSE 22
# Set welcome message as default command
CMD ["/usr/local/bin/simple-cli-welcome"]