feat: manage grafana content as code with fast dashboard workflow

README.md

@@ -152,6 +152,7 @@ This repository includes Gitea workflows for:
 - **terraform-plan**: Runs on PRs, shows planned changes
 - **terraform-apply**: Runs on main branch after merge
 - **ansible-deploy**: Runs after terraform apply
+- **dashboards**: Fast workflow that updates Grafana datasources/dashboards only
 
 ### Required Gitea Secrets
 
@@ -181,6 +182,8 @@ The Ansible playbook deploys a lightweight observability stack in the `observabi
 - `loki`
 - `promtail`
 
+Grafana content is managed as code via ConfigMaps in `ansible/roles/observability-content/`.
+
 Services are kept internal by default, with optional declarative Tailscale exposure when the Tailscale Kubernetes Operator is healthy.
 
 ### Access Grafana and Prometheus
@@ -228,6 +231,15 @@ kubectl -n tailscale-system logs deployment/operator --tail=100
 
 Common cause: OAuth client missing tag/scopes permissions.
 
+### Fast dashboard iteration workflow
+
+Use the `Deploy Grafana Content` workflow when changing dashboard/data source templates.
+It avoids full cluster provisioning and only applies Grafana content resources:
+
+- `ansible/roles/observability-content/templates/grafana-datasources.yaml.j2`
+- `ansible/roles/observability-content/templates/grafana-dashboard-k8s-overview.yaml.j2`
+- `ansible/dashboards.yml`
+
 ## File Structure
 
 ```
@@ -252,12 +264,14 @@ Common cause: OAuth client missing tag/scopes permissions.
 │   │   ├── ccm/
 │   │   ├── csi/
 │   │   ├── tailscale-operator/
+│   │   ├── observability-content/
 │   │   └── observability/
 │   └── ansible.cfg
 ├── .gitea/
 │   └── workflows/
 │       ├── terraform.yml
-│       └── ansible.yml
+│       ├── ansible.yml
+│       └── dashboards.yml
 ├── outputs/
 ├── terraform.tfvars.example
 └── README.md