bart/htpc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(slskd): add slskd deployment, service, pvc and migration scripts
Sync HTPC Manifests to GitOps / Sync Manifests to GitOps Repo (push) Successful in 4s
Details

Browse Source
This commit is contained in:
bart
2026-10-30 08:17:49 +01:00
parent 43c54f18b8
commit 78f5707aac
8 changed files with 349 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+16
View File
@@ -33,6 +33,7 @@ De HTPC omgeving omvat onder andere de volgende diensten:
| **Bazarr** | `6767` | Ondertitelbeheer en synchronisatie |
| **Jackett / Prowlarr** | `9117` / `9696` | Torrent- en usenet indexer proxy |
| **SABnzbd / Transmission** | `8080` / `9091` | Downloadclients voor media-acquisitie (BitTorrent peer-poort `53662`) |
| **slskd** | `5030` / `50300` | Soulseek peer-to-peer client en web daemon (HTTP: `5030`, Soulseek listen: `50300`) |
---
@@ -67,3 +68,18 @@ De BitTorrent daemon (`transmission`) draait als pod in de `htpc` namespace:
- **Dataopslag**: PersistentVolumeClaim `transmission-config` (10Gi, `local-path` op `/datadisk/infra/pv`), gemigreerd vanuit `/var/www/.config/transmission-daemon` met behoud van alle torrents, resume-bestanden en instellingen.
- **Mediaopslag**: HostPath `/datadisk` en `/mnt/mp3` zodat `/datadisk/upload/finished` en `/datadisk/upload/incomplete` identiek zijn voor Transmission, Radarr, Sonarr en Lidarr.
- **Netwerk**: Web UI / RPC op poort `9091` (ClusterIP + HostPort `9091`) en BitTorrent peer-poort `53662` (TCP & UDP, ClusterIP + HostPort `53662`).
### slskd
De Soulseek daemon (`slskd`) draait als pod in de `htpc` namespace:
- **Dataopslag**: PersistentVolumeClaim `slskd-config` (10Gi, `local-path` op `/datadisk/infra/pv`), gemigreerd vanuit `/var/www/.local/share/slskd` via een init-container (inclusief `slskd.yml`, SQLite databases en state).
- **Mediaopslag**: HostPath `/datadisk` gemount op `/datadisk` (voor `/datadisk/upload/slskd`, `/datadisk/upload/incomplete` en `/datadisk/htpc/mp3`) en `/mnt/mp3` gemount op `/mnt/mp3`.
- **Netwerk**: Web UI op poort `5030` (ClusterIP + HostPort `5030`), optioneel HTTPS op poort `5031` en Soulseek listen poort `50300` (ClusterIP + HostPort `50300`).
- **Migratie & Opruimen**:
```bash
# Migratie uitvoeren (maakt backup in /storage/backups/, stopt host service, start pod):
./migrate_slskd_to_cluster.sh
# Oude host bestanden en service opruimen:
./cleanup_old_slskd.sh
```
cleanup_old_slskd.sh
Executable
+58
View File
@@ -0,0 +1,58 @@
#!/usr/bin/env bash
# ==============================================================================
# Opruimen van oude standalone slskd installatie op vmserver (10.2.0.4)
# ==============================================================================
set -euo pipefail
CLUSTER_HOST="10.2.0.4"
SSH_USER="bart"
COLOR_GREEN="\033[0;32m"
COLOR_YELLOW="\033[1;33m"
COLOR_RED="\033[0;31m"
COLOR_BLUE="\033[0;34m"
COLOR_RESET="\033[0m"
log_info() { echo -e "${COLOR_GREEN}[INFO]${COLOR_RESET} $1"; }
log_step() { echo -e "\n${COLOR_BLUE}==>${COLOR_RESET} ${COLOR_GREEN}$1${COLOR_RESET}"; }
log_warn() { echo -e "${COLOR_YELLOW}[WARN]${COLOR_RESET} $1"; }
echo "========================================================================"
echo " OPRUIMEN OUDE STANDALONE SLSKD OP ${CLUSTER_HOST}"
echo "========================================================================"
echo "Dit stopt en verwijdert de oude standalone bestanden op ${CLUSTER_HOST}:"
echo " - /etc/systemd/system/slskd.service"
echo " - /datadisk/slskd (oude binaries en frontend bestanden)"
echo " - /var/www/.local/share/slskd (data is gemigreerd naar K8s PVC & backup in /storage/backups/)"
echo "========================================================================"
echo ""
read -p "Weet je zeker dat je de oude standalone slskd bestanden wilt verwijderen? (j/N): " -r CONFIRM
if [[ ! "$CONFIRM" =~ ^[jJyY]$ ]]; then
log_info "Opruimen geannuleerd."
exit 0
fi
log_step "Verwijderen van systemd service en programmabestanden op ${CLUSTER_HOST}..."
ssh -t "${SSH_USER}@${CLUSTER_HOST}" "
echo '--> Stoppen en uitschakelen van slskd.service...'
sudo systemctl stop slskd 2>/dev/null || true
sudo systemctl disable slskd 2>/dev/null || true
sudo rm -f /etc/systemd/system/slskd.service
sudo systemctl daemon-reload
sudo systemctl reset-failed 2>/dev/null || true
echo '--> Verwijderen van /datadisk/slskd...'
sudo rm -rf /datadisk/slskd
echo '--> Verwijderen van /var/www/.local/share/slskd...'
sudo rm -rf /var/www/.local/share/slskd
sudo rm -rf /var/www/.local/slskd 2>/dev/null || true
echo '--> Opslagruimte controleren...'
df -h / /datadisk /storage
"
echo ""
log_info "De oude standalone slskd is succesvol opgeruimd!"
echo "Alle verkeer naar slskd loopt nu direct via de Kubernetes pod."
k8s/kustomization.yaml
+1
View File
@@ -9,5 +9,6 @@ resources:
- sonarr
- lidarr
- transmission
- slskd
k8s/slskd/deployment.yaml
+115
View File
@@ -0,0 +1,115 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: slskd
namespace: htpc
labels:
app.kubernetes.io/name: slskd
app.kubernetes.io/part-of: htpc
spec:
replicas: 1
strategy:
type: Recreate
selector:
matchLabels:
app: slskd
template:
metadata:
labels:
app: slskd
app.kubernetes.io/name: slskd
app.kubernetes.io/part-of: htpc
spec:
nodeSelector:
kubernetes.io/hostname: vmserver
initContainers:
- name: migrate-config
image: slskd/slskd:latest
imagePullPolicy: IfNotPresent
command:
- /bin/bash
- -c
- |
if [ ! -f /app/slskd.yml ] && [ -f /host-config/slskd.yml ]; then
echo "Migrating slskd config and databases from host..."
cp -a /host-config/* /app/
fi
chown -R 33:33 /app
volumeMounts:
- name: config
mountPath: /app
- name: host-config
mountPath: /host-config
readOnly: true
containers:
- name: slskd
image: slskd/slskd:latest
imagePullPolicy: IfNotPresent
env:
- name: PUID
value: "33"
- name: PGID
value: "33"
- name: SLSKD_UMASK
value: "0002"
- name: SLSKD_APP_DIR
value: "/app"
- name: SLSKD_REMOTE_CONFIGURATION
value: "true"
ports:
- name: http
containerPort: 5030
hostPort: 5030
protocol: TCP
- name: https
containerPort: 5031
hostPort: 5031
protocol: TCP
- name: slsk-listen
containerPort: 50300
hostPort: 50300
protocol: TCP
resources:
requests:
cpu: 100m
memory: 256Mi
limits:
cpu: 2000m
memory: 2Gi
volumeMounts:
- name: config
mountPath: /app
- name: datadisk
mountPath: /datadisk
- name: mnt-mp3
mountPath: /mnt/mp3
livenessProbe:
httpGet:
path: /health
port: 5030
initialDelaySeconds: 45
periodSeconds: 20
timeoutSeconds: 5
readinessProbe:
httpGet:
path: /health
port: 5030
initialDelaySeconds: 15
periodSeconds: 10
timeoutSeconds: 5
volumes:
- name: config
persistentVolumeClaim:
claimName: slskd-config
- name: host-config
hostPath:
path: /var/www/.local/share/slskd
type: DirectoryOrCreate
- name: datadisk
hostPath:
path: /datadisk
type: Directory
- name: mnt-mp3
hostPath:
path: /mnt/mp3
type: Directory
k8s/slskd/kustomization.yaml
+7
View File
@@ -0,0 +1,7 @@
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- pvc.yaml
- service.yaml
- deployment.yaml
k8s/slskd/pvc.yaml
+15
View File
@@ -0,0 +1,15 @@
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: slskd-config
namespace: htpc
labels:
app.kubernetes.io/name: slskd
app.kubernetes.io/part-of: htpc
spec:
accessModes:
- ReadWriteOnce
storageClassName: local-path
resources:
requests:
storage: 10Gi
k8s/slskd/service.yaml
+25
View File
@@ -0,0 +1,25 @@
apiVersion: v1
kind: Service
metadata:
name: slskd
namespace: htpc
labels:
app.kubernetes.io/name: slskd
app.kubernetes.io/part-of: htpc
spec:
type: ClusterIP
ports:
- port: 5030
targetPort: 5030
protocol: TCP
name: http
- port: 5031
targetPort: 5031
protocol: TCP
name: https
- port: 50300
targetPort: 50300
protocol: TCP
name: slsk-listen
selector:
app: slskd
migrate_slskd_to_cluster.sh
Executable
+112
View File
@@ -0,0 +1,112 @@
#!/usr/bin/env bash
# ==============================================================================
# slskd Migration Script: Host Service -> Kubernetes Cluster (htpc namespace)
# ==============================================================================
set -euo pipefail
CLUSTER_HOST="10.2.0.4"
SSH_USER="bart"
HTPC_NS="htpc"
BACKUP_DIR="/storage/backups"
DATE_STR=$(date +%Y-%m-%d)
KUBECONFIG_PATH="${KUBECONFIG:-$HOME/.kube/config_vmserver}"
COLOR_GREEN="\033[0;32m"
COLOR_YELLOW="\033[1;33m"
COLOR_RED="\033[0;31m"
COLOR_BLUE="\033[0;34m"
COLOR_RESET="\033[0m"
log_info() { echo -e "${COLOR_GREEN}[INFO]${COLOR_RESET} $1"; }
log_step() { echo -e "\n${COLOR_BLUE}==>${COLOR_RESET} ${COLOR_GREEN}$1${COLOR_RESET}"; }
log_warn() { echo -e "${COLOR_YELLOW}[WARN]${COLOR_RESET} $1"; }
log_err() { echo -e "${COLOR_RED}[ERROR]${COLOR_RESET} $1"; }
echo "========================================================================"
echo " SLSKD MIGRATIE NAAR KUBERNETES CLUSTER (NAMESPACE: ${HTPC_NS})"
echo "========================================================================"
echo "Bron: slskd.service op ${CLUSTER_HOST}"
echo "Config: /var/www/.local/share/slskd"
echo "Doel: K8s Pod in namespace '${HTPC_NS}' op ${CLUSTER_HOST}"
echo "Poorten: Web (5030/5031), Soulseek Listen (50300)"
echo "========================================================================"
echo ""
read -p "Weet je zeker dat je de slskd migratie naar Kubernetes wilt starten? (j/N): " -r CONFIRM
if [[ ! "$CONFIRM" =~ ^[jJyY]$ ]]; then
log_info "Migratie geannuleerd."
exit 0
fi
# ------------------------------------------------------------------------------
# STAP 1: PRE-FLIGHT CHECKS
# ------------------------------------------------------------------------------
log_step "1. Pre-flight checks uitvoeren..."
log_info "Verbinding testen naar host (${CLUSTER_HOST})..."
ssh -o BatchMode=yes -o ConnectTimeout=5 "${SSH_USER}@${CLUSTER_HOST}" "true" || {
log_err "Kan niet verbinden met host (${CLUSTER_HOST}) via SSH."
exit 1
}
log_info "Controleren van KUBECONFIG verbinding..."
KUBECONFIG="${KUBECONFIG_PATH}" kubectl get nodes | grep -q "vmserver" || {
log_err "Kan vmserver node niet bereiken via kubectl (KUBECONFIG=${KUBECONFIG_PATH})!"
exit 1
}
# ------------------------------------------------------------------------------
# STAP 2: RESERVEKOPIE MAKEN VAN SLSKD DATA & CONFIG
# ------------------------------------------------------------------------------
log_step "2. Reservekopie maken van /var/www/.local/share/slskd op ${CLUSTER_HOST}..."
ssh -t "${SSH_USER}@${CLUSTER_HOST}" "
sudo mkdir -p '${BACKUP_DIR}'
if [ -d '/var/www/.local/share/slskd' ]; then
echo 'Inpakken van slskd data naar ${BACKUP_DIR}/slskd_backup_${DATE_STR}.tar.gz...'
sudo tar -czf '${BACKUP_DIR}/slskd_backup_${DATE_STR}.tar.gz' -C /var/www/.local/share slskd
echo 'Backup gereed:'
ls -lh '${BACKUP_DIR}/slskd_backup_${DATE_STR}.tar.gz'
else
echo 'Geen /var/www/.local/share/slskd gevonden, backup overgeslagen.'
fi
"
# ------------------------------------------------------------------------------
# STAP 3: STANDALONE SLSKD SERVICE STOPPEN OP DE HOST
# ------------------------------------------------------------------------------
log_step "3. Standalone slskd.service stoppen op ${CLUSTER_HOST}..."
ssh -t "${SSH_USER}@${CLUSTER_HOST}" "
echo '--> Stoppen van slskd.service...'
sudo systemctl stop slskd
"
# ------------------------------------------------------------------------------
# STAP 4: KUBERNETES MANIFESTS TOEPASSEN
# ------------------------------------------------------------------------------
log_step "4. Kubernetes manifests toepassen..."
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
KUBECONFIG="${KUBECONFIG_PATH}" kubectl apply -k "${SCRIPT_DIR}/k8s/"
log_info "Wachten op succesvolle uitrol van slskd pod..."
KUBECONFIG="${KUBECONFIG_PATH}" kubectl rollout status deployment/slskd -n "${HTPC_NS}" --timeout=180s
# ------------------------------------------------------------------------------
# STAP 5: VERIFICATIE
# ------------------------------------------------------------------------------
log_step "5. Verificatie van endpoints..."
sleep 5
log_info "Health endpoint testen via host (poort 5030)..."
ssh -o BatchMode=yes "${SSH_USER}@${CLUSTER_HOST}" "curl -I -s http://127.0.0.1:5030/health" | head -n 1
log_info "Web UI root testen via host..."
ssh -o BatchMode=yes "${SSH_USER}@${CLUSTER_HOST}" "curl -I -s http://127.0.0.1:5030/" | head -n 1
echo ""
echo "========================================================================"
log_info "SLSKD MIGRATIE SUCCESVOL AFGEROND!"
echo "slskd draait nu als pod in Kubernetes namespace '${HTPC_NS}'."
echo "Configuratie en databases zijn bewaard in PersistentVolume slskd-config."
echo "Web UI bereikbaar op: http://10.2.0.4:5030/"
echo "Host service uitschakelen / opruimen kan via: ./cleanup_old_slskd.sh"
echo "========================================================================"