eblume/blumeops
1
1
Fork 0
Code Issues Pull requests Projects Releases 83 Packages Wiki Activity Actions
blumeops/docs/reference/services/docs.md
Erich Blume 930f99d706 C1: migrate cv + docs from minikube to indri-native (deploy artifacts) 
Replaces the cv and docs minikube Deployments with ansible roles that
download release tarballs into ~/cv/content and ~/docs/content on indri.
Caddy now serves those directories directly via a new kind=static
service-block in the Caddy template; no daemon, no nginx pod, no
ProxyGroup ingress on the request path.

This commit adds the deploy-side artifacts only. Live cutover (delete
argocd apps, run ansible, verify) is staged manually after PR review;
the dead containers/{cv,quartz} and argocd manifests are removed in a
follow-up commit so each commit is internally consistent.

Workflows are simplified: the deploy step now bumps the role's pinned
version and pushes; running ansible + purging the Fly cache is manual
from gilbert (matches the devpi pattern).

service-versions.yaml: cv and docs are type=ansible. docs current-version
remains 1.28.2 for now to keep container-version-check passing while
containers/quartz still exists; will move to the docs release tag in the
cleanup commit.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-29 14:33:57 -07:00

1.7 KiB
Raw Blame History

title modified last-reviewed tags
Docs 2026-04-29 2026-04-29
service
documentation

Docs (Quartz)

Documentation site built with Quartz.

Quick Reference

Property Value
Public URL https://docs.eblu.me (via flyio-proxy)
Private URL docs.ops.eblu.me (Caddy on indri)
Deployment Ansible role docs on indri (no daemon — Caddy serves files directly)
Content dir ~/docs/content/ on indri
Source docs/ directory in blumeops repo
Build Forgejo workflow build-blumeops.yaml

Migrated from minikube to indri-native on 2026-04-29 (see docs-on-indri).

Architecture

  1. Source: Markdown files in docs/ with Obsidian-compatible wiki-links
  2. Build: Build BlumeOps Forgejo workflow runs towncrier + Quartz, uploads tarball as a release asset, and bumps docs_version in the ansible role
  3. Deploy: ansible role downloads the tarball into ~/docs/content/ on indri; Caddy serves the directory directly with Quartz-style try_files (path → path/ → path.html → 404.html)

Configuration

  • Quartz config: quartz.config.ts
  • Layout: quartz.layout.ts
  • Ansible role: ansible/roles/docs/
  • Caddy entry: ansible/roles/caddy/defaults/main.yml (kind: static, try_html: true)

Release flow

  1. Run the Build BlumeOps workflow → builds tarball, creates release, bumps docs_version in the ansible role and pushes
  2. Run mise run provision-indri -- --tags docs from gilbert
  3. Purge the Fly.io proxy cache so the new content is fetched

Related