Erich Blume
930f99d706
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>
50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
---
|
|
title: Docs
|
|
modified: 2026-04-29
|
|
last-reviewed: 2026-04-29
|
|
tags:
|
|
- service
|
|
- documentation
|
|
---
|
|
|
|
# Docs (Quartz)
|
|
|
|
Documentation site built with [Quartz](https://quartz.jzhao.xyz/).
|
|
|
|
## 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
|
|
|
|
- [[docs-on-indri]] — Operations how-to
|
|
- [[cv]] — Similar architecture
|
|
- [[forgejo]] — Build workflows
|