mirror of
https://github.com/casjaysdevdocker/blueonyx
synced 2026-05-15 02:47:44 -04:00
🔧 Fix blueonyx build scripts and add CLAUDE.md + PLAN.md 🔧
Some checks are pending
blueonyx / release-blueonyx (push) Waiting to run
Some checks are pending
blueonyx / release-blueonyx (push) Waiting to run
Fix two build-breaking issues in setup scripts and update BUILD_DATE. Add repo documentation files. - Dockerfile: update BUILD_DATE from 202509161146 to 202605131434 - rootfs/root/docker/setup/02-packages.sh: remove broken reboot and sudo dnf commands that abort Docker build; BlueOnyx installation is done in 05-custom.sh - rootfs/root/docker/setup/03-files.sh: remove irrelevant incus binary download from GitHub (fails in buildx sandbox; unrelated to BlueOnyx) - CLAUDE.md: new file documenting systemd-container architecture, build notes, runtime requirements, and env vars - PLAN.md: new file documenting migration steps, build command, smoke test procedure CLAUDE.md Dockerfile PLAN.md rootfs/root/docker/setup/02-packages.sh rootfs/root/docker/setup/03-files.sh
This commit is contained in:
48
PLAN.md
Normal file
48
PLAN.md
Normal file
@@ -0,0 +1,48 @@
|
||||
# blueonyx Migration Plan
|
||||
|
||||
## Status: In Progress
|
||||
|
||||
## Architecture decision
|
||||
BlueOnyx is a full RHEL-based server control panel that requires systemd.
|
||||
- Base: `almalinux/10-init` (systemd-enabled AlmaLinux 10)
|
||||
- Single-stage build (no FROM scratch stripping)
|
||||
- CMD: `/sbin/init` (systemd as PID 1)
|
||||
- No tini entrypoint; no init.d framework
|
||||
- amd64 only
|
||||
|
||||
## Steps
|
||||
|
||||
- [x] Read existing Dockerfile and all setup scripts
|
||||
- [x] Identify and fix `02-packages.sh` (remove `reboot`, `sudo dnf` lines)
|
||||
- [x] Identify and fix `03-files.sh` (remove irrelevant incus download)
|
||||
- [x] Update BUILD_DATE
|
||||
- [x] Create CLAUDE.md
|
||||
- [ ] Build image (`docker buildx build --platform linux/amd64`)
|
||||
- [ ] Smoke test (container starts, systemd runs, web UI reachable on port 444)
|
||||
- [ ] Commit and push
|
||||
|
||||
## Build command
|
||||
```bash
|
||||
cd /root/Projects/github/casjaysdevdocker/blueonyx
|
||||
docker buildx --builder blueonyx build \
|
||||
--platform linux/amd64 \
|
||||
--tag casjaysdevdocker/blueonyx:latest \
|
||||
--push .
|
||||
```
|
||||
|
||||
## Smoke test
|
||||
```bash
|
||||
docker run -d --privileged \
|
||||
-v /sys/fs/cgroup:/sys/fs/cgroup:rw \
|
||||
-p 10444:444 -p 10081:81 \
|
||||
--name test-blueonyx \
|
||||
casjaysdevdocker/blueonyx:latest
|
||||
# Wait 30s, check systemd is running
|
||||
docker exec test-blueonyx systemctl status 2>/dev/null | head -5
|
||||
docker rm -f test-blueonyx
|
||||
```
|
||||
|
||||
## Known limitations
|
||||
- Build takes 20-40 minutes (900-1200 RPMs from BlueOnyx + AlmaLinux repos)
|
||||
- `initServices.sh` may warn during build (no systemd at build time) — expected
|
||||
- Runtime requires `--privileged` and cgroup v2 mount
|
||||
Reference in New Issue
Block a user