Merge pull request #46245 from dulek/openstack-etp-local

Bug 2018481: OpenStack: Add note about ETP=Local and Octavia

Author: bergerhoffer

modules/installation-osp-setting-cloud-provider-options.adoc

@@ -39,17 +39,31 @@ Configuring Octavia for load balancing is a common case. For example:
 [LoadBalancer]
 use-octavia=true <1>
 lb-provider = "amphora" <2>
-floating-network-id="d3deb660-4190-40a3-91f1-37326fe6ec4a"<3>
+floating-network-id="d3deb660-4190-40a3-91f1-37326fe6ec4a" <3>
+create-monitor = True <4>
+monitor-delay = 10s <5>
+monitor-timeout = 10s <6>
+monitor-max-retries = 1 <7>
 #...
 ----
 <1> This property enables Octavia integration.
 <2> This property sets the Octavia provider that your load balancer uses. It accepts `"ovn"` or `"amphora"` as values. If you choose to use OVN, you must also set `lb-method` to `SOURCE_IP_PORT`.
 <3> This property is required if you want to use multiple external networks with your cluster. The cloud provider creates floating IP addresses on the network that is specified here.
+<4> This property controls whether the cloud provider creates health monitors for Octavia load balancers. Set the value to `True` to create health monitors. As of {rh-openstack} 16.1 and 16.2, this feature is only available for the Amphora provider.
+<5> This property sets the frequency with which endpoints are monitored. The value must be in the `time.ParseDuration()` format. This property is required if the value of the `create-monitor` property is `True`.
+<6> This property sets the time that monitoring requests are open before timing out. The value must be in the `time.ParseDuration()` format. This property is required if the value of the `create-monitor` property is `True`.
+<7> This property defines how many successful monitoring requests are required before a load balancer is marked as online. The value must be an integer. This property is required if the value of the `create-monitor` property is `True`.
+
 +
 [IMPORTANT]
 ====
 Prior to saving your changes, verify that the file is structured correctly. Clusters might fail if properties are not placed in the appropriate section.
 ====
++
+[IMPORTANT]
+====
+You must set the value of the `create-monitor` property to `True` if you use services that have the value of the `.spec.endpointTrafficPolicy` property set to `Local`. The OVN Octavia provider in {rh-openstack} 16.1 and 16.2 does not support health monitors. Therefore, services that have `ETP` parameter values set to `Local` might not respond when the `lb-provider` value is set to `"ovn"`.
+====
 
 . Save the changes to the file and proceed with installation.
 +

modules/nw-ingress-controller-configuration-parameters.adoc

@@ -62,6 +62,13 @@ spec:
       statsPort: 1936
 ----
 ====
++
+[NOTE]
+====
+On {rh-openstack-first}, the `LoadBalancerService` endpoint publishing strategy is only supported if a cloud provider is configured to create health monitors. For {rh-openstack} 16.1 and 16.2, this strategy is only possible if you use the Amphora Octavia provider.
+
+For more information, see the "Setting cloud provider options" section of the {rh-openstack} installation documentation.
+====
 
 For most platforms, the `endpointPublishingStrategy` value can be updated. On GCP, you can configure the following `endpointPublishingStrategy` fields: