blumeops/docs/reference/services
Erich Blume 8d634861f6 C1: migrate cv + docs from minikube to indri-native (#342)
## Summary

Replace the cv (`cv.eblu.me`) and docs (`docs.eblu.me`) minikube Deployments with indri-native ansible roles. Caddy serves the extracted release tarballs directly via a new `kind: static` service-block — no daemon, no nginx pod, no ProxyGroup ingress on the request path. Mirrors the rationale of the recent devpi migration; part of the broader minikube wind-down.

## What's in this commit

- `ansible/roles/{cv,docs}` — sentinel-gated tarball download + extract into `~/{cv,docs}/content/`
- `ansible/roles/caddy/` — new `kind: static` branch in the Caddyfile template (encoded gzip, immutable cache headers for fingerprinted assets, optional `try_html` for Quartz-style clean URLs, optional per-path `download_paths` for the resume PDF's `Content-Disposition`)
- `ansible/playbooks/indri.yml` — wires `cv` and `docs` roles before `caddy`
- `service-versions.yaml` — both services flip to `type: ansible`. `docs.current-version` stays at `1.28.2` for this commit so `container-version-check` keeps passing while `containers/quartz/Dockerfile` still exists; it moves to the docs release tag in the cleanup commit
- `.forgejo/workflows/{cv-deploy,build-blumeops}.yaml` — deploy step now bumps `cv_version`/`docs_version` in the role defaults and pushes; running ansible + purging the Fly cache is manual from gilbert (matches devpi)
- Docs: `docs/how-to/operations/{cv,docs}-on-indri.md`, updated `docs/reference/services/{cv,docs}.md`, changelog fragment

## What is not in this commit

The dead artifacts. After PR review and successful cutover, a follow-up commit deletes:

- `argocd/apps/{cv,docs}.yaml` and `argocd/manifests/{cv,docs}/`
- `containers/cv/`, `containers/quartz/`
- `CONTAINER_TO_SERVICE['quartz']` mapping in `mise-tasks/container-version-check`
- bumps `docs.current-version` in `service-versions.yaml` to the release tag

## Cutover plan (manual, from gilbert, after review)

1. **Take down old:**
   - Remove the cv and docs Applications: `argocd app delete cv --cascade && argocd app delete docs --cascade`
   - Verify k8s namespaces gone: `kubectl --context=minikube-indri get ns | grep -E '^(cv|docs)\\b'` (should be empty)
   - Verify tailnet MagicDNS no longer advertises the VIPs: `nslookup cv.tail8d86e.ts.net` and `nslookup docs.tail8d86e.ts.net` should both fail
2. **Bring up new:**
   - `mise run provision-indri -- --tags cv,docs,caddy --check --diff` (already validated on branch)
   - `mise run provision-indri -- --tags cv,docs,caddy`
   - `fly ssh console -a blumeops-proxy -C "sh -c 'rm -rf /tmp/cache && nginx -s reload'"`
3. **Verify:** `mise run services-check` and the curl checks listed in `docs/how-to/operations/{cv,docs}-on-indri.md`
4. **Cleanup commit + merge.**

Total expected downtime: minutes (not the few-hour budget you authorized).

## Test plan
- [ ] `mise run provision-indri -- --tags cv,docs --check --diff` clean
- [ ] `mise run provision-indri -- --tags caddy --check --diff` shows only the cv + docs blocks changing as previewed in the PR thread
- [ ] After cutover: `cv.eblu.me`, `cv.ops.eblu.me`, `docs.eblu.me`, `docs.ops.eblu.me` all return 200
- [ ] `cv.eblu.me/resume.pdf` includes `Content-Disposition: attachment`
- [ ] A clean Quartz URL (e.g. `docs.eblu.me/explanation/agent-change-process`) resolves to the right page
- [ ] `mise run services-check` clean
- [ ] `mise run service-review --type ansible` shows cv and docs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: #342
2026-04-29 14:55:11 -07:00
..
1password.md Add how-to card for running 1Password backup 2026-03-11 18:17:45 -07:00
alloy.md Bump Grafana Alloy to v1.14.0 (#292) 2026-03-13 16:25:27 -07:00
argocd.md Fix stale docs and shell quoting in devpi start script 2026-03-15 19:25:27 -07:00
authentik.md Fix stale docs and shell quoting in devpi start script 2026-03-15 19:25:27 -07:00
automounter.md Review jellyfin and automounter services 2026-03-17 13:06:23 -07:00
borgmatic.md Add offsite backup for immich photo library to BorgBase (#315) 2026-03-27 19:43:05 -07:00
caddy.md Update docs for Caddy routing and direct WireGuard peering 2026-04-18 09:57:30 -07:00
cv.md C1: migrate cv + docs from minikube to indri-native (#342) 2026-04-29 14:55:11 -07:00
devpi.md Migrate devpi from minikube to indri (launchd) (#341) 2026-04-29 13:38:36 -07:00
docs.md C1: migrate cv + docs from minikube to indri-native (#342) 2026-04-29 14:55:11 -07:00
flyio-proxy.md Update docs for Caddy routing and direct WireGuard peering 2026-04-18 09:57:30 -07:00
forgejo-runner.md Upgrade forgejo-runner to v12.8, adopt server.connections, and clean up docs (#338) 2026-04-20 09:03:54 -07:00
forgejo.md Upgrade forgejo-runner to v12.8, adopt server.connections, and clean up docs (#338) 2026-04-20 09:03:54 -07:00
frigate.md Upgrade nvidia-device-plugin v0.18.2 → v0.19.0 and add reference card 2026-03-27 07:19:24 -07:00
grafana.md Restructure docs: consolidate, recategorize, and extract 2026-03-15 19:55:59 -07:00
immich.md Migrate Immich from Helm chart to kustomize manifests (v2.5.6 → v2.6.3) 2026-04-04 09:42:25 -07:00
jellyfin.md Review 12 reference docs: fix stale image refs, expand stubs, add cross-refs 2026-03-23 09:51:57 -07:00
kingfisher.md Build custom Kingfisher container from sporked deploy branch (#318) 2026-03-30 06:34:49 -07:00
kiwix.md
loki.md Review 12 reference docs: fix stale image refs, expand stubs, add cross-refs 2026-03-23 09:51:57 -07:00
mealie.md C0: docs — add mealie borg restore how-to 2026-04-24 19:04:28 -07:00
miniflux.md Review 12 reference docs: fix stale image refs, expand stubs, add cross-refs 2026-03-23 09:51:57 -07:00
navidrome.md C0: review navidrome reference doc 2026-04-18 20:25:19 -07:00
ntfy.md Remove unused Mosquitto MQTT broker from ringtail 2026-03-11 18:37:31 -07:00
nvidia-device-plugin.md Upgrade nvidia-device-plugin v0.18.2 → v0.19.0 and add reference card 2026-03-27 07:19:24 -07:00
ollama.md
paperless.md Deploy Paperless-ngx document management (#328) 2026-04-08 17:54:12 -07:00
postgresql.md Remove superuser from teslamate PG role, transfer extension ownership 2026-04-07 15:36:39 -07:00
prometheus.md Review 12 reference docs: fix stale image refs, expand stubs, add cross-refs 2026-03-23 09:51:57 -07:00
prowler.md Add Prowler IaC scanning of blumeops repo (Saturday 2am) 2026-03-24 16:49:38 -07:00
snowflake-proxy.md Deploy Tor Snowflake proxy on ringtail (#311) 2026-03-24 20:51:40 -07:00
tempo.md Remove unused Mosquitto MQTT broker from ringtail 2026-03-11 18:37:31 -07:00
teslamate.md Remove superuser from teslamate PG role, transfer extension ownership 2026-04-07 15:36:39 -07:00
transmission.md C0: transmission doc — review and correct storage/monitoring details 2026-04-29 11:00:01 -07:00
zot.md Doc review: delete install-dagger-on-nix-runner, add service-versions ref card 2026-04-12 09:52:38 -07:00