Manifeste und Secrets
Zu jedem Cluster, den das Plugin Kubernetes-Cluster verwaltet, lassen sich Manifeste als Bausteine speichern und Secrets festlegen, deren Werte im Tresor liegen. Beides gehört zum Cluster und lässt sich wiederholt anwenden.
Manifest-Bausteine
Ein Baustein ist ein Kubernetes-Manifest mit Parametern. Ein Parameter steht im Manifest als {name} und hat eine Vorgabe oder ist Pflicht:
# Parameter, je Zeile name=vorgabe (ohne Vorgabe: Pflicht)
replicas=2
image
# Manifest
apiVersion: apps/v1
kind: Deployment
metadata:
name: web
spec:
replicas: {replicas}
selector:
matchLabels: {app: web}
template:
metadata:
labels: {app: web}
spec:
containers:
- name: web
image: {image}
- Vergleichen zeigt, was sich im Cluster ändern würde. Das Ergebnis ist gleich, Unterschied oder Konflikt, mit der Ausgabe dazu.
- Anwenden nutzt Server-Side Apply mit dem Plugin als Verwalter der Felder. Gehören Felder einem anderen Verwalter, meldet das Plugin einen Konflikt; übernehmen lassen sie sich nur ausdrücklich.
- Entfernen löscht die Objekte des Bausteins im Cluster. Den Baustein selbst zu löschen, lässt die Objekte stehen.
Vergleichen darf, wer lesen darf. Anwenden und Entfernen verlangen das Recht, Cluster zu verwalten, gehen nur bei Clustern ohne Namespace-Beschränkung und brauchen als Bestätigung den eingetippten Namespace des Bausteins. Alles läuft im Hintergrund; das Ergebnis lässt sich danach abholen.
Bis 256 KiB steht das Manifest im Baustein. Grössere, etwa das Release-Manifest eines Operators, werden mit Adresse und SHA-256-Prüfsumme angegeben: PurePower lädt die Datei selbst, prüft die Prüfsumme und legt sie ab. Ein Manifest, das ein Secret enthält, lehnt das Plugin ab — auch dann, wenn es erst nach dem Einsetzen der Parameter eines wäre. Bausteine lassen sich als JSON exportieren und importieren.
Secrets aus dem Tresor
Ein Secret wird mit Name, Namespace, Typ, Labels und seinen Schlüsseln festgelegt. Jeder Schlüssel hat eine Art:
- zufall: Das Plugin erzeugt den Wert — 8 bis 512 Zeichen, alphanumerisch, hexadezimal oder base64 — und kann ihn rotieren.
- tresor: Der Wert wird einmal gesetzt und ist danach nur noch schreibbar. Binärdaten wie ein Keystore werden base64-kodiert gesetzt.
- literal: ein fester Wert, der kein Geheimnis ist.
- verweis: der Wert eines Schlüssels aus einem anderen Secret desselben Clusters.
password=zufall:32:alnum
keystore=tresor:base64
username=literal:app
db-password=verweis:datenbank/app-zugang:password
Wird eine Quelle angewendet oder rotiert, wendet das Plugin die Secrets mit an, die auf sie verweisen; eine Quelle, auf die noch verwiesen wird, lässt sich nicht löschen. Labels helfen Operatoren, geänderte Werte selbst nachzuziehen — CloudNativePG etwa lädt Passwörter neu, wenn das Secret cnpg.io/reload=true trägt. Ändert ein Schlüssel seine Art, entfernt das Plugin den alten Wert aus dem Tresor.
Die Werte erscheinen nie in der Oberfläche, im Verlauf, in einem Ereignis oder in einer Antwort der Schnittstelle. Angewendet wird per Server-Side Apply aus einer geschützten Datei, die sofort wieder gelöscht wird; jedes Secret trägt das Label app.kubernetes.io/managed-by=k8sadmin. Rotieren und Löschen verlangen den eingetippten Namespace als Bestätigung. Festlegen, Werte setzen, Anwenden und Rotieren verlangen das Recht, Cluster zu verwalten.
In Pipelines und über MCP
Bausteine vergleichen, anwenden und entfernen sowie Secrets anwenden und rotieren gibt es auch als Pipeline-Knoten, über die REST-Schnittstelle und als MCP-Werkzeuge — mit denselben Rechten und Bestätigungen. Jede Ausführung steht im Verlauf des Clusters und geht als Ereignis an die Pipelines.
Zurück zu Kubernetes-Cluster, weiter zum Tresor oder zur Übersicht der Plugins.
Fragen zu Manifeste und Secrets?
Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.