docs: add Mermaid architecture diagrams#1485
Open
ixxeL2097 wants to merge 4 commits into
Open
Conversation
- Enable Mermaid support in mkdocs.yml via pymdownx.superfences custom_fences - index.md: global homelab architecture overview (two clusters, GitHub, key services) - argocd.md: GitOps reconciliation loop, App-of-Apps pattern, Helm value hierarchy; update directory structure to reflect current common/beelink/genmachine layout - talos.md: Talos cluster topology (3 control-plane VMs on Proxmox, etcd, Cilium) - certmanager.md: PKI chain from Vault Root CA to TLS Secret via cert-manager - externalsecrets.md: ESO → Vault Kubernetes auth flow; fix incomplete intro sentence - oidc.md: OIDC authorization code flow and group claim injection via scope mappings - proxy-auth.md: Traefik forward-auth flow with Authentik outpost and header passthrough - vault.md (new): Vault cross-cluster transit auto-unseal, seal migration, deadlock recovery, Kubernetes auth flow; added to mkdocs.yml nav under Secrets Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…table - Full page redesign: hero section, tabbed badges per cluster, stack table - Two Mermaid diagrams: infrastructure topology (layered TB graph with all components grouped by plane) and request flow (DNS → Traefik → ForwardAuth → app) - Badges reorganized into pymdownx.tabbed tabs (beelink vs genmachine) - Stack table listing every major component with its role Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
mise manages all CLI tools (kubectl, helm, vault, sops, talosctl, etc.) and Python/Node runtimes. uv manages Python packages declared in pyproject.toml; the .venv is auto-activated via mise's _.python.venv. First-time setup: mise install && task setup (or uv sync + helm/krew plugins) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…agrams - vault.md: remove Transit Auto-Unseal and Seal Migration sections; keep PKI/KV overview and Kubernetes auth flow - index.md: remove transit auto-unseal arrow from architecture diagram - README.md: replace Excalidraw SVG images with native GitHub Mermaid diagrams; fix traefik beelink badge URL (was pointing to old k0s path); reorganize badges by cluster; add GitOps flow diagram and stack table Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
ixxeL2097
force-pushed
the
main
branch
10 times, most recently
from
99be2b4 to
0ff926a
Compare
ixxeL2097
force-pushed
the
main
branch
3 times, most recently
from
5248ff3 to
5c29049
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
pymdownx.superfencescustom fencesvault.mdpagecommon/+beelink//genmachine/directory structureDiagrams added
index.mdargocd/argocd.mdcluster/talos.mdcertificates/certmanager.mdsecrets/externalsecrets.mdsecrets/vault.md(new)authentication/oidc.mdauthentication/proxy-auth.mdTest plan
mkdocs build)vault.mdpage appears in nav under Secrets🤖 Generated with Claude Code