Erich Blume
5b52f18356
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>
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** | `~/blumeops/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 `~/blumeops/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
|