Merge pull request #27 from zong-zhe/add-deployment-strategy

feat: add 'deploymentStrategy' to server

examples/server/app_deployment_strategy/base/base.k

@@ -0,0 +1,11 @@
+import konfig.models.kube.frontend
+import konfig.models.kube.frontend.container
+import konfig.models.kube.templates.resource as res_tpl
+
+# Application Configuration
+appConfiguration: frontend.Server {
+    # Main Container Configuration
+    mainContainer = container.Main {}
+    schedulingStrategy.resource = res_tpl.tiny
+    image = "gcr.io/google-samples/gb-frontend:v4"
+}

examples/server/app_deployment_strategy/kcl.mod

@@ -0,0 +1,7 @@
+[package]
+name = "nginx-example"
+version = "0.0.1"
+
+[dependencies]
+konfig = { path = "../../../../konfig" }
+k8s = "1.28"

examples/server/app_deployment_strategy/prod/kcl.mod

@@ -0,0 +1,10 @@
+[package]
+name = "app_stateful_set-prod"
+version = "0.0.1"
+
+[dependencies]
+konfig = { path = "../../../../../konfig" }
+k8s = "1.28"
+[profile]
+entries = ["../base/base.k", "main.k", "${konfig:KCL_MOD}/models/kube/render/render.k"]
+

examples/server/app_deployment_strategy/prod/main.k

@@ -0,0 +1,13 @@
+import konfig.models.kube.frontend
+
+# The application configuration in stack will overwrite 
+# the configuration with the same attribute in base.
+appConfiguration: frontend.Server {
+    deploymentStrategy: {
+        type = "RollingUpdate"
+        rollingUpdate: {
+            maxSurge = 1
+            maxUnavailable = 1
+        }
+    }
+}

examples/server/app_need_namespace/prod/kcl.mod.lock

@@ -5,5 +5,5 @@
     version = "1.31.2"
   [dependencies.konfig]
     name = "konfig"
-    full_name = "konfig_0.10.0"
-    version = "0.10.0"
+    full_name = "konfig_0.11.0"
+    version = "0.11.0"

examples/server/app_scheduling_strategy/prod/kcl.mod.lock

@@ -5,5 +5,5 @@
     version = "1.31.2"
   [dependencies.konfig]
     name = "konfig"
-    full_name = "konfig_0.10.0"
-    version = "0.10.0"
+    full_name = "konfig_0.11.0"
+    version = "0.11.0"

kcl.mod

@@ -1,6 +1,6 @@
 [package]
 name = "konfig"
-version = "0.10.0"
+version = "0.11.0"
 
 [dependencies]
 k8s = "1.31.2"

models/kube/backend/server_backend.k

@@ -84,6 +84,8 @@ schema ServerBackend[inputConfig: server.Server]:
                         serviceAccountName = config.serviceAccount.name
                 }
             }
+            if config.deploymentStrategy:
+                strategy = config.deploymentStrategy
         }
     }
 

models/kube/frontend/deployment/deployment_strategy.k

@@ -0,0 +1,25 @@
+"""
+This is the deployment_strategy module in k8s.api.apps.v1 package.
+This file was generated by the KCL auto-gen tool. DO NOT EDIT.
+Editing this file might prove futile when you re-run the KCL auto-gen generate command.
+"""
+
+
+schema DeploymentStrategy:
+    """
+    DeploymentStrategy describes how to replace existing pods with new ones.
+
+    Attributes
+    ----------
+    rollingUpdate : RollingUpdateDeployment, default is Undefined, optional
+        Rolling update config params. Present only if DeploymentStrategyType = RollingUpdate.
+    $type : str, default is Undefined, optional
+        Type of deployment. Can be "Recreate" or "RollingUpdate". Default is RollingUpdate.
+    """
+
+
+    rollingUpdate?: RollingUpdateDeployment
+
+    $type?: str
+
+

models/kube/frontend/deployment/rolling_update_deployment.k

@@ -0,0 +1,25 @@
+"""
+This is the rolling_update_deployment module in k8s.api.apps.v1 package.
+This file was generated by the KCL auto-gen tool. DO NOT EDIT.
+Editing this file might prove futile when you re-run the KCL auto-gen generate command.
+"""
+
+
+schema RollingUpdateDeployment:
+    """
+    Spec to control the desired behavior of rolling update.
+
+    Attributes
+    ----------
+    maxSurge : int | str, default is Undefined, optional
+        The maximum number of pods that can be scheduled above the desired number of pods. Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%). This can not be 0 if MaxUnavailable is 0. Absolute number is calculated from percentage by rounding up. Defaults to 25%. Example: when this is set to 30%, the new ReplicaSet can be scaled up immediately when the rolling update starts, such that the total number of old and new pods do not exceed 130% of desired pods. Once old pods have been killed, new ReplicaSet can be scaled up further, ensuring that total number of pods running at any time during the update is at most 130% of desired pods.
+    maxUnavailable : int | str, default is Undefined, optional
+        The maximum number of pods that can be unavailable during the update. Value can be an absolute number (ex: 5) or a percentage of desired pods (ex: 10%). Absolute number is calculated from percentage by rounding down. This can not be 0 if MaxSurge is 0. Defaults to 25%. Example: when this is set to 30%, the old ReplicaSet can be scaled down to 70% of desired pods immediately when the rolling update starts. Once new pods are ready, old ReplicaSet can be scaled down further, followed by scaling up the new ReplicaSet, ensuring that the total number of pods available at all times during the update is at least 70% of desired pods.
+    """
+
+
+    maxSurge?: int | str
+
+    maxUnavailable?: int | str
+
+

models/kube/frontend/server.k

@@ -9,6 +9,7 @@ import models.kube.frontend.volume
 import models.kube.frontend.sidecar as s
 import models.kube.frontend.strategy
 import models.kube.frontend.storage
+import models.kube.frontend.deployment
 
 schema Server:
     """Server is abstaction of Deployment and StatefulSet.
@@ -151,3 +152,6 @@ schema Server:
 
     # extra resources
     extraResources?: {str: {str:}}
+
+    # Strategy for deployment
+    deploymentStrategy?: deployment.DeploymentStrategy