Complete Phase 1 implementation of KubeSolo OS — an immutable, bootable Linux distribution built on Tiny Core Linux for running KubeSolo single-node Kubernetes. Build system: - Makefile with fetch, rootfs, initramfs, iso, disk-image targets - Dockerfile.builder for reproducible builds - Scripts to download Tiny Core, extract rootfs, inject KubeSolo, pack initramfs, and create bootable ISO/disk images Init system (10 POSIX sh stages): - Early mount (proc/sys/dev/cgroup2), cmdline parsing, persistent mount with bind-mounts, kernel module loading, sysctl, DHCP networking, hostname, clock sync, containerd prep, KubeSolo exec Shared libraries: - functions.sh (device wait, IP lookup, config helpers) - network.sh (static IP, config persistence, interface detection) - health.sh (containerd, API server, node readiness checks) - Emergency shell for boot failure debugging Testing: - QEMU boot test with serial log marker detection - K8s readiness test with kubectl verification - Persistence test (reboot + verify state survives) - Workload deployment test (nginx pod) - Local storage test (PVC + local-path provisioner) - Network policy test - Reusable run-vm.sh launcher Developer tools: - dev-vm.sh (interactive QEMU with port forwarding) - rebuild-initramfs.sh (fast iteration) - inject-ssh.sh (dropbear SSH for debugging) - extract-kernel-config.sh + kernel-audit.sh Documentation: - Full design document with architecture research - Boot flow documentation covering all 10 init stages - Cloud-init examples (DHCP, static IP, Portainer Edge, air-gapped) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
30 lines
790 B
YAML
30 lines
790 B
YAML
# KubeSolo OS Cloud-Init — Air-Gapped Deployment
|
|
# For environments with no internet access.
|
|
# All container images must be pre-loaded into containerd.
|
|
#
|
|
# Place at: /mnt/data/etc-kubesolo/cloud-init.yaml
|
|
|
|
hostname: airgap-node-01
|
|
|
|
network:
|
|
mode: static
|
|
interface: eth0
|
|
address: 10.0.0.50/24
|
|
gateway: 10.0.0.1
|
|
dns:
|
|
- 10.0.0.1
|
|
|
|
kubesolo:
|
|
local-storage: true
|
|
# Disable components that need internet
|
|
extra-flags: "--disable traefik --disable servicelb"
|
|
|
|
# Pre-loaded images (Phase 2+: auto-import at boot)
|
|
# Images must be placed as tar files on the data partition at:
|
|
# /mnt/data/images/*.tar
|
|
# They will be imported into containerd on first boot.
|
|
airgap:
|
|
import-images: true
|
|
images-dir: /mnt/data/images
|
|
# registry-mirror: "" # Optional: local registry mirror
|