Uploaded image for project: 'OpenShift Bugs'
  1. OpenShift Bugs
  2. OCPBUGS-2454

Misleading sentence regarding egressip objects with multiple egress IPs

XMLWordPrintable

    • Low
    • False
    • Hide

      None

      Show
      None

      Description of problem:

      The following paragraph is wrong or, at least misleading:
      
      Additionally, if an EgressIP object specifies multiple egress IP addresses, there is no guarantee which of the egress IP addresses might be assigned to a pod. For example, if a pod matches a selector for an EgressIP object with two egress IP addresses, 10.10.20.1 and 10.10.20.2, either might be assigned to the pod.
      
      The reason is that, when a single egressip object specifies multiple egress IPs, each 5-tuple (source port, destination port, source IP, destination IP and IP protocol) is assigned an egress IP, but the sentence gives the impression that each pod sticks to one of the egress IPs, and that's wrong. In fact, other fragments of the document do describe the right behavior, so they contradict this paragraph.
      
      The right sentence should say something like:
      
      Additionally, if an EgressIP object specifies multiple egress IP addresses, there is no guarantee which of the egress IP addresses might be used. For example, if a pod matches a selector for an EgressIP object with two egress IP addresses, 10.10.20.1 and 10.10.20.2, either might be used for each TCP connection or UDP conversation.
      

      Version-Release number of selected component (if applicable):

      4.11.0
      

      How reproducible:

      Always.
      

      Steps to Reproduce:

      1. Read the docs
      2.
      3.
      

      Actual results:

      Misleading paragraph
      

      Expected results:

      Not misleading paragraph.
      

      Additional info:

      Shouldn't we have the doc bugs template bug instead of the default one? Maybe this is work in progress already.
      
      In the meanwhile, link for the docs with wrong paragraph: https://docs.openshift.com/container-platform/4.11/networking/ovn_kubernetes_network_provider/configuring-egress-ips-ovn.html#configuring-egress-ips-ovn
      

            rhn-support-skopacz Sebastian Kopacz
            rhn-support-palonsor Pablo Alonso Rodriguez
            Huiran Wang Huiran Wang
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: