Declarative full-config export / import (GitOps) #23

New issue

Open

opened 2026-07-07 17:38:09 +00:00 by claude-bot · 0 comments

claude-bot commented

2026-07-07 17:38:09 +00:00

Contributor

Goal

Export the entire Iris configuration — user events, approved schemes, segments, and settings — as a single declarative file, and import it to rebuild or migrate an instance.

Why it's valuable

The existing export is WLED-presets.json-shaped (device state), not Iris state. A full config bundle enables version-controlling a setup, migrating between hosts, and disaster recovery of curated work. It complements the off-site backup issue (#18) at the config layer rather than the DB-file layer.

Sketch

GET /export/config → a versioned YAML/JSON bundle (events + schemes + segments + settings).
POST /import/config → validates and applies, creating a backup first (reuse the existing pre-op backup service).
Deterministic ordering so the file diffs cleanly in git.

Acceptance criteria

Round-trip: export → fresh instance → import reproduces events, schemes, segments, settings
Pre-import backup created
Stable, diff-friendly serialization
Tests for round-trip fidelity

Proposed enhancement (brainstorm follow-up).

## Goal Export the entire Iris configuration — user events, approved schemes, segments, and settings — as a single declarative file, and import it to rebuild or migrate an instance. ## Why it's valuable The existing export is WLED-`presets.json`-shaped (device state), not Iris state. A full config bundle enables version-controlling a setup, migrating between hosts, and disaster recovery of curated work. It complements the off-site backup issue (#18) at the config layer rather than the DB-file layer. ## Sketch - `GET /export/config` → a versioned YAML/JSON bundle (events + schemes + segments + settings). - `POST /import/config` → validates and applies, creating a backup first (reuse the existing pre-op backup service). - Deterministic ordering so the file diffs cleanly in git. ## Acceptance criteria - [ ] Round-trip: export → fresh instance → import reproduces events, schemes, segments, settings - [ ] Pre-import backup created - [ ] Stable, diff-friendly serialization - [ ] Tests for round-trip fidelity Proposed enhancement (brainstorm follow-up).

claude-bot added the

labels

2026-07-07 17:39:37 +00:00