kubeseal-webgui — Secrets im Browser versiegeln
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/3-apps-workloads/300o0-kubeseal-webgui.md
kubeseal-webgui — Secrets im Browser versiegeln
Weboberfläche, die einzelne Werte mit dem Zertifikat des TECH-Controllers zu einem SealedSecret-Wert verschlüsselt. Praktisch, wenn kein kubeseal oder kein Cluster-Zugriff am Arbeitsplatz verfügbar ist. Das Ergebnis ist derselbe Base64-Block wie bei kubeseal --raw.
Cluster: TECH · Ordner
argocd/apps/tech/kubeseal-webgui/· URLhttp://kubeseal-webgui.tech.homeserver(nur intern, kein TLS-Block im Ingress).kubectl-Befehle in diesem Doc gelten für den TECH-Cluster (Zugriff je Cluster).
Architektur
| Teil | Wert |
|---|---|
| Chart | Wrapper um das Chart kubeseal-webgui 6.0.14 (oci://ghcr.io/jaydee94/kubeseal-webgui/charts, App 4.10.1) |
| Zertifikat | sealedSecrets.autoFetchCert: true: die Oberfläche holt das Zertifikat selbst vom Controller (sealed-secrets-controller im Namespace sealed-secrets) |
| Ingress | Klasse traefik, Host kubeseal-webgui.tech.homeserver, tls.enabled: false, API-Adresse http://kubeseal-webgui.tech.homeserver |
| Skalierung | eigenes Template templates/hpa.yaml: 1 bis 2 Replikas bei 75 % CPU, Scale-Down nach 300 s (HPA) |
| Ressourcen | 20m CPU Request, 256 MiB Request und Limit |
Die Oberfläche kennt nur das TECH-Zertifikat. Werte für PROD oder ENTW lassen sich damit nicht versiegeln (dafür kubeseal --cert <prod-zertifikat> oder scripts/reseal-for-prod.sh, siehe Sealed Secrets).
Nutzung
http://kubeseal-webgui.tech.homeserveröffnen (Heimnetz oder Tailnet).- Scope wählen (Standard: strikt, Namespace und Secret-Name), Namespace und Secret-Name eintragen, den Wert eingeben.
- Das Ergebnis (
AgB…) in dievalues.yamldes jeweiligen Charts übernehmen (encryptedDatao. Ä.), siehe die Anleitung der jeweiligen App, zum Beispiel carplay-api: Ersteinrichtung.
Der Klartext wird an die Oberfläche übertragen. Weil der Zugriff unverschlüsselt (HTTP) im internen Netz läuft, sollte man ihn nur von vertrauenswürdigen Geräten nutzen und besonders sensible Werte per CLI versiegeln.
Fehlersuche
kubectl -n kubeseal-webgui get pods,ingress
kubectl -n kubeseal-webgui logs deploy/kubeseal-webgui --tail=100
| Symptom | Ursache | Lösung |
|---|---|---|
| Seite lädt nicht | Pod nicht bereit, Ingress oder DNS fehlt, kein VPN | kubectl -n kubeseal-webgui get pods, nslookup kubeseal-webgui.tech.homeserver, DNS |
| „Zertifikat konnte nicht geladen werden“ oder leeres Ergebnis | Oberfläche erreicht den Controller nicht (falscher Name oder Namespace, NetworkPolicy) | sealedSecrets.controllerName und controllerNamespace in values.yaml prüfen, Network Policies |
| Ergebnis lässt sich im Cluster nicht entschlüsseln | falscher Name oder Namespace, oder der Wert gehört in einen anderen Cluster | Scope und Namen prüfen (Sealed Secrets) |
| Browser meldet gemischte Inhalte | API-Adresse in api.url passt nicht zum aufgerufenen Host (http/https) |
api.url und Aufruf-URL angleichen |
Pod startet nicht (ImagePullBackOff) |
OCI-Registry nicht erreichbar, pullPolicy: Always |
Netz prüfen, Images |
| ArgoCD-Sync scheitert mit Chart-Fehler | Chart.lock oder OCI-Abhängigkeit nicht ladbar |
ArgoCD |
Allgemeine Fehlersuche: zentrale Fehlersuche.