Files
htpc/README.md
T
bart 802f87c110
Sync HTPC Manifests to GitOps / Sync Manifests to GitOps Repo (push) Successful in 4s
feat(radarr): add Kubernetes manifests and migration script for Radarr
2026-10-18 14:52:50 +02:00

63 lines
2.6 KiB
Markdown

# 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.
---
## 🚀 Migratie van Host Services naar Kubernetes
### Radarr
Voor het migreren van de standalone `radarr.service` op `10.2.0.4` naar de Kubernetes pod is een geautomatiseerd script beschikbaar:
```bash
# Migratie uitvoeren (stopt host service, synct /storage/var/lib/radarr naar K8s PVC, start pod):
./migrate_radarr_to_cluster.sh
# Terugrollen naar standalone service indien gewenst:
./rollback_radarr_migration.sh
```
- **Dataopslag**: PersistentVolumeClaim `radarr-config` (10Gi, `local-path` op `/datadisk/infra/pv`).
- **Mediaopslag**: HostPath `/datadisk` gemount op `/datadisk` (voor films in `/datadisk/htpc/Films` en downloads in `/datadisk/upload`).
- **Netwerk & Ingress**: Luistert op poort `7878` (zowel via ClusterIP als HostPort `7878` op `10.2.0.4`), waardoor de bestaande Apache reverse proxy rule (`ProxyPass /radarr http://127.0.0.1:7878/radarr`) naadloos blijft functioneren.