Deployment

Deployment Model

A 15-spoke Antora ecosystem deployed to Cloudflare Pages. Each spoke repository is independently authored and pushed; the hub aggregates them into a single site at docs.domusdigitalis.dev.

Spoke-Hub Architecture

domus-captures is one of 15 spoke repositories aggregated by domus-docs (the hub). Each spoke push triggers a Cloudflare Pages build automatically.

Push domus-docs only when changing:

antora-playbook.yml (component sources, site config)
ui-bundle.zip (Catppuccin theme, layout templates)

All other changes deploy by pushing the spoke itself.

15 Spoke Repositories

Repository	Purpose
domus-captures	Work logs, chronicles, education, codex, projects, standards
domus-infra-ops	Infrastructure operations runbooks
domus-ise-linux	802.1X EAP-TLS configuration and deployment
domus-netapi-docs	netapi CLI documentation
domus-secrets-ops	Secrets management (dsec, Vault, age)
domus-antora-ui	Catppuccin UI bundle for Antora
domus-ise-ops	ISE operations and policy management
domus-linux-ops	Linux operations and administration
domus-windows-ops	Windows operations and Active Directory
domus-automation-ops	Automation workflows and tooling
domus-identity-ops	Identity and access management
domus-o11y-ops	Observability, monitoring, and logging
domus-python	Python projects and learning
domus-musica	Music theory and practice documentation
ollama-local	Local LLM deployment and configuration

Repository

Purpose

domus-captures

Work logs, chronicles, education, codex, projects, standards

domus-infra-ops

Infrastructure operations runbooks

domus-ise-linux

802.1X EAP-TLS configuration and deployment

domus-netapi-docs

netapi CLI documentation

domus-secrets-ops

Secrets management (dsec, Vault, age)

domus-antora-ui

Catppuccin UI bundle for Antora

domus-ise-ops

ISE operations and policy management

domus-linux-ops

Linux operations and administration

domus-windows-ops

Windows operations and Active Directory

domus-automation-ops

Automation workflows and tooling

domus-identity-ops

Identity and access management

domus-o11y-ops

Observability, monitoring, and logging

domus-python

Python projects and learning

domus-musica

Music theory and practice documentation

ollama-local

Local LLM deployment and configuration

Deployment Workflow

Edit the spoke repository (e.g., domus-captures)
Commit changes
Push to GitHub
Cloudflare Pages auto-builds the full site

make push runs sync-nav and update-index before pushing, ensuring navigation and index pages are current.

Local Development

make serve builds the site and serves it on localhost:8000. Kroki runs at localhost:18000 for diagram rendering (D2, Graphviz, Mermaid, PlantUML). make for build-only without the local server.

URL Structure

This component is published at: docs.domusdigitalis.dev/captures/

Cross-component references use the double-colon syntax:

xref:infra-ops::runbooks/vyos-deployment.adoc[VyOS Deployment]
xref:ise-linux::02-pki/certificate-enrollment.adoc[PKI Enrollment]