Uploaded image for project: 'OpenShift Service Mesh'
  1. OpenShift Service Mesh
  2. OSSM-5597

[Enhancement] Improve information about Gateway API CRDs version

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Unresolved
    • Icon: Normal Normal
    • None
    • OSSM 2.4.5, OSSM 2.3.9, OSSM 2.5.0
    • None
    • False
    • None
    • False

      There isn't any[1] info in the documentation about which Gateway API CRD's should be installed with which OSSM version when the user wants to use Gateway API experimental feature.

      The backward compatibility is not guaranteed for Gateway API CRDs (since the Gateway API CRDs were in an experimental phase) so each OSSM version should use the specific Gateway API CRDs version (according to the Istio version).

      Some table will be helpful in this case:

      OSSM version Istio version Required Gateway API version[2] Note
      2.3.x 1.14.x v0.4.0 OSSM-3890 For multitenant mesh deployment, all Gateway API CRDs need to be present, use experimental v0.5.1 branch
      2.4.x 1.16.x v0.5.1 OSSM-3890 For multitenant mesh deployment, all Gateway API CRDs need to be present, use experimental branch
      2.5.x 1.18.x v0.6.2 GH-issue Use experimental branch because ReferenceGrand is missing in v0.6.2

      How to install CRD's:
      Standard

      kubectl get crd gateways.gateway.networking.k8s.io || { kubectl kustomize "github.com/kubernetes-sigs/gateway-api/config/crd?ref=v0.5.1" | kubectl apply -f -; }
      

      Experimental

      kubectl get crd gateways.gateway.networking.k8s.io || { kubectl kustomize "github.com/kubernetes-sigs/gateway-api/config/crd/experimental?ref=v0.5.1" | kubectl apply -f -; }
      

      =============
      [1] - For OSSM 2.3.9 , there is info how to install CRD's https://docs.openshift.com/container-platform/4.14/service_mesh/v2x/servicemesh-release-notes.html#installing-the-gateway-api-crds with version `v0.4.0`

      =============
      [2] - ref:
      istio 1.14: https://istio.io/v1.14/docs/tasks/traffic-management/ingress/gateway-api/
      istio 1.16: https://istio.io/v1.16/docs/tasks/traffic-management/ingress/gateway-api/
      istio 1.18: https://istio.io/v1.18/docs/tasks/traffic-management/ingress/gateway-api/

            rhn-support-tokeefe Tim O'Keefe
            mkralik@redhat.com Matej Kralik
            Votes:
            0 Vote for this issue
            Watchers:
            5 Start watching this issue

              Created:
              Updated: