Merge pull request #97053 from jab-rh/apis-4-20-0ec5

Add apis-4-20-0ec5 for OCP 4.20

Author: jab-rh

_topic_maps/_topic_map.yml

@@ -4076,10 +4076,14 @@ Topics:
     File: machine-machine-openshift-io-v1beta1
   - Name: 'MachineSet [machine.openshift.io/v1beta1]'
     File: machineset-machine-openshift-io-v1beta1
+  - Name: 'MachineConfigNode [machineconfiguration.openshift.io/v1]'
+    File: machineconfignode-machineconfiguration-openshift-io-v1
   - Name: 'MachineOSBuild [machineconfiguration.openshift.io/v1]'
     File: machineosbuild-machineconfiguration-openshift-io-v1
   - Name: 'MachineOSConfig [machineconfiguration.openshift.io/v1]'
     File: machineosconfig-machineconfiguration-openshift-io-v1
+  - Name: 'PinnedImageSet [machineconfiguration.openshift.io/v1]'
+    File: pinnedimageset-machineconfiguration-openshift-io-v1
 - Name: Metadata APIs
   Dir: metadata_apis
   Topics:
@@ -4173,6 +4177,8 @@ Topics:
     File: ingress-networking-k8s-io-v1
   - Name: 'IngressClass [networking.k8s.io/v1]'
     File: ingressclass-networking-k8s-io-v1
+  - Name: 'IPAddress [networking.k8s.io/v1]'
+    File: ipaddress-networking-k8s-io-v1
   - Name: 'IPAMClaim [k8s.cni.cncf.io/v1alpha1]'
     File: ipamclaim-k8s-cni-cncf-io-v1alpha1
   - Name: 'IPPool [whereabouts.cni.cncf.io/v1alpha1]'
@@ -4195,6 +4201,10 @@ Topics:
     File: route-route-openshift-io-v1
   - Name: 'Service [undefined/v1]'
     File: service-v1
+  - Name: 'ServiceCIDR [networking.k8s.io/v1]'
+    File: servicecidr-networking-k8s-io-v1
+  - Name: 'IPAddressClaim [ipam.cluster.x-k8s.io/v1beta1]'
+    File: ipaddressclaim-ipam-cluster-x-k8s-io-v1beta1
   - Name: 'UserDefinedNetwork [k8s.ovn.org/v1]'
     File: userdefinednetwork-k8s-ovn-org-v1
 - Name: Node APIs

api-config.yaml

@@ -304,18 +304,18 @@ apiMap:
   - kind: MachineSet
     group: machine.openshift.io
     version: v1beta1
-#  - kind: MachineConfigNode
-#    group: machineconfiguration.openshift.io
-#    version: v1alpha1
+  - kind: MachineConfigNode
+    group: machineconfiguration.openshift.io
+    version: v1
   - kind: MachineOSBuild
     group: machineconfiguration.openshift.io
     version: v1
   - kind: MachineOSConfig
     group: machineconfiguration.openshift.io
     version: v1
-#  - kind: PinnedImageSet
-#    group: machineconfiguration.openshift.io
-#    version: v1alpha1
+  - kind: PinnedImageSet
+    group: machineconfiguration.openshift.io
+    version: v1
 - name: Metadata APIs
   resources:
   - kind: APIRequestCount
@@ -442,6 +442,9 @@ apiMap:
   - kind: IngressClass
     group: networking.k8s.io
     version: v1
+  - kind: IPAddress
+    group: networking.k8s.io
+    version: v1
   - kind: IPAMClaim
     group: k8s.cni.cncf.io
     version: v1alpha1
@@ -474,6 +477,12 @@ apiMap:
     version: v1
   - kind: Service
     version: v1
+  - kind: ServiceCIDR
+    group: networking.k8s.io
+    version: v1
+  - kind: IPAddressClaim
+    group: ipam.cluster.x-k8s.io
+    version: v1beta1
   - kind: UserDefinedNetwork
     group: k8s.ovn.org
     version: v1

rest_api/autoscale_apis/horizontalpodautoscaler-autoscaling-v2.adoc

@@ -110,18 +110,30 @@ Type::
 
 | `scaleDown`
 | `object`
-| HPAScalingRules configures the scaling behavior for one direction. These Rules are applied after calculating DesiredReplicas from metrics for the HPA. They can limit the scaling velocity by specifying scaling policies. They can prevent flapping by specifying the stabilization window, so that the number of replicas is not set instantly, instead, the safest value from the stabilization window is chosen.
+| HPAScalingRules configures the scaling behavior for one direction via scaling Policy Rules and a configurable metric tolerance.
+
+Scaling Policy Rules are applied after calculating DesiredReplicas from metrics for the HPA. They can limit the scaling velocity by specifying scaling policies. They can prevent flapping by specifying the stabilization window, so that the number of replicas is not set instantly, instead, the safest value from the stabilization window is chosen.
+
+The tolerance is applied to the metric values and prevents scaling too eagerly for small metric variations. (Note that setting a tolerance requires enabling the alpha HPAConfigurableTolerance feature gate.)
 
 | `scaleUp`
 | `object`
-| HPAScalingRules configures the scaling behavior for one direction. These Rules are applied after calculating DesiredReplicas from metrics for the HPA. They can limit the scaling velocity by specifying scaling policies. They can prevent flapping by specifying the stabilization window, so that the number of replicas is not set instantly, instead, the safest value from the stabilization window is chosen.
+| HPAScalingRules configures the scaling behavior for one direction via scaling Policy Rules and a configurable metric tolerance.
+
+Scaling Policy Rules are applied after calculating DesiredReplicas from metrics for the HPA. They can limit the scaling velocity by specifying scaling policies. They can prevent flapping by specifying the stabilization window, so that the number of replicas is not set instantly, instead, the safest value from the stabilization window is chosen.
+
+The tolerance is applied to the metric values and prevents scaling too eagerly for small metric variations. (Note that setting a tolerance requires enabling the alpha HPAConfigurableTolerance feature gate.)
 
 |===
 === .spec.behavior.scaleDown
 Description::
 +
 --
-HPAScalingRules configures the scaling behavior for one direction. These Rules are applied after calculating DesiredReplicas from metrics for the HPA. They can limit the scaling velocity by specifying scaling policies. They can prevent flapping by specifying the stabilization window, so that the number of replicas is not set instantly, instead, the safest value from the stabilization window is chosen.
+HPAScalingRules configures the scaling behavior for one direction via scaling Policy Rules and a configurable metric tolerance.
+
+Scaling Policy Rules are applied after calculating DesiredReplicas from metrics for the HPA. They can limit the scaling velocity by specifying scaling policies. They can prevent flapping by specifying the stabilization window, so that the number of replicas is not set instantly, instead, the safest value from the stabilization window is chosen.
+
+The tolerance is applied to the metric values and prevents scaling too eagerly for small metric variations. (Note that setting a tolerance requires enabling the alpha HPAConfigurableTolerance feature gate.)
 --
 
 Type::
@@ -136,7 +148,7 @@ Type::
 
 | `policies`
 | `array`
-| policies is a list of potential scaling polices which can be used during scaling. At least one policy must be specified, otherwise the HPAScalingRules will be discarded as invalid
+| policies is a list of potential scaling polices which can be used during scaling. If not set, use the default values: - For scale up: allow doubling the number of pods, or an absolute change of 4 pods in a 15s window. - For scale down: allow all pods to be removed in a 15s window.
 
 | `policies[]`
 | `object`
@@ -150,12 +162,20 @@ Type::
 | `integer`
 | stabilizationWindowSeconds is the number of seconds for which past recommendations should be considered while scaling up or scaling down. StabilizationWindowSeconds must be greater than or equal to zero and less than or equal to 3600 (one hour). If not set, use the default values: - For scale up: 0 (i.e. no stabilization is done). - For scale down: 300 (i.e. the stabilization window is 300 seconds long).
 
+| `tolerance`
+| xref:../objects/index.adoc#io-k8s-apimachinery-pkg-api-resource-Quantity[`Quantity`]
+| tolerance is the tolerance on the ratio between the current and desired metric value under which no updates are made to the desired number of replicas (e.g. 0.01 for 1%). Must be greater than or equal to zero. If not set, the default cluster-wide tolerance is applied (by default 10%).
+
+For example, if autoscaling is configured with a memory consumption target of 100Mi, and scale-down and scale-up tolerances of 5% and 1% respectively, scaling will be triggered when the actual consumption falls below 95Mi or exceeds 101Mi.
+
+This is an alpha field and requires enabling the HPAConfigurableTolerance feature gate.
+
 |===
 === .spec.behavior.scaleDown.policies
 Description::
 +
 --
-policies is a list of potential scaling polices which can be used during scaling. At least one policy must be specified, otherwise the HPAScalingRules will be discarded as invalid
+policies is a list of potential scaling polices which can be used during scaling. If not set, use the default values: - For scale up: allow doubling the number of pods, or an absolute change of 4 pods in a 15s window. - For scale down: allow all pods to be removed in a 15s window.
 --
 
 Type::
@@ -202,7 +222,11 @@ Required::
 Description::
 +
 --
-HPAScalingRules configures the scaling behavior for one direction. These Rules are applied after calculating DesiredReplicas from metrics for the HPA. They can limit the scaling velocity by specifying scaling policies. They can prevent flapping by specifying the stabilization window, so that the number of replicas is not set instantly, instead, the safest value from the stabilization window is chosen.
+HPAScalingRules configures the scaling behavior for one direction via scaling Policy Rules and a configurable metric tolerance.
+
+Scaling Policy Rules are applied after calculating DesiredReplicas from metrics for the HPA. They can limit the scaling velocity by specifying scaling policies. They can prevent flapping by specifying the stabilization window, so that the number of replicas is not set instantly, instead, the safest value from the stabilization window is chosen.
+
+The tolerance is applied to the metric values and prevents scaling too eagerly for small metric variations. (Note that setting a tolerance requires enabling the alpha HPAConfigurableTolerance feature gate.)
 --
 
 Type::
@@ -217,7 +241,7 @@ Type::
 
 | `policies`
 | `array`
-| policies is a list of potential scaling polices which can be used during scaling. At least one policy must be specified, otherwise the HPAScalingRules will be discarded as invalid
+| policies is a list of potential scaling polices which can be used during scaling. If not set, use the default values: - For scale up: allow doubling the number of pods, or an absolute change of 4 pods in a 15s window. - For scale down: allow all pods to be removed in a 15s window.
 
 | `policies[]`
 | `object`
@@ -231,12 +255,20 @@ Type::
 | `integer`
 | stabilizationWindowSeconds is the number of seconds for which past recommendations should be considered while scaling up or scaling down. StabilizationWindowSeconds must be greater than or equal to zero and less than or equal to 3600 (one hour). If not set, use the default values: - For scale up: 0 (i.e. no stabilization is done). - For scale down: 300 (i.e. the stabilization window is 300 seconds long).
 
+| `tolerance`
+| xref:../objects/index.adoc#io-k8s-apimachinery-pkg-api-resource-Quantity[`Quantity`]
+| tolerance is the tolerance on the ratio between the current and desired metric value under which no updates are made to the desired number of replicas (e.g. 0.01 for 1%). Must be greater than or equal to zero. If not set, the default cluster-wide tolerance is applied (by default 10%).
+
+For example, if autoscaling is configured with a memory consumption target of 100Mi, and scale-down and scale-up tolerances of 5% and 1% respectively, scaling will be triggered when the actual consumption falls below 95Mi or exceeds 101Mi.
+
+This is an alpha field and requires enabling the HPAConfigurableTolerance feature gate.
+
 |===
 === .spec.behavior.scaleUp.policies
 Description::
 +
 --
-policies is a list of potential scaling polices which can be used during scaling. At least one policy must be specified, otherwise the HPAScalingRules will be discarded as invalid
+policies is a list of potential scaling polices which can be used during scaling. If not set, use the default values: - For scale up: allow doubling the number of pods, or an absolute change of 4 pods in a 15s window. - For scale down: allow all pods to be removed in a 15s window.
 --
 
 Type::

rest_api/cluster_apis/ipaddress-ipam-cluster-x-k8s-io-v1beta1.adoc

@@ -39,14 +39,14 @@ Type::
 
 | `spec`
 | `object`
-| IPAddressSpec is the desired state of an IPAddress.
+| spec is the desired state of IPAddress.
 
 |===
 === .spec
 Description::
 +
 --
-IPAddressSpec is the desired state of an IPAddress.
+spec is the desired state of IPAddress.
 --
 
 Type::