admin
0fcc7d8e6f
- hub/CHANGELOG.md: new file with v0.2.0 and prior version history - manifests/hub.yaml: add registry config (version checker + template fetcher), pin image to v0.2.0, remove stale /healthz TODO comment Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
128 lines
4.8 KiB
Markdown
128 lines
4.8 KiB
Markdown
# Felhom Hub — Changelog
|
|
|
|
## v0.2.0 (2026-02-20)
|
|
|
|
**Customer Configuration Management**
|
|
|
|
New "Configurations" section for pre-provisioning customer nodes. Operators can configure
|
|
customer settings in the Hub web UI, then `docker-setup.sh` downloads a ready-made
|
|
`controller.yaml` — reducing deployment to a customer ID and password.
|
|
|
|
### New features
|
|
|
|
- **Web UI — `/configs` pages:**
|
|
- List all customer configurations in a table
|
|
- Create new configuration: customer identity, infrastructure secrets (CF tunnel/API tokens),
|
|
git sync credentials, monitoring UUIDs — organized in collapsible sections
|
|
- Detail page: shows credentials (retrieval password, per-customer API key) with copy-to-clipboard,
|
|
setup commands (`docker-setup.sh` and `curl`), live YAML preview
|
|
- Edit and delete configurations
|
|
- Navigation tabs (Dashboard / Configurations) on all pages
|
|
|
|
- **Config retrieval API — `GET /api/v1/config/{customer_id}`:**
|
|
- Authenticated via `X-Retrieval-Password` header (separate from Bearer token)
|
|
- Generates complete `controller.yaml` by deep-merging template with customer overrides
|
|
- Template sourced from `controller.yaml.example` (fetched from Gitea repo periodically)
|
|
- Falls back to embedded default template if fetcher not configured
|
|
|
|
- **Per-customer API keys:**
|
|
- Each customer config gets its own API key (auto-generated, 64 hex chars)
|
|
- Controllers can authenticate with per-customer key instead of the shared global key
|
|
- Backward compatible — global `report_api_key` continues to work alongside per-customer keys
|
|
|
|
- **YAML generation (`internal/configgen` package):**
|
|
- Deep-merge of template + customer-specific overrides
|
|
- Programmatic injection: customer identity, hub config, session secret
|
|
- Shared by both API handler and web UI preview
|
|
|
|
- **Template fetcher (background goroutine):**
|
|
- Periodically fetches `controller.yaml.example` from Gitea (configurable interval)
|
|
- Requires `registry.username` + `registry.token` in hub.yaml
|
|
- Falls back to `go:embed` default template when not configured
|
|
|
|
- **Data layer:**
|
|
- New `customer_configs` SQLite table
|
|
- 6 CRUD methods: Save, Get, List, Delete, GetByAPIKey, UpdateRetrievalPassword
|
|
|
|
### Configuration
|
|
|
|
New `registry` section in `hub.yaml`:
|
|
|
|
```yaml
|
|
registry:
|
|
image: "gitea.dooplex.hu/admin/felhom-controller"
|
|
username: "" # Gitea credentials (for version checker + template fetcher)
|
|
token: ""
|
|
check_interval: "6h"
|
|
template_interval: "1h" # How often to refresh controller.yaml.example
|
|
```
|
|
|
|
### Files added
|
|
|
|
- `internal/configgen/configgen.go` — shared YAML generation package
|
|
- `internal/web/configs.go` — web handlers for config CRUD
|
|
- `internal/web/templatefetcher.go` — background template refresh
|
|
- `internal/web/controller.yaml.default` — embedded fallback template
|
|
- `internal/web/templates/configs.html` — config list page
|
|
- `internal/web/templates/config_form.html` — create/edit form
|
|
- `internal/web/templates/config_detail.html` — detail + credentials page
|
|
|
|
### Files modified
|
|
|
|
- `internal/store/store.go` — customer_configs table + CRUD methods
|
|
- `internal/api/handler.go` — config retrieval endpoint, per-customer auth, `ConfigTemplateProvider` interface
|
|
- `internal/web/server.go` — `/configs/*` routes, `SetTemplateFetcher()`
|
|
- `internal/web/embed.go` — embedded default template
|
|
- `internal/web/templates/dashboard.html` — navigation bar
|
|
- `internal/web/templates/customer.html` — navigation bar
|
|
- `internal/web/templates/style.css` — form, nav, button, credential styles
|
|
- `cmd/hub/main.go` — template fetcher wiring, `TemplateInterval` config
|
|
- `configs/hub.yaml.example` — registry section
|
|
|
|
---
|
|
|
|
## v0.1.8 (2026-02-16)
|
|
|
|
- Controller update trigger: "Update" button on customer detail page calls controller's self-update endpoint
|
|
- Registry version checker: background goroutine checks Gitea registry for latest controller image tag
|
|
- Update available indicator on customer detail page
|
|
|
|
## v0.1.7 (2026-02-15)
|
|
|
|
- Infrastructure backup endpoints for disaster recovery (POST + GET `/api/v1/infra-backup`)
|
|
|
|
## v0.1.6 (2026-02-14)
|
|
|
|
- Handle disabled reporting status
|
|
- Storage labels display
|
|
- Date in history table
|
|
|
|
## v0.1.5 (2026-02-13)
|
|
|
|
- Notification preferences sync endpoint (`POST /api/v1/preferences`)
|
|
- Notification display on customer detail page
|
|
|
|
## v0.1.4 (2026-02-12)
|
|
|
|
- Resend API key support for email notifications
|
|
- Notification endpoint (`POST /api/v1/notify`)
|
|
|
|
## v0.1.3 (2026-02-11)
|
|
|
|
- Customer detail page: system info, storage bars, container table
|
|
- 24h history graphs
|
|
|
|
## v0.1.2 (2026-02-10)
|
|
|
|
- Dashboard auto-refresh (60s cycle)
|
|
- Status logic (green/yellow/red based on report age + health)
|
|
|
|
## v0.1.1 (2026-02-09)
|
|
|
|
- Basic dashboard with customer overview table
|
|
- Report ingest API
|
|
|
|
## v0.1.0 (2026-02-08)
|
|
|
|
- Initial release: SQLite store, report API, basic web dashboard
|