scaffold: hub-and-spoke layout, 4-network topology, 13 stack stubs
Initial structure for R&D infrastructure:
- stacks/ — 13 reusable, runnable stack stubs (kebab-case)
cloud-and-edge: node-red, influxdb, grafana, keycloak, portainer,
nginx-proxy, mqtt, postfix
cloud-only: wireguard-server, gitea, jenkins, sql (postgres stub)
edge-only: wireguard-client
- cloud/ — single central hub composition with 4 networks
(edge, app, data internal, mgmt) and include: stubs
- sites/ — per-plant edge folders (template README only for now)
- docs/architecture.md — hub-and-spoke + ingress + segmentation rationale
Network model: only nginx-proxy (80/443/8883) and wireguard-server
(51820/udp) publish ports on the cloud host. Edge nginx publishes
80/443 on plant-LAN interface only. MQTT cloud-side via nginx stream
proxy; MQTT edge-side internal-only; Postfix outbound-only.
OT layer (OPCUA, PLCs) is out of scope for this repo.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-21 12:37:59 +02:00
|
|
|
# grafana
|
|
|
|
|
|
|
|
|
|
Dashboard UI. Cloud-side = central observability. Edge-side = plant-local SCADA.
|
|
|
|
|
|
|
|
|
|
- **Networks**: `app` (reachable from nginx-proxy) + `data` (queries influxdb)
|
|
|
|
|
- **Volume**: `grafana-data` (sqlite, plugins, sessions)
|
|
|
|
|
- **Config**: `./config/provisioning` (datasources + dashboards as code) — add once SQL/Influx are wired
|
2026-05-21 18:34:37 +00:00
|
|
|
- **Hostname**: `dash.wbd-rd.nl`
|
|
|
|
|
|
|
|
|
|
## Auth
|
|
|
|
|
|
|
|
|
|
Keycloak OIDC via Grafana's `generic_oauth` provider. All env-driven (see `cloud/.env.example`):
|
|
|
|
|
|
|
|
|
|
| Env var | Purpose |
|
|
|
|
|
|---|---|
|
|
|
|
|
| `GRAFANA_OAUTH_CLIENT_ID` / `_SECRET` | Keycloak `grafana` client credentials |
|
|
|
|
|
| `GF_AUTH_GENERIC_OAUTH_*` | Provider URLs + claim mapping (set inline in `compose.yml`) |
|
|
|
|
|
|
|
|
|
|
### Role mapping
|
|
|
|
|
|
|
|
|
|
`GF_AUTH_GENERIC_OAUTH_ROLE_ATTRIBUTE_PATH` interprets the Keycloak `realm_access.roles` claim:
|
|
|
|
|
|
|
|
|
|
| Keycloak realm role | Grafana org role |
|
|
|
|
|
|---|---|
|
|
|
|
|
| `app-admin` *or* `grafana-admin` | Admin |
|
|
|
|
|
| `grafana-editor` | Editor |
|
|
|
|
|
| (none of the above) | Viewer |
|
|
|
|
|
|
|
|
|
|
So a fresh teammate added to the `wbd` realm lands as a Viewer. Grant them `app-admin` (or `grafana-editor`) in Keycloak to promote.
|
|
|
|
|
|
|
|
|
|
`GF_AUTH_GENERIC_OAUTH_ALLOW_SIGN_UP=true` auto-creates the Grafana user on first OIDC login.
|
|
|
|
|
|
|
|
|
|
## TODO
|
|
|
|
|
|
|
|
|
|
- Datasource provisioning (`./config/provisioning/datasources/` — Influx, postgres)
|
|
|
|
|
- Dashboard-as-code baseline (`./config/provisioning/dashboards/`)
|
|
|
|
|
- Plugin pin list
|
