Merge pull request #58237 from rh-max/srvls-overriding-probes

[SRVCOM-2210] Add notes on restrictions for overriding probes

Author: jab-rh

serverless/eventing/tuning/overriding-config-eventing.adoc

@@ -6,7 +6,22 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-You can override the default configurations for some specific deployments by modifying the `deployments` spec in the `KnativeEventing` custom resource (CR).
+You can override the default configurations for some specific deployments by modifying the `deployments` spec in the `KnativeEventing` custom resource (CR). Currently, overriding default configuration settings is supported for the `eventing-controller`, `eventing-webhook`, and `imc-controller` fields, as well as for the `readiness` and `liveness` fields for probes.
+
+[IMPORTANT]
+====
+The `replicas` spec cannot override the number of replicas for deployments that use the Horizontal Pod Autoscaler (HPA), and does not work for the `eventing-webhook` deployment.
+====
+
+[NOTE]
+====
+You can only override probes that are defined in the deployment by default.
+
+All Knative Serving deployments define a readiness and a liveness probe by default, with these exceptions:
+
+* `net-kourier-controller` and `3scale-kourier-gateway` only define a readiness probe.
+* `net-istio-controller` and `net-istio-webhook` define no probes.
+====
 
 include::modules/knative-eventing-CR-system-deployments.adoc[leveloffset=+1]
 

serverless/knative-serving/config-applications/overriding-config-serving.adoc

@@ -6,8 +6,18 @@ include::_attributes/common-attributes.adoc[]
 
 You can override the default configurations for some specific deployments by modifying the `deployments` spec in the `KnativeServing` custom resources (CRs).
 
+[NOTE]
+====
+You can only override probes that are defined in the deployment by default.
+
+All Knative Serving deployments define a readiness and a liveness probe by default, with these exceptions:
+
+* `net-kourier-controller` and `3scale-kourier-gateway` only define a readiness probe.
+* `net-istio-controller` and `net-istio-webhook` define no probes.
+====
+
 include::modules/knative-serving-CR-system-deployments.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
-* link:https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#probe-v1-core[Probe configuration section of the Kubernetes API documentation]
+* link:https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#probe-v1-core[Probe configuration section of the Kubernetes API documentation]