daviestechlabs/homelab-design
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
47 Commits 2 Branches 0 Tags
cbd892c7c9f82e8f3db2e77c7e088a0e82fdce2b
Commit Graph

26 Commits

Author SHA1 Message Date
Billy D.
e57d998d9a docs(adr): add ADR-0061 Go handler refactor 2026-02-19 07:14:36 -05:00
Billy D.
4537de7825 adding vualt for self signed pki stuff.
Some checks failed
Update README with ADR Index / update-readme (push) Failing after 12m52s
Details
2026-02-16 19:24:55 -05:00
Billy D.
f94945fb46 https.
All checks were successful
Update README with ADR Index / update-readme (push) Successful in 6s
Details
2026-02-16 18:22:16 -05:00
Billy D.
b4e608f002 updates to finish nfs-fast implementation.
All checks were successful
Update README with ADR Index / update-readme (push) Successful in 6s
Details
2026-02-16 18:08:38 -05:00
Billy D.
78c704728f update to homelab design to account for waterdeep.
All checks were successful
Update README with ADR Index / update-readme (push) Successful in 7s
Details
2026-02-16 15:42:05 -05:00
Billy D.
200cc5704b docs: update node inventory and 70B QLoRA feasibility analysis
All checks were successful
Update README with ADR Index / update-readme (push) Successful in 7s
Details
2026-02-15 11:19:22 -05:00
Billy D.
51e6cee8ab feat: ADR-0056 custom voice support, ADR-0057 Renovate per-repo configs
All checks were successful
Update README with ADR Index / update-readme (push) Successful in 6s
Details 
- ADR-0056: custom voice support in tts-module (VoiceRegistry)
- ADR-0057: shared Renovate preset rollout to all app repos
- Update ADR-0013: add tts-module and stt-module to CI table
- Update ADR-0036: cross-reference ADR-0057
 2026-02-13 15:31:33 -05:00
Billy D.
35f17d6342 docs: add ADR-0054 Kubeflow Pipeline CI/CD and ADR-0055 Internal Python Package Publishing
All checks were successful
Update README with ADR Index / update-readme (push) Successful in 6s
Details
2026-02-13 14:44:45 -05:00
Billy D.
5846d0dc16 docs: add ADRs 0043-0053 covering remaining architecture gaps
All checks were successful
Update README with ADR Index / update-readme (push) Successful in 6s
Details 
New ADRs:
- 0043: Cilium CNI and Network Fabric
- 0044: DNS and External Access Architecture
- 0045: TLS Certificate Strategy (cert-manager)
- 0046: Companions Frontend Architecture
- 0047: MLflow Experiment Tracking and Model Registry
- 0048: Entertainment and Media Stack
- 0049: Self-Hosted Productivity Suite
- 0050: Argo Rollouts Progressive Delivery
- 0051: KEDA Event-Driven Autoscaling
- 0052: Cluster Utilities (Spegel, Descheduler, Reloader, CSI-NFS)
- 0053: Vaultwarden Password Management

README updated with table entries and badge count (53 total).
 2026-02-09 18:37:14 -05:00
Billy D.
1bc602b726 docs(adr): add security ADRs for Gatekeeper, Falco, and Trivy
All checks were successful
Update README with ADR Index / update-readme (push) Successful in 6s
Details 
- ADR-0040: OPA Gatekeeper policy framework (constraint templates,
  progressive enforcement, warn-first strategy)
- ADR-0041: Falco runtime threat detection (modern eBPF on Talos,
  Falcosidekick → Alertmanager integration)
- ADR-0042: Trivy Operator vulnerability scanning (5 scanners enabled,
  ARM64 scan job scheduling, Talos adaptations)
- Update ADR-0018: mark Falco as implemented, link to detailed ADRs
- Update README: add 0040-0042 to ADR table, update badge counts
 2026-02-09 18:20:13 -05:00
Billy D.
8e3e2043c3 docs: add ADR-0038/0039 and replace llm-workflows references with decomposed repos
All checks were successful
Update README with ADR Index / update-readme (push) Successful in 6s
Details 
- ADR-0038: Infrastructure metrics collection (smartctl, SNMP, blackbox, unpoller)
- ADR-0039: Alerting and notification pipeline (Alertmanager → ntfy → Discord)
- Replace llm-workflows GitHub links with Gitea daviestechlabs org repos
- Update AGENT-ONBOARDING.md: remove llm-workflows from file tree, add missing repos
- Update ADR-0006: fix multi-repo reference
- Update ADR-0009: fix broken llm-workflows link
- Update ADR-0024: mark ray-serve repo as created, update historical context
- Update README: fix ADR-0016 status, add 0038/0039 to table, update badges
 2026-02-09 18:12:37 -05:00
Billy D.
29dc6ba326 docs(adr): mark ADR-0016 as accepted (Option A implemented)
All checks were successful
Update README with ADR Index / update-readme (push) Successful in 6s
Details
2026-02-09 17:44:34 -05:00
Billy D.
3a46a98be3 docs: add ADR index workflow, standardize all ADR formats
All checks were successful
Update README with ADR Index / update-readme (push) Successful in 6s
Details 
- Add Gitea Action to auto-update README badges and ADR table on push
- Standardize 8 ADRs from heading-style to inline metadata format
- Add shields.io badges for ADR counts (total/accepted/proposed)
- Replace static directory listing with linked ADR table in README
- Accept ADR-0030 (MFA/YubiKey strategy)
 2026-02-09 17:25:27 -05:00
Billy D.
dd277f6459 tuning up runner improvements. 2026-02-06 07:53:31 -05:00
Billy D.
80fb911e22 updating to match everything in my homelab. 2026-02-05 16:13:53 -05:00
Billy D.
f8787379c5 vaultwarden yubikey updates. 2026-02-04 15:15:14 -05:00
Billy D.
3580ee1223 docs: add ADRs 0029-0030 for Authentik registration and MFA 
- 0029: User registration workflow with approval and group-based access
- 0030: MFA and Yubikey strategy for Authentik and Vaultwarden
 2026-02-04 09:11:29 -05:00
Billy D.
b43c80153c docs: add ADRs 0025-0028 for infrastructure patterns 
- 0025: Observability stack (Prometheus + ClickStack + OTEL)
- 0026: Tiered storage strategy (Longhorn + NFS)
- 0027: Database strategy (CloudNativePG for PostgreSQL)
- 0028: Authentik SSO strategy (OIDC/SAML identity provider)
 2026-02-04 08:55:15 -05:00
Billy D.
a128c265e4 docs: Add ADRs for secrets management and security policy 
- 0017: Secrets Management Strategy (SOPS + Vault + External Secrets)
- 0018: Security Policy Enforcement (Gatekeeper + Trivy)
 2026-02-04 08:45:47 -05:00
Billy D.
8f4df84657 chore: Consolidate ADRs into decisions/ directory 
- Added ADR-0016: Affine email verification strategy
- Moved ADRs 0019-0024 from docs/adr/ to decisions/
- Renamed to consistent format (removed ADR- prefix)
 2026-02-04 08:28:12 -05:00
Billy D.
a2a426eb3b docs: add ADR-0015 for CI notifications and semantic versioning 2026-02-02 08:00:18 -05:00
Billy D.
730ab32b5d docs: add ADR-0014 for Docker build best practices 
Documents standardized Docker patterns:
- BuildKit syntax 1.7 with cache mounts
- uv for Python package installation (10-100x faster)
- OCI Image Spec labels
- HEALTHCHECK directives
- Non-root execution
- Version pinning with ranges

Complements ADR-0012 (uv) and ADR-0013 (CI/CD)
 2026-02-02 07:26:43 -05:00
Billy D.
5ba8138719 docs: add ADR-0013 for Gitea Actions CI/CD 2026-02-02 07:15:48 -05:00
Billy D.
598875c5a9 docs: add ADR-0011 (KubeRay), ADR-0012 (uv), update architecture docs 2026-02-02 07:10:47 -05:00
Billy D.
b6f7605fab docs: Update for decomposed repo structure 
- AGENT-ONBOARDING: New repo map with daviestechlabs Gitea repos
- TECH-STACK: Reference handler-base instead of llm-workflows
- CODING-CONVENTIONS: Update project structure for new repos
- ADR 0006: Update GitRepository examples for Gitea repos

llm-workflows has been split into:
- handler-base, chat-handler, voice-assistant
- kuberay-images, argo, kubeflow, mlflow, gradio-ui
 2026-02-02 05:58:35 -05:00
Billy D.
832cda34bd feat: add comprehensive architecture documentation 
- Add AGENT-ONBOARDING.md for AI agents
- Add ARCHITECTURE.md with full system overview
- Add TECH-STACK.md with complete technology inventory
- Add DOMAIN-MODEL.md with entities and bounded contexts
- Add CODING-CONVENTIONS.md with patterns and practices
- Add GLOSSARY.md with terminology reference
- Add C4 diagrams (Context and Container levels)
- Add 10 ADRs documenting key decisions:
  - Talos Linux, NATS, MessagePack, Multi-GPU strategy
  - GitOps with Flux, KServe, Milvus, Dual workflow engines
  - Envoy Gateway
- Add specs directory with JetStream configuration
- Add diagrams for GPU allocation and data flows

Based on analysis of homelab-k8s2 and llm-workflows repositories
and kubectl cluster-info dump data.
 2026-02-01 14:30:05 -05:00