Erich Blume 5b52f18356 cv+docs: relocate content under ~/blumeops/{cv,docs}

Keeps blumeops-managed state grouped under a single namespace in the
home dir rather than scattered top-level dirs. Caddy block paths are
derived from cv_content_dir / docs_content_dir, so the role-defaults
edit propagates automatically.

Validated end-to-end on indri: tarballs extracted to the new paths,
sentinels written, second run is idempotent. Old ~/cv and ~/docs from
the earlier validation run were removed.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-29 14:54:01 -07:00

2.9 KiB

Raw Blame History

title

modified

last-reviewed

Docs on Indri

How the Quartz documentation site (docs.eblu.me) is deployed on indri natively. Replaces the prior minikube Deployment; same shape as cv-on-indri with one extra wrinkle for Quartz's clean URLs.

Why native, not Kubernetes

The docs site is fully static HTML produced by Quartz. Caddy can serve the extracted tarball directly. The Quartz-specific behavior the previous nginx container provided (try_files $uri $uri/ $uri.html =404 and a custom /404.html) maps cleanly to Caddy's try_files and handle_errors.

Layout

Concern	Path / detail
Content dir	`/Users/erichblume/blumeops/docs/content/`
Version sentinel	`/Users/erichblume/blumeops/docs/.installed-version`
Caddy entry	`docs` service in `ansible/roles/caddy/defaults/main.yml` (`kind: static`, `try_html: true`)
Public URL	`https://docs.eblu.me` (via flyio-proxy)
Private URL	`https://docs.ops.eblu.me` (Caddy on indri)
Tarball source	Forgejo release asset on the blumeops repo (`docs-<version>.tar.gz`)

docs_version in ansible/roles/docs/defaults/main.yml is the blumeops release tag (e.g. v1.16.0). The role's download/extract is gated by an on-disk sentinel.

Deploy

Run the Build BlumeOps Forgejo workflow → builds the tarball, creates a release, bumps docs_version in the ansible role, pushes to main
From gilbert: mise run provision-indri -- --tags docs
From gilbert: fly ssh console -a blumeops-proxy -C "sh -c 'rm -rf /tmp/cache && nginx -s reload'"

The Caddy block uses try_files {path} {path}/ {path}.html and a handle_errors 404 → /404.html rewrite, matching the original nginx behavior so Quartz's clean URLs continue to work.

Verify

ssh indri 'cat ~/blumeops/docs/.installed-version'
ssh indri 'ls ~/blumeops/docs/content/'
curl -fsSI https://docs.ops.eblu.me/                                # private
curl -fsSI https://docs.eblu.me/                                    # public
curl -fsSI https://docs.eblu.me/explanation/agent-change-process    # clean URL → .html fallback
curl -fsSI https://docs.eblu.me/no-such-path-exists/                # → /404.html

Bumping the docs version

Normally driven by the workflow. If you need to pin manually, edit docs_version in ansible/roles/docs/defaults/main.yml and re-run mise run provision-indri -- --tags docs.

Backup

Content dir is not borgmatic-backed. Source is in this repo; release tarballs are on the forge.

Rollback

Set docs_version back to the previous release tag in the role defaults and re-run. Older release tarballs remain available as Forgejo release assets.

cv-on-indri — sibling service, simpler (no try_html)
devpi-on-indri — pattern reference for indri-native services
docs — service reference

2.9 KiB Raw Blame History