eblume/blumeops
1
1
Fork 0
Code Issues Pull requests Projects Releases 83 Packages Wiki Activity Actions

Review 12 reference docs: fix stale image refs, expand stubs, add cross-refs

Browse source 
Replace hardcoded image tags in Quick Reference tables with pointers to
kustomization manifests (tags drift with every container release). Fix
Prometheus CNPG scrape target, remove misleading .ts.net URLs, expand
external-secrets stub, add backup/disaster-recovery cross-references.
Limit doc-reviewer agent to one doc per cycle.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Erich Blume 2026-03-23 09:51:57 -07:00
commit 06e721841c
14 changed files with 59 additions and 34 deletions
Download patch file Download diff file Expand all files Collapse all files

5
docs/reference/services/devpi.md
View file

@ -1,6 +1,7 @@
---
title: Devpi
modified: 2026-02-07
modified: 2026-03-23
last-reviewed: 2026-03-23
tags:
- service
- python
@ -18,7 +19,7 @@ PyPI caching proxy and private package index.
| **Namespace** | `devpi` |
| **ArgoCD App** | `devpi` |
| **Storage** | 50Gi PVC |
| **Image** | `registry.ops.eblu.me/blumeops/devpi:latest` |
| **Image** | `registry.ops.eblu.me/blumeops/devpi` (see `argocd/manifests/devpi/kustomization.yaml` for current tag) |
## Indices

16
docs/reference/services/docs.md
View file

@ -1,6 +1,7 @@
---
title: Docs
modified: 2026-02-08
modified: 2026-03-23
last-reviewed: 2026-03-23
tags:
- service
- documentation
@ -17,7 +18,7 @@ Documentation site built with [Quartz](https://quartz.jzhao.xyz/) and served via
| **Public URL** | https://docs.eblu.me |
| **Private URL** | `docs.ops.eblu.me` (tailnet only, via [[caddy]]) |
| **Namespace** | `docs` |
| **Container** | `registry.ops.eblu.me/blumeops/quartz:v1.0.0` |
| **Image** | `registry.ops.eblu.me/blumeops/quartz` (see `argocd/manifests/docs/kustomization.yaml` for current tag) |
| **Source** | `docs/` directory in blumeops repo |
| **Build** | Forgejo workflow `build-blumeops.yaml` |
| **Public proxy** | [[flyio-proxy]] (Fly.io → Tailscale tunnel) |
@ -31,13 +32,12 @@ Documentation site built with [Quartz](https://quartz.jzhao.xyz/) and served via
## Release Process
Documentation is automatically built and released when changes are pushed to main:
Documentation is built and released via the `build-blumeops` Forgejo workflow (manual dispatch):
1. Workflow detects changes in `docs/` directory
2. Quartz builds static HTML/CSS/JS
3. Assets uploaded as release attachment
4. ArgoCD deployment updated with new `DOCS_RELEASE_URL`
5. Pod restarts and downloads new bundle
1. Quartz builds static HTML/CSS/JS
2. Assets uploaded as Forgejo release attachment
3. Workflow updates `DOCS_RELEASE_URL` in `argocd/manifests/docs/deployment.yaml` and commits to main
4. ArgoCD syncs the updated deployment; new pod downloads the release bundle at startup
## Configuration

1
docs/reference/services/immich.md
View file

@ -1,6 +1,7 @@
---
title: Immich
modified: 2026-02-07
last-reviewed: 2026-03-23
tags:
- service
- media

1
docs/reference/services/jellyfin.md
View file

@ -1,6 +1,7 @@
---
title: Jellyfin
modified: 2026-02-07
last-reviewed: 2026-03-23
tags:
- service
- media

6
docs/reference/services/loki.md
View file

@ -1,6 +1,7 @@
---
title: Loki
modified: 2026-02-08
modified: 2026-03-23
last-reviewed: 2026-03-23
tags:
- service
- observability
@ -15,9 +16,8 @@ Log aggregation system for BlumeOps infrastructure.
| Property | Value |
|----------|-------|
| **URL** | https://loki.ops.eblu.me |
| **Tailscale URL** | https://loki.tail8d86e.ts.net |
| **Namespace** | `monitoring` |
| **Image** | `grafana/loki:3.4.2` |
| **Image** | `registry.ops.eblu.me/blumeops/loki` (see `argocd/manifests/loki/kustomization.yaml` for current tag) |
| **Storage** | 50Gi PVC |
| **Retention** | 31 days |

6
docs/reference/services/miniflux.md
View file

@ -1,6 +1,7 @@
---
title: Miniflux
modified: 2026-02-07
modified: 2026-03-23
last-reviewed: 2026-03-23
tags:
- service
- rss
@ -15,9 +16,8 @@ Minimalist RSS/Atom feed reader.
| Property | Value |
|----------|-------|
| **URL** | https://feed.ops.eblu.me |
| **Tailscale URL** | https://feed.tail8d86e.ts.net |
| **Namespace** | `miniflux` |
| **Image** | `ghcr.io/miniflux/miniflux:latest` |
| **Image** | `registry.ops.eblu.me/blumeops/miniflux` (see `argocd/manifests/miniflux/kustomization.yaml` for current tag) |
| **Database** | [[postgresql]] |
## Features

8
docs/reference/services/prometheus.md
View file

@ -1,6 +1,7 @@
---
title: Prometheus
modified: 2026-02-08
modified: 2026-03-23
last-reviewed: 2026-03-23
tags:
- service
- observability
@ -15,9 +16,8 @@ Metrics storage and querying for BlumeOps infrastructure.
| Property | Value |
|----------|-------|
| **URL** | https://prometheus.ops.eblu.me |
| **Tailscale URL** | https://prometheus.tail8d86e.ts.net |
| **Namespace** | `monitoring` |
| **Image** | `prom/prometheus:v3.2.1` |
| **Image** | `registry.ops.eblu.me/blumeops/prometheus` (see `argocd/manifests/prometheus/kustomization.yaml` for current tag) |
| **Storage** | 50Gi PVC |
| **Manifests** | `argocd/manifests/prometheus/` |
@ -33,7 +33,7 @@ Metrics storage and querying for BlumeOps infrastructure.
| Target | Metrics |
|--------|---------|
| `sifaka:9100` | [[sifaka|Sifaka]] NAS (node_exporter) |
| `cnpg-metrics.tail8d86e.ts.net:9187` | [[postgresql|CloudNativePG]] metrics |
| `blumeops-pg-metrics-tailscale.databases.svc.cluster.local:9187` | [[postgresql|CloudNativePG]] metrics |
| `kube-state-metrics.monitoring.svc:8080` | Kubernetes resource metrics |
## Related

8
docs/reference/services/teslamate.md
View file

@ -1,6 +1,7 @@
---
title: TeslaMate
modified: 2026-02-07
modified: 2026-03-23
last-reviewed: 2026-03-23
tags:
- service
- vehicle
@ -8,16 +9,15 @@ tags:
# TeslaMate
Self-hosted Tesla data logger collecting vehicle telemetry from the Tesla Owner API.
Self-hosted Tesla data logger collecting vehicle telemetry from the Tesla API.
## Quick Reference
| Property | Value |
|----------|-------|
| **URL** | https://tesla.ops.eblu.me |
| **Tailscale URL** | https://tesla.tail8d86e.ts.net |
| **Namespace** | `teslamate` |
| **Image** | `teslamate/teslamate:2.2.0` |
| **Image** | `registry.ops.eblu.me/blumeops/teslamate` (see `argocd/manifests/teslamate/kustomization.yaml` for current tag) |
| **Database** | [[postgresql]] |
## Data Collected