[RHCLOUD-27862] add Pod Lifecyle hooks

apis/cloud.redhat.com/v1alpha1/clowdapp_types.go

@@ -312,6 +312,13 @@ type PodSpec struct {
 	// A pass-through of a list of VolumesMounts in standa k8s format.
 	VolumeMounts []v1.VolumeMount `json:"volumeMounts,omitempty"`
 
+	// A pass-through of Lifecycle specification in standard k8s format
+	Lifecycle *v1.Lifecycle `json:"lifecycle,omitempty"`
+
+	// A pass-through of TerminationGracePeriodSeconds specification in standard k8s format
+	// default is 30 seconds
+	TerminationGracePeriodSeconds *int64 `json:"terminationGracePeriodSeconds,omitempty"`
+
 	// Lists the expected side cars, will be validated in the validating webhook
 	Sidecars []Sidecar `json:"sidecars,omitempty"`
 

controllers/cloud.redhat.com/providers/deployment/impl.go

@@ -238,6 +238,7 @@ func initDeployment(app *crd.ClowdApp, env *crd.ClowdEnvironment, d *apps.Deploy
 		TerminationMessagePath:   TerminationLogPath,
 		TerminationMessagePolicy: core.TerminationMessageReadFile,
 		ImagePullPolicy:          core.PullIfNotPresent,
+		Lifecycle:                pod.Lifecycle,
 	}
 
 	setLivenessProbe(&pod, deployment, env, &c)
@@ -270,6 +271,8 @@ func initDeployment(app *crd.ClowdApp, env *crd.ClowdEnvironment, d *apps.Deploy
 
 	d.Spec.Template.Spec.InitContainers = ics
 
+	d.Spec.Template.Spec.TerminationGracePeriodSeconds = pod.TerminationGracePeriodSeconds
+
 	d.Spec.Template.Spec.Volumes = pod.Volumes
 	d.Spec.Template.Spec.Volumes = append(d.Spec.Template.Spec.Volumes, core.Volume{
 		Name: "config-secret",

docs/antora/modules/ROOT/pages/api_reference.adoc

@@ -1241,6 +1241,8 @@ PodSpec defines a container running inside a ClowdApp.
 | *`readinessProbe`* __link:https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#probe-v1-core[$$Probe$$]__ | A pass-through of a Readiness Probe specification in standard k8s format. If omitted, a standard probe will be setup point to the webPort defined in the ClowdEnvironment and a path of /healthz. Ignored if Web is set to false.
 | *`volumes`* __link:https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#volume-v1-core[$$Volume$$] array__ | A pass-through of a list of Volumes in standa k8s format.
 | *`volumeMounts`* __link:https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#volumemount-v1-core[$$VolumeMount$$] array__ | A pass-through of a list of VolumesMounts in standa k8s format.
+| *`lifecycle`* __link:https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.26/#lifecycle-v1-core[$$Lifecycle$$]__ | A pass-through of Lifecycle specification in standard k8s format
+| *`terminationGracePeriodSeconds`* __integer__ | A pass-through of TerminationGracePeriodSeconds specification in standard k8s format default is 30 seconds
 | *`sidecars`* __xref:{anchor_prefix}-github-com-redhatinsights-clowder-apis-cloud-redhat-com-v1alpha1-sidecar[$$Sidecar$$] array__ | Lists the expected side cars, will be validated in the validating webhook
 | *`machinePool`* __string__ | MachinePool allows the pod to be scheduled to a particular machine pool.
 |===

docs/appconfig/schema-definitions-dependencyendpoint-properties-apipaths-items.md

@@ -0,0 +1,16 @@
+# Untitled string in AppConfig Schema
+
+```txt
+https://cloud.redhat.com/schemas/clowder-appconfig#/definitions/DependencyEndpoint/properties/apiPaths/items
+```
+
+
+
+
+| Abstract            | Extensible | Status         | Identifiable            | Custom Properties | Additional Properties | Access Restrictions | Defined In                                                    |
+| :------------------ | ---------- | -------------- | ----------------------- | :---------------- | --------------------- | ------------------- | ------------------------------------------------------------- |
+| Can be instantiated | No         | Unknown status | Unknown identifiability | Forbidden         | Allowed               | none                | [schema.json\*](../../out/schema.json "open original schema") |
+
+## items Type
+
+`string`

docs/appconfig/schema-definitions-dependencyendpoint-properties-apipaths.md

@@ -0,0 +1,16 @@
+# Untitled array in AppConfig Schema
+
+```txt
+https://cloud.redhat.com/schemas/clowder-appconfig#/definitions/DependencyEndpoint/properties/apiPaths
+```
+
+The list of API paths (each matching format: '/api/some-path/') that this app will serve requests from
+
+
+| Abstract            | Extensible | Status         | Identifiable            | Custom Properties | Additional Properties | Access Restrictions | Defined In                                                    |
+| :------------------ | ---------- | -------------- | ----------------------- | :---------------- | --------------------- | ------------------- | ------------------------------------------------------------- |
+| Can be instantiated | No         | Unknown status | Unknown identifiability | Forbidden         | Allowed               | none                | [schema.json\*](../../out/schema.json "open original schema") |
+
+## apiPaths Type
+
+`string[]`

tests/kuttl/test-lifecycle-hook/00-install.yaml

@@ -0,0 +1,7 @@
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: test-lifecycle-hook
+spec:
+  finalizers:
+  - kubernetes

tests/kuttl/test-lifecycle-hook/01-assert.yaml

@@ -0,0 +1,25 @@
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: lifecycle-processor
+  namespace: test-lifecycle-hook
+spec:
+  template:
+    spec:
+      serviceAccountName: lifecycle-processor
+      containers:
+        - name: lifecycle-processor
+          image: quay.io/psav/clowder-hello
+          lifecycle:
+            postStart:
+              exec:
+                command:
+                  - ./clowder-hello
+                  - boo
+            preStop:
+              httpGet:
+                path: /healthz
+                port: 8000
+                scheme: HTTP
+      terminationGracePeriodSeconds: 500

tests/kuttl/test-lifecycle-hook/01-pods.yaml

@@ -0,0 +1,55 @@
+---
+apiVersion: cloud.redhat.com/v1alpha1
+kind: ClowdEnvironment
+metadata:
+  name: test-lifecycle-hook
+spec:
+  targetNamespace: test-lifecycle-hook
+  providers:
+    web:
+      port: 8000
+      mode: operator
+    metrics:
+      port: 9000
+      mode: operator
+      path: "/metrics"
+    kafka:
+      mode: none
+    db:
+      mode: none
+    logging:
+      mode: none
+    objectStore:
+      mode: none
+    inMemoryDb:
+      mode: none
+  resourceDefaults:
+    limits:
+      cpu: 400m
+      memory: 1024Mi
+    requests:
+      cpu: 30m
+      memory: 512Mi
+---
+apiVersion: cloud.redhat.com/v1alpha1
+kind: ClowdApp
+metadata:
+  name: lifecycle
+  namespace: test-lifecycle-hook
+spec:
+  envName: test-lifecycle-hook
+  deployments:
+  - name: processor
+    podSpec:
+      image: quay.io/psav/clowder-hello
+      lifecycle:
+        postStart:
+          exec:
+            command:
+              - ./clowder-hello
+              - boo
+        preStop:
+          httpGet:
+            port: 8000
+            path: /healthz
+      terminationGracePeriodSeconds: 500

tests/kuttl/test-lifecycle-hook/02-delete.yaml

@@ -0,0 +1,10 @@
+---
+apiVersion: kuttl.dev/v1beta1
+kind: TestStep
+delete:
+- apiVersion: v1
+  kind: Namespace
+  name: test-lifecycle-hook
+- apiVersion: cloud.redhat.com/v1alpha1
+  kind: ClowdEnvironment
+  name: test-lifecycle-hook