Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- it-wiki:kubernetes:deployments_mit_kustomize [2024/03/13 11:56] – [Konfiguration für die Testumgebung mit geänderten Porteinstellungen:] marko
+++ it-wiki:kubernetes:deployments_mit_kustomize [2024/03/13 12:33] (aktuell) – [Fazit] marko
@@ Zeile 6: / Zeile 6: @@
 ==== Konfiguration für die Dev-Umgebung: ====
-<code bash>
+<code yaml>
 kind: Service
 apiVersion: v1
@@ Zeile 21: / Zeile 21: @@
 ==== Konfiguration für die Testumgebung mit geänderten Porteinstellungen: ====
-<code bash>
+<code yaml>
 kind: Service
 apiVersion: v1
@@ Zeile 38: / Zeile 38: @@
 Kustomize kann diese Probleme lösen, indem es die Anpassung bestehender Ressourcen vereinfacht und automatisiert. Dabei arbeitet Kustomize nach einem einfachen Grundkonzept: Es wird nur eine einzige Basiskonfiguration für die Bereitstellung der Anwendung angelegt. Für die einzelnen Umgebungen werden nur die an der Basis durchzuführenden Patches, die sogenannten Overlays, abgelegt.
+\\
 {{ :it-wiki:kubernetes:b2ap3_large_bild1.png?nolink&600 |}}
+\\
+Schauen wir uns einmal an, wie wir unser Beispiel mit den Porteinstellungen in Kustomize umsetzen können. Als Erstes muss eine //kustomization.yaml// angelegt werden, welche alle benötigten Ressourcen und die zu verwendenden Patches auflistet.
+<code yaml>
+#base/kustomization.yaml
+resources:
+- service.yaml
+</code>
+<code yaml>
+#overlays/test/kustomization.yaml
+bases:
+- ../../base
+patches:
+- service-ports.yaml
+</code>
+{{ :it-wiki:kubernetes:b2ap3_large_bild2.png?nolink&400 |}}
+Durch Patches können einzelne YAML-Attribute einer Konfiguration hinzugefügt oder überschrieben werden. Hierzu wird eine neue YAML-Datei angelegt, welche den Namen der zu patchenden Ressource und alle zu ändernden Attribute beinhaltet.
+<code yaml>
+#overlays/test/service-ports.yaml
+kind: Service
+apiVersion: v1
+metadata:
+  #Name der zu patchenden Ressource
+  name: env-anzeige-frontend-https
+spec:
+  ports: #Die Porteinstellungen werden überschrieben
+  - name: https
+    port: 443
+</code>
+Durch die Erstellung von Patch-Dateien können einzelne YAML-Attribute einer Konfiguration hinzugefügt oder überschrieben werden. Um anspruchsvollere Veränderungen an den Dateien durchzuführen, bietet Kustomize zusätzlich das Verändern von Ressourcen unter Verwendung des [[https://tools.ietf.org/html/rfc6902|JSON6902]] Standards an. Dieser beinhaltet sechs weitere Operatoren zur Veränderung von Ressourcen und ist damit umfangreicher als der Standard-Patch.
+^JSON6902 Operator ^Beschreibung^
+| Add | fügt ein Attribut am angegebenen Pfad hinzu |
+| Remove | entfernt ein Attribut |
+| Replace | überschreibt das Attribut am angegebenen Pfad mit einem neuen Wert |
+| Move | verschiebt ein Attribut an einen anderen Pfad |
+| Copy | kopiert ein Attribut und fügt es an einem anderen Pfad wieder ein |
+| Test | überprüft, ob ein bestimmtes Attribut den angegebenen Wert besitzt |
+ Im Folgenden wird der Service-Patch mit der JSON-Methode durchgeführt:
+<code yaml>
+#kustomization.yaml
+patchesJson6902:
+- target:
+    version: v1
+    kind: Service
+    name: env-anzeige-frontend-https
+  path: service-patch.yaml
+</code>
+<code yaml>
+#service-patch.yaml
+- op: replace
+  path: /spec/ports
+  value:
+  - name: https
+    port: 443
+</code>
+Die herkömmlichen Patches haben einen kleineren Funktionsumfang als der JSON-Patch, dadurch sind sie aber auch lesbarer. Außerdem reichen die Operationen hinzufügen und überschreiben für die meisten Anwendungsfälle völlig aus. Ein JSON-Patch sollte daher nur verwendet werden, wenn die zusätzlichen Operatoren (Attribut entfernen/kopieren/verschieben/testen) benötigt werden.
+Nachdem wir unsere Patches in Kustomize deklariert haben, können wir nun die einsetzbaren YAML-Konfigurationen erstellen. Kustomize ist fest in der aktuellen Version von kubectl implementiert. Mit dem Befehl **kubectl kustomize** kann die gepatchte YAML Konfigurationen ausgeben lassen.
+<code bash>> kubectl kustomize ./overlays/test/</code>
+<code yaml>
+apiVersion: v1
+kind: Service
+metadata:
+  name: env-anzeige-frontend-https
+spec:
+  ports:
+  - name: https
+    nodePort: 30951
+    port: 443
+  selector:
+    app: env-anzeige-frontend
+  type: LoadBalancer
+</code>
+Alternativ können die Ressourcen mit dem Befehl **kubectl apply -k** ohne Zwischenschritt direkt in das Cluster geladen werden.
+<code bash>
+> kubectl apply -k ./overlays/test/
+service/env-anzeige-frontend-https created
+</code>
-Schauen wir uns einmal an, wie wir unser Beispiel mit den Porteinstellungen in Kustomize umsetzen können. Als Erstes muss eine //kustomization.yaml// angelegt werden, welche alle benötigten Ressourcen und die zu verwendenden Patches auflistet.
+\\
+===== Fazit =====
+Kustomize vereinfacht den Konfigurationsprozess für verschiedene Umgebungen erheblich. Weitere Vorteile von Kustomize sind die feste Implementierung in kubectl. Dadurch ist keine weitere Konfiguration oder Installation notwendig.