Skip to content

Commit 5a41103

Browse files
authored
[OSDOCS-4103] Remove outdated limitations re: Kuryr, RHOSP 13, UDP/TCP, and load balancing (#53911)
1 parent 9870688 commit 5a41103

File tree

2 files changed

+0
-160
lines changed

2 files changed

+0
-160
lines changed

modules/installation-osp-kuryr-known-limitations.adoc

Lines changed: 0 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -35,36 +35,8 @@ services can cause you to run out of resources.
3535
Deployments of later versions of {rh-openstack} that have the OVN Octavia driver disabled also
3636
use the Amphora driver. They are subject to the same resource concerns as earlier versions of {rh-openstack}.
3737

38-
* Octavia {rh-openstack} versions before 13.0.13 do not support UDP listeners. Therefore,
39-
{product-title} UDP services are not supported.
40-
41-
* Octavia {rh-openstack} versions before 13.0.13 cannot listen to multiple protocols on the
42-
same port. Services that expose the same port to different protocols, like TCP
43-
and UDP, are not supported.
44-
4538
* Kuryr SDN does not support automatic unidling by a service.
4639

47-
[discrete]
48-
[id="openstack-go-limitations_{context}"]
49-
== {rh-openstack} environment limitations
50-
51-
There are limitations when using Kuryr SDN that depend on your deployment environment.
52-
53-
Because of Octavia's lack of support for the UDP protocol and multiple listeners, if the {rh-openstack} version is earlier than 13.0.13, Kuryr forces pods to use TCP for DNS resolution.
54-
55-
In Go versions 1.12 and earlier, applications that are compiled with CGO support disabled use UDP only. In this case,
56-
the native Go resolver does not recognize the `use-vc` option in `resolv.conf`, which controls whether TCP is forced for DNS resolution.
57-
As a result, UDP is still used for DNS resolution, which fails.
58-
59-
To ensure that TCP forcing is allowed, compile applications either with the environment variable `CGO_ENABLED` set to `1`, i.e. `CGO_ENABLED=1`, or ensure that the variable is absent.
60-
61-
In Go versions 1.13 and later, TCP is used automatically if DNS resolution using UDP fails.
62-
63-
[NOTE]
64-
====
65-
musl-based containers, including Alpine-based containers, do not support the `use-vc` option.
66-
====
67-
6840
[discrete]
6941
[id="openstack-upgrade-limitations_{context}"]
7042
== {rh-openstack} upgrade limitations
@@ -83,10 +55,3 @@ If the operator takes the first option, there might be short downtimes during fa
8355

8456
If the operator takes the second option, the existing load balancers will not support upgraded Octavia
8557
API features, like UDP listeners. In this case, users must recreate their Services to use these features.
86-
87-
[IMPORTANT]
88-
====
89-
If {product-title} detects a new Octavia version that supports UDP load balancing, it recreates the DNS service automatically. The service recreation ensures that the service default supports UDP load balancing.
90-
91-
The recreation causes the DNS service approximately one minute of downtime.
92-
====

modules/installation-osp-kuryr-octavia-configuration.adoc

Lines changed: 0 additions & 125 deletions
Original file line numberDiff line numberDiff line change
@@ -77,24 +77,6 @@ The Octavia container versions vary depending upon the specific
7777
This may take some time depending on the speed of your network and Undercloud
7878
disk.
7979
80-
. Since an Octavia load balancer is used to access the {product-title} API, you must
81-
increase their listeners' default timeouts for the connections. The default
82-
timeout is 50 seconds. Increase the timeout to 20 minutes by passing the
83-
following file to the Overcloud deploy command:
84-
+
85-
[source,terminal]
86-
----
87-
(undercloud) $ cat octavia_timeouts.yaml
88-
parameter_defaults:
89-
OctaviaTimeoutClientData: 1200000
90-
OctaviaTimeoutMemberData: 1200000
91-
----
92-
+
93-
[NOTE]
94-
====
95-
This is not needed for {rh-openstack} 13.0.13+.
96-
====
97-
9880
. Install or update your Overcloud environment with Octavia:
9981
+
10082
[source,terminal]
@@ -122,113 +104,6 @@ backend is ML2/OVS. There is no need for modifications if the backend is
122104
ML2/OVN.
123105
====
124106
125-
. In {rh-openstack} versions earlier than 13.0.13, add the project ID
126-
to the `octavia.conf` configuration file after you create the project.
127-
* To enforce
128-
network policies across services, like when traffic goes through
129-
the Octavia load balancer, you must ensure Octavia creates the Amphora VM
130-
security groups on the user project.
131-
+
132-
This change ensures that required load balancer security groups belong to that project,
133-
and that they can be updated to enforce services isolation.
134-
+
135-
[NOTE]
136-
====
137-
This task is unnecessary in {rh-openstack} version 13.0.13 or later.
138-
139-
Octavia implements a new ACL API that restricts access to the load
140-
balancers VIP.
141-
====
142-
143-
.. Get the project ID
144-
+
145-
[source,terminal]
146-
----
147-
$ openstack project show <project>
148-
----
149-
+
150-
.Example output
151-
[source,terminal]
152-
----
153-
+-------------+----------------------------------+
154-
| Field | Value |
155-
+-------------+----------------------------------+
156-
| description | |
157-
| domain_id | default |
158-
| enabled | True |
159-
| id | PROJECT_ID |
160-
| is_domain | False |
161-
| name | *<project>* |
162-
| parent_id | default |
163-
| tags | [] |
164-
+-------------+----------------------------------+
165-
----
166-
167-
.. Add the project ID to `octavia.conf` for the controllers.
168-
169-
... Source the `stackrc` file:
170-
+
171-
[source,terminal]
172-
----
173-
$ source stackrc # Undercloud credentials
174-
----
175-
176-
... List the Overcloud controllers:
177-
+
178-
[source,terminal]
179-
----
180-
$ openstack server list
181-
----
182-
+
183-
.Example output
184-
[source,terminal]
185-
----
186-
+--------------------------------------+--------------+--------+-----------------------+----------------+------------+
187-
188-
| ID | Name | Status | Networks
189-
| Image | Flavor |
190-
191-
+--------------------------------------+--------------+--------+-----------------------+----------------+------------+
192-
193-
| 6bef8e73-2ba5-4860-a0b1-3937f8ca7e01 | controller-0 | ACTIVE |
194-
ctlplane=192.168.24.8 | overcloud-full | controller |
195-
196-
| dda3173a-ab26-47f8-a2dc-8473b4a67ab9 | compute-0 | ACTIVE |
197-
ctlplane=192.168.24.6 | overcloud-full | compute |
198-
199-
+--------------------------------------+--------------+--------+-----------------------+----------------+------------+
200-
----
201-
202-
... SSH into the controller(s).
203-
+
204-
[source,terminal]
205-
----
206-
207-
----
208-
209-
... Edit the `octavia.conf` file to add the project into the list of projects where
210-
Amphora security groups are on the user's account.
211-
+
212-
----
213-
# List of project IDs that are allowed to have Load balancer security groups
214-
# belonging to them.
215-
amp_secgroup_allowed_projects = PROJECT_ID
216-
----
217-
218-
.. Restart the Octavia worker so the new configuration loads.
219-
+
220-
[source,terminal]
221-
----
222-
controller-0$ sudo docker restart octavia_worker
223-
----
224-
225-
[NOTE]
226-
====
227-
Depending on your {rh-openstack} environment, Octavia might not support UDP
228-
listeners. If you use Kuryr SDN on {rh-openstack} version 13.0.13 or earlier, UDP services are not supported.
229-
{rh-openstack} version 16 or later support UDP.
230-
====
231-
232107
[id="installation-osp-kuryr-octavia-driver_{context}"]
233108
== The Octavia OVN Driver
234109

0 commit comments

Comments
 (0)