feat(htpc): initial repository structure and gitops workflow

2026-10-18 14:31:19 +02:00
commit e114b48528
5 changed files with 150 additions and 0 deletions
@@ -0,0 +1,49 @@
+# HTPC & Media Services Platform
+
+Beheert de configuratie, deployment en automatisering van de HTPC (Home Theater PC) en media-stack voor `bnhmeijer.nl` op `vmserver` (`10.2.0.4`).
+
+---
+
+## 🧭 Inhoudsopgave
+
+- [Overzicht](#-overzicht)
+- [Applicaties & Services](#-applicaties--services)
+- [Architectuur & Ingress](#-architectuur--ingress)
+- [Opslag & Mounts](#-opslag--mounts)
+- [GitOps & Deployment](#-gitops--deployment)
+
+---
+
+## 📌 Overzicht
+
+Deze repository bevat de Kubernetes manifests, configuraties en eventuele hulpscripts voor de HTPC mediadiensten. De workloads worden beheerd via GitOps (Gitea Actions en ArgoCD) binnen het homelab cluster.
+
+---
+
+## 🎬 Applicaties & Services
+
+De HTPC omgeving omvat onder andere de volgende diensten:
+
+| Service | Poort | Beschrijving |
+| :--- | :--- | :--- |
+| **Jellyfin** | `8096` | Media streaming en playback server voor films, series en muziek |
+| **Sonarr** | `8989` | Automatisch beheer en downloaden van tv-series |
+| **Radarr** | `7878` | Automatisch beheer en downloaden van speelfilms |
+| **Lidarr** | `8686` | Automatisch beheer en downloaden van muziek |
+| **Bazarr** | `6767` | Ondertitelbeheer en synchronisatie |
+| **Jackett / Prowlarr** | `9117` / `9696` | Torrent- en usenet indexer proxy |
+| **SABnzbd / Torrent** | `8080` / `8085` | Downloadclients voor media-acquisitie |
+
+---
+
+## 🏛️ Architectuur & Ingress
+
+- **SSL & Reverse Proxy**: Inkomend verkeer verloopt via de centrale Apache reverse proxy op `thuus.bnhmeijer.nl`.
+- **Authenticatie**: Beveiligd via Keycloak OIDC of ingebouwde service-authenticatie.
+- **Interne routering**: Envoy Gateway HTTPRoutes routeren verkeer direct naar de betreffende Kubernetes pods in de `htpc` namespace.
+
+---
+
+## 🔄 GitOps & Deployment
+
+Wijzigingen in de `k8s/` manifests worden automatisch gesynchroniseerd via Gitea Actions naar de centrale GitOps repository [`k8s-infra-vmserver`](https://git.bnhmeijer.nl/bart/k8s-infra-vmserver.git) onder `workloads/htpc/`, waarna ArgoCD deze reconcileert.