wip

Signed-off-by: Attila Mészáros <a_meszaros@apple.com>

Author: csviri

docs/content/en/docs/documentation/operations/_index.md

@@ -4,3 +4,7 @@ weight: 80
 ---
 
 This section covers operations-related features for running and managing operators in production.
+
+See the
+[`operations` sample operator](https://github.com/java-operator-sdk/java-operator-sdk/tree/main/sample-operators/operations)
+for a complete working example that demonstrates health probes, metrics, and Helm-based deployment.

docs/content/en/docs/documentation/operations/health-probes.md

@@ -61,14 +61,23 @@ for a complete working example.
 
 ## Kubernetes Deployment Configuration
 
-Once your operator exposes the probe endpoint, configure a readiness probe in your Deployment manifest:
+Once your operator exposes the probe endpoint, configure probes in your Deployment manifest. Both the
+startup and readiness probes can point to the same `/healthz` endpoint — the startup probe simply uses a
+higher `failureThreshold` to give the operator time to initialize:
 
 ```yaml
 containers:
 - name: operator
   ports:
   - name: probes
     containerPort: 8080
+  startupProbe:
+    httpGet:
+      path: /healthz
+      port: probes
+    initialDelaySeconds: 1
+    periodSeconds: 3
+    failureThreshold: 20
   readinessProbe:
     httpGet:
       path: /healthz
@@ -78,8 +87,9 @@ containers:
     failureThreshold: 3
 ```
 
-The readiness probe will mark the pod as not-ready until all informers have synced. After that, it
-continues to monitor event source health at runtime.
+The startup probe gives the operator time to start (up to ~60 s with the settings above). Once the startup
+probe succeeds, the readiness probe takes over and will mark the pod as not-ready if any event source
+becomes unhealthy.
 
 ## Helm Chart Support
 
@@ -89,6 +99,9 @@ Enable them in your `values.yaml`:
 ```yaml
 probes:
   port: 8080
+  startup:
+    enabled: true
+    path: /healthz
   readiness:
     enabled: true
     path: /healthz

sample-operators/operations/src/test/resources/helm-values.yaml

@@ -34,6 +34,9 @@ primaryResources:
     - metricshandlingcustomresource2s
 
 probes:
+  startup:
+    enabled: true
+    path: /healthz
   readiness:
     enabled: true
     path: /healthz