Add example for GSLB NextGen routes (#2656)

F5Networks · Nov 29, 2022 · 973d47c · 973d47c
1 parent 1c75988
commit 973d47c
Show file tree

Hide file tree

Showing 2 changed files with 92 additions and 21 deletions.
diff --git a/docs/RELEASE-NOTES.rst b/docs/RELEASE-NOTES.rst
@@ -14,7 +14,7 @@ Added Functionality
         * Support Path based A/B deployment for Re-encrypt termination
         * Support to create Health Monitor from the pod liveness probe that route exposes. Refer `Documentation <https://github.com/F5Networks/k8s-bigip-ctlr/tree/master/docs/config_examples/next-gen-routes>`_ for more details
         * Support for Default SSL profiles from baseRouteSpec in extended Configmap
-        * GSLB support for routes
+        * GSLB support for routes in AS3 mode
     * CRD
         * CIS configures GTM configuration in default partition
         * Pool reselect support for VS and TS
@@ -190,18 +190,18 @@ Known Issues
 -------------
 Bug Fixes
 ````````````
-* :issues:`2030` Changes to Ingress resource ServicePort are now reflected on BIG-IP.
-* :issues:`2205` Bulk deletion of EDNS handled properly.
-* :issues:`2255` ServicePort is now optional and multi-port service handled properly in ConfigMaps.
-* :issues:`2164` CIS properly updates configuration in BIGIP when configured with agent CCCL and log-level DEBUG.
-* :issues:`2191` CIS properly logs iApps when configured with agent CCCL.
-* :issues:`2220` CRD VirtualServer status reported correctly when using hostGroup.
-* :issues:`2209` ConfigMap errors logs now contain ConfigMap name and namespace.
+* :issues: 2030  Changes to Ingress resource ServicePort are now reflected on BIG-IP.
+* :issues: 2205  Bulk deletion of EDNS handled properly.
+* :issues: 2255  ServicePort is now optional and multi-port service handled properly in ConfigMaps.
+* :issues: 2164  CIS properly updates configuration in BIGIP when configured with agent CCCL and log-level DEBUG.
+* :issues: 2191  CIS properly logs iApps when configured with agent CCCL.
+* :issues: 2220  CRD VirtualServer status reported correctly when using hostGroup.
+* :issues: 2209  ConfigMap errors logs now contain ConfigMap name and namespace.
 * SR - CIS configured in CCCL agent mode properly updates BIG-IP when there are no backend pods to iApps ConfigMaps
 
 FIC Bug Fixes
 ````````````````
-* :issues:`98` IPAM Storage initialisation handled properly.
+* :issues: 98  IPAM Storage initialisation handled properly.
 
 2.8.0
 -------------
@@ -221,12 +221,12 @@ Bug Fixes
 ````````````
 * Added fix for processing oldest route when same host and path in routes
 * Added fix for cis crash with routes
-* :issues:`2212` Fix ExternalDNS adds both VSs to a Wide IP pool with using "httpTraffic: allow" with VS CR
-* :issues:`2221` Fixed Error in CIS logs while deleting multiple VS CRD
-* :issues:`2222` Fix deleting VirtualServer using hostGroup
-* :issues:`2233` TS and VS CRD don't detect the pool members for grafana service
-* :issues:`2234` Fix for CIS crash with subsequent creation and deletion of wrong ConfigMap
-* :issues:`2077` CIS deletes all existing ARP on restart and recreates it, which affects traffic
+* :issues: 2212  Fix ExternalDNS adds both VSs to a Wide IP pool with using "httpTraffic: allow" with VS CR
+* :issues: 2221  Fixed Error in CIS logs while deleting multiple VS CRD
+* :issues: 2222  Fix deleting VirtualServer using hostGroup
+* :issues: 2233  TS and VS CRD don't detect the pool members for grafana service
+* :issues: 2234  Fix for CIS crash with subsequent creation and deletion of wrong ConfigMap
+* :issues: 2077  CIS deletes all existing ARP on restart and recreates it, which affects traffic
 
 2.7.1
 -------------
@@ -235,13 +235,13 @@ Bug Fixes
 * Optimized processing of ConfigMaps with FilterTenants enabled
 * Added support for multihost VS policy rules for same path and service backend combination
 * Improved error handling with EDNS Custom resource
-* :issues:`1872` Support protocol UDP in Services of type LoadBalancer
-* :issues:`1918` ExternalDNS adds both VSs to a Wide IP pool
-* :issues:`2051` Fix AS3 Postdelay issue when error occurs
-* :issues:`2077` Fix recreating ARPs when CIS restarts
-* :issues:`2172` Fix Endpoint NodeName validation issue
+* :issues: 1872 Support protocol UDP in Services of type LoadBalancer
+* :issues: 1918 ExternalDNS adds both VSs to a Wide IP pool
+* :issues: 2051 Fix AS3 Postdelay issue when error occurs
+* :issues: 2077 Fix recreating ARPs when CIS restarts
+* :issues: 2172 Fix Endpoint NodeName validation issue
 * Helm Chart Enhancements:
-    - issues:`2184` Helm Chart ClusterRole does not have correct permissions
+    - issues: 2184 Helm Chart ClusterRole does not have correct permissions
 
 FIC Enhancements
 ````````````````

diff --git a/docs/config_examples/next-gen-routes/README.md b/docs/config_examples/next-gen-routes/README.md
@@ -470,6 +470,77 @@ Label the namespaces:
 * Routes in namespace foo and bar will be mapped into a single group, and a virtual server will be created in the **dev** partition on bigip.
 * Routes in namespace gamma and echo will be grouped together, and a virtual server will be created in **test** partition in bigip, which is defined in the CIS deployment.
 
+## Example GSLB support for routes in AS3 mode
+
+
+* CIS supports only AS3 for GTM in NextGen routes
+
+1) Configure CIS args to AS3 agent:
+```
+- args:
+- --bigip-partition
+- test
+- --cccl-gtm-agent=false
+```
+
+2) Create a route with a host in namespace matching route group
+```
+apiVersion: route.openshift.io/v1
+kind: Route
+metadata:
+  labels:
+    name: svc1
+    f5type: systest
+  name: svc1-route-edge
+  namespace: foo
+spec:
+  host: foo.com
+  path: "/"
+  port:
+    targetPort: 443
+  tls:
+    certificate: |
+      -----BEGIN CERTIFICATE-----
+      -----END CERTIFICATE-----
+    key: |
+      -----BEGIN PRIVATE KEY-----
+      -----END PRIVATE KEY-----
+    termination: edge
+  to:
+    kind: Service
+    name: svc1
+```
+
+3) Create a EDNS resource with domain name
+```
+apiVersion: "cis.f5.com/v1"
+kind: ExternalDNS
+metadata:
+  name: exdns-foo
+  labels:
+    f5cr: "true"
+spec:
+  domainName: foo.com
+  dnsRecordType: A
+  loadBalanceMethod: round-robin
+  pools:
+  - name: pytest-foo-1.com
+    dnsRecordType: A
+    loadBalanceMethod: round-robin
+    dataServerName: /Common/DC-SL
+    monitor:
+      type: https
+      send: "GET /"
+      recv: ""
+      interval: 10
+      timeout: 10
+```
+
+**Note**:
+1)  Before creating EDNS resource, we need to have LTM objects on BigIP
+2) CCCL mode is not supported.
+3) Like CRD's, all EDNS resources will be created in default partition in BigIP
+
 ## Legacy vs next generation routes feature comparison
 
 Unsupported features/annotations in next-gen routes are planned to be supported in upcoming releases: