Merge branch '3.44.0' into merge_3.44.0

F5Networks · Mar 27, 2023 · 885e7fe · 885e7fe
2 parents f60ae48 + 7230fd2
commit 885e7fe
Show file tree

Hide file tree

Showing 178 changed files with 73,133 additions and 3,855 deletions.
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,6 +1,24 @@
 # Changelog
 Changes to this project are documented in this file. More detail (including information on releases before 3.4) and links can be found in the AS3 [Document Revision History](https://clouddocs.f5.com/products/extensions/f5-appsvcs-extension/latest/refguide/revision-history.html).
 
+## 3.44.0
+
+### Added
+- AUTOTOOL-3572: Support "use" reference for virtualServer under GSLB_Pool
+- AUTOTOOL-3655: ([GitHub Issue 688](https://github.com/F5Networks/f5-appsvcs-extension/issues/688)): Option to prefer client subnet in GSLB_Domain
+
+### Fixed
+- AUTOTOOL-3331: Service with partial mask and custom route domain fails to POST twice
+- AUTOTOOL-3521: ([GitHub Issue 660](https://github.com/F5Networks/f5-appsvcs-extension/issues/660)): Address_Discovery static node type does not work
+- AUTOTOOL-3606: ([GitHub Issue 274](https://github.com/F5Networks/f5-appsvcs-extension/issues/274)): expose TLS_Server option to enable/disable "default profile for SNI"
+- AUTOTOOL-3325: Improve error handling in SettingsHandler
+- AUTOTOOL-3657: Invalid SNAT_Translation error when multiple Tenants with SNAT_Pools are declared
+- AUTOTOOL-3666: ([GitHub Issue 691](https://github.com/F5Networks/f5-appsvcs-extension/issues/691)): HTTP_Acceleration_Profile does not handle backslashes in uriExcludeList, uriIncludeList, uriIncludeOverrideList, and uriPinnedList properties.
+
+### Changed
+
+### Removed
+
 ## 3.43.0
 
 ### Added

diff --git a/Makefile b/Makefile
@@ -19,7 +19,7 @@ help:
 %: Makefile
 	node scripts/build/schema-build-doc.js
 	node scripts/build/schema-to-rst.js
-	node scripts/build/generate-all-properties-declaration.js
+	node scripts/build/generate-all-properties-declaration.js -- --skip-require
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
 # Custom commands for building and testing project documentation
@@ -67,4 +67,3 @@ rpm:
 .PHONY: docker-rpm
 docker-rpm:
 	./scripts/build/docker-rpmbuild.sh
-
diff --git a/README.md b/README.md
@@ -1,6 +1,5 @@
 # F5 BIG-IP Application Services 3 Extension (AS3)
 
-[![Slack Status](https://f5cloudsolutions.herokuapp.com/badge.svg)](https://f5cloudsolutions.herokuapp.com)
 [![Releases](https://img.shields.io/github/release/f5networks/f5-appsvcs-extension.svg)](https://github.com/f5networks/f5-appsvcs-extension/releases)
 [![Issues](https://img.shields.io/github/issues/f5networks/f5-appsvcs-extension.svg)](https://github.com/f5networks/f5-appsvcs-extension/issues)
 

diff --git a/SUPPORT.md b/SUPPORT.md
@@ -20,9 +20,9 @@ Currently supported versions:
 | Software Version | Release Type  | First Customer Ship | End of Support  |
 |------------------|---------------|---------------------|-----------------|
 | AS 3.36.1        | LTS           |  31-May-2022        | 31-Aug-2023     |
-| AS 3.41.0        | Feature       |  14-Nov-2022        | 14-Feb-2023     |
 | AS 3.42.0        | Feature       |  12-Jan-2023        | 12-Apr-2023     |
 | AS 3.43.0        | Feature       |  09-Feb-2023        | 09-May-2023     |
+| AS 3.44.0        | Feature       |  27-Mar-2022        | 27-Jun-2023     |
 
 Versions no longer supported:
 
@@ -79,6 +79,7 @@ Versions no longer supported:
 | AS 3.32.1        | LTS           |  13-Dec-2021        | 13-Dec-2022     |
 | AS 3.39.0        | Feature       |  22-Aug-2022        | 22-Nov-2022     |
 | AS 3.40.0        | Feature       |  04-Oct-2022        | 04-Jan-2023     |
+| AS 3.41.0        | Feature       |  14-Nov-2022        | 14-Feb-2023     |
 
 \* Fix for updated Docker Container packaging only  
 \*\* Update for the schema description for Pool minimumMonitors

diff --git a/contributing/process_release.md b/contributing/process_release.md
@@ -36,6 +36,7 @@
 * Download and copy the built schema file to the correct locations
   * From Artifactory f5-automation-toolchain-generic/f5-appsvcs/`<version>-<build>`, download as3-schema-`<version>-<build>`.json
   * mkdir -p schema/`<version>`
+  * rm schema/latest/*
   * cp as3-schema-`<version>-<build>`.json schema/latest/as3-schema-`<version>-<build>`.json
   * cp as3-schema-`<version>-<build>`.json schema/latest/as3-schema.json
   * cp as3-schema-`<version>-<build>`.json schema/`<version>`/as3-schema-`<version>-<build>`.json
@@ -44,7 +45,7 @@
   * Create a new branch off of develop like any other development task
   * Update version changes to `package.json` and `package-lock.json`.  The release number of the new version should start at 0 (e.g. 3.10.0-4 would become 3.11.0-0).
   * Update the `info.version` property in `docs/openapi.yaml` to the new AS3 version (e.g. 3.27.0).
-  * Add a new version to the beginning of the schemaVersion enum in `schema/latest/core-schema.js` using the preexisting format.
+  * Add a new version to the beginning of the schemaVersion enum in `src/schema/latest/core-schema.js` using the preexisting format.
   * Adding a new block to `CHANGELOG.md` would also be appreciated.
   * Create a merge request like for any other development task and announce on Teams `AS3-DO General`.
 
@@ -97,7 +98,13 @@ Tag master with the release version, for example: 3.10.0 (Note: if you are taggi
   * Edit the AS3 schedule to set the `gitBranch` variable to the LTS branch.
   * Run the AS3 schedule.
   * After the build completes, edit the AS3 schedule to set the `gitBranch` variable back to develop.
-* Merge the release branch CHANGELOG into develop and create an MR for this.
+* Using the GUI create a tag off the LTS branch (e.g. 3.36.1)
+  * In the GUI go to `Repository -> Tags -> New tag`.
+  * The name of the tag should be the LTS version with a 'v' at the front (e.g. v3.36.1).
+  * Update the `createFrom` to point at the LTS branch.
+  * Set the message to: `LTS release v<LTS version>` (e.g. "LTS release v3.36.1")
+* Merge the LTS branch (without updating the package version) into develop and create an MR for this.
+* Merge the LTS branch (only update package version if LTS is latest) into master and create an MR for this.
 
 ## Documentation Release process
 * After the third sprint is finished and the release branch has been created, checkout out the dev release branch and then merge it into **doc-release-branch**.

diff --git a/docs/declarations/gslb.rst b/docs/declarations/gslb.rst
@@ -281,7 +281,37 @@ This declaration creates the following objects on the BIG-IP (this declaration d
 .. literalinclude:: ../../examples/declarations/example-gslb-discovery.json
    :language: json
 
-:ref:`Back to top<sd-examples>`
+:ref:`Back to top<gslbexamples>`
+
+|
+
+.. _gslbpooluse:
+
+
+Referencing a virtual server in a GSLB pool with a use pointer
+``````````````````````````````````````````````````````````````
+.. sidebar:: :fonticon:`fa fa-info-circle fa-lg` Version Notice:
+
+   Support for referencing a virtual server with a use pointer in a GSLB pool is available in BIG-IP AS3 v3.44 and later. You must have BIG-IP DNS (formerly GTM) provisioned to use these features.
+
+This example shows how you can reference a virtual server in a GSLB pool with a **use** pointer to a virtual server defined in the declaration. In previous versions, you would have to include the full path to the virtual server on the BIG-IP.  See |poolref| and |useref| in the :ref:`Schema Reference<schema-reference>` for usage options and additional features for GSLB.
+
+.. NOTE:: When using GSLB features, you must be aware of the items pointed out in :ref:`Warnings<gslbnote>`, notably BIG-IP AS3 completely overwrites non-AS3 topologies when a declaration is submitted.  
+
+
+This declaration creates the following objects on the BIG-IP:
+
+- A GSLB data center named **testDataCenter**.
+- A GSLB server named **testServer** with one device and a reference to the data center.
+- A tenant named **TEST_GSLB_Pool**.
+- An Application named **application**.
+- A GSLB pool named **gslbPool** with use pointers to the GSLB server and the virtual server defined below it.
+- A virtual server named **virtualServer** referred to in the GSLB pool.
+
+.. literalinclude:: ../../examples/declarations/example-gslb-pool-virtual-server-use-ref.json
+   :language: json
+
+:ref:`Back to top<gslbexamples>`
 
 
 .. |dnsexpress| raw:: html
@@ -332,6 +362,10 @@ This declaration creates the following objects on the BIG-IP (this declaration d
 
    <a href="https://clouddocs.f5.com/products/extensions/f5-appsvcs-extension/latest/refguide/schema-reference.html#gslb-pool">GSLB_Pool</a>
 
+.. |useref| raw:: html
+
+   <a href="https://clouddocs.f5.com/products/extensions/f5-appsvcs-extension/latest/refguide/schema-reference.html#pointer-gslb-pool">Pointer_GSLB_Pool</a>
+
 .. |poolmember| raw:: html
 
    <a href="https://clouddocs.f5.com/products/extensions/f5-appsvcs-extension/latest/refguide/schema-reference.html#gslb-pool-member-a">GSLB_Pool_Member_A</a>

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
@@ -1,6 +1,6 @@
 openapi: '3.0.0'
 info:
-  version: 3.43.0
+  version: 3.44.0
   title: F5 BIG-IP AS3
   description: This reference describes the BIG-IP AS3 API and available endpoints. For more details, see https://clouddocs.f5.com/products/extensions/f5-appsvcs-extension/latest/refguide/as3-api.html
 basePath: /mgmt/shared/appsvcs

diff --git a/docs/refguide/revision-history.rst b/docs/refguide/revision-history.rst
@@ -11,6 +11,10 @@ Document Revision History
         - Description
         - Date
 
+      * - 3.44
+        - Updated the documentation for AS3 v3.44.0. This release contains the following changes: |br| * Added support for referencing a virtual server in a GSLB pool with a use pointer (see :ref:`GSLB Pool with use pointer<gslbpooluse>`)  |br| * Added support for Prefer Client Subnet for GSLB Domains (see |gslbd| in the Schema Reference) |br| |br| Issues Resolved: |br| * Service with partial mask and custom route domain fails to POST twice |br| * Address_Discovery static node type does not work, `GitHub Issue 660 <https://github.com/F5Networks/f5-appsvcs-extension/issues/660>`_ |br| * Expose TLS_Server option to enable/disable "default profile for SNI", `GitHub Issue 274 <https://github.com/F5Networks/f5-appsvcs-extension/issues/274>`_ |br| * Improve error handling in SettingsHandler |br| * Invalid SNAT_Translation error when multiple Tenants with SNAT_Pools are declared |br| * HTTP_Acceleration_Profile does not handle backslashes in uriExcludeList, uriIncludeList, uriIncludeOverrideList, and uriPinnedList properties, `GitHub Issue 691 <https://github.com/F5Networks/f5-appsvcs-extension/issues/691>`_
+        - 3-27-23
+
       * - 3.43
         - Updated the documentation for AS3 v3.43.0. This release contains the following changes: |br| * Added new properties for the Security Log Profile NAT object (see :ref:`Security Log Profile NAT<slnat>`), `GitHub Issue 533 <https://github.com/F5Networks/f5-appsvcs-extension/issues/533>`_  |br| * Added support for ALG Log profiles (see :ref:`ALG Log Profile<alglog>`), `GitHub Issue 619 <https://github.com/F5Networks/f5-appsvcs-extension/issues/619>`_ |br| * Added support for creating RTSP profiles (see the updated :ref:`RTSP example<rtsp-ex>`), `GitHub Issue 575 <https://github.com/F5Networks/f5-appsvcs-extension/issues/575>`_ |br| * Added support for creating TFTP profiles (see the updated :ref:`TFTP example<tftpprof>`), `GitHub Issue 576 <https://github.com/F5Networks/f5-appsvcs-extension/issues/576>`_ |br| * Added support for the ALG Log profile and log publisher on FTP profiles (see the updated :ref:`FTP example<ftpprof>`), `GitHub Issue 570 <https://github.com/F5Networks/f5-appsvcs-extension/issues/570>`_ |br| * Added support for SOCKS profiles (see :ref:`SOCKS profile<socks>`) |br| * Added a note about using **virtualPort** on a service for applications that use non-standard ports (see :ref:`Notes and Tips <notestips>`) |br| |br| Issues Resolved: |br| * Shared virtual addresses are not removed when no longer in use |br| * Unchecked mode fails when URLs have authentication
         - 2-9-23
@@ -349,3 +353,7 @@ Document Revision History
 .. |tlss| raw:: html
 
    <a href="https://clouddocs.f5.com/products/extensions/f5-appsvcs-extension/latest/refguide/schema-reference.html#tls-server" target="_blank">TLS_Server</a>
+
+.. |gslbd| raw:: html
+
+   <a href="https://clouddocs.f5.com/products/extensions/f5-appsvcs-extension/latest/refguide/schema-reference.html#gslb-domain" target="_blank">GSLB_Domain</a>
diff --git a/docs/userguide/quick-start.rst b/docs/userguide/quick-start.rst
@@ -37,7 +37,6 @@ Quick start example declaration
 
 .. IMPORTANT:: This Quick Start example, and most of the example declarations have been updated in the documentation for BIG-IP AS3 3.20 to remove any **template** that was specified, and rename any virtual services that used the name **serviceMain** to **service**. In BIG-IP AS3 3.20, the **generic** template is the default, which allows services to use any name.  |br| |br| This also means that many of these declarations on a version prior to 3.20 they will fail unless you add a template.  See :ref:`this FAQ entry <servmain-ref>` and :ref:`this Troubleshooting entry<exampleupdates>` for more information.
 
-
 .. code-block:: json
    :linenos:
 

diff --git a/examples/declarations/example-gslb-pool-virtual-server-use-ref.json b/examples/declarations/example-gslb-pool-virtual-server-use-ref.json
@@ -0,0 +1,53 @@
+{
+    "class": "ADC",
+    "schemaVersion": "3.44.0",
+    "id": "GSLB_Pool",
+    "Common": {
+        "class": "Tenant",
+        "Shared": {
+            "class": "Application",
+            "template": "shared",
+            "testDataCenter": {
+            	"class": "GSLB_Data_Center"
+            },
+            "testServer": {
+                "class": "GSLB_Server",
+                "dataCenter": {
+                    "use": "testDataCenter"
+                },
+                "devices": [
+                    {
+                        "address": "10.10.10.10"
+                    }
+                ],
+                "virtualServerDiscoveryMode": "enabled-no-delete"
+            }
+        }
+    },
+    "TEST_GSLB_Pool": {
+        "class": "Tenant",
+        "Application": {
+            "class": "Application",
+            "gslbPool": {
+                "class": "GSLB_Pool",
+                "resourceRecordType": "A",
+                "members": [
+                    {
+                        "server": {
+                            "use": "/Common/Shared/testServer"
+                        },
+                        "virtualServer": {
+                            "use": "virtualServer"
+                        }
+                    }
+                ]
+            },
+            "virtualServer": {
+                "class": "Service_HTTP",
+                "virtualAddresses": [
+                    "10.10.1.1"
+                ]
+            }
+        }
+    }
+}
diff --git a/examples/declarations/example-multiple-ssl-tls-certs-in-one-profile.json b/examples/declarations/example-multiple-ssl-tls-certs-in-one-profile.json
@@ -25,7 +25,8 @@
                         "certificate": "webcert1"
                     },
                     {
-                        "certificate": "webcert2"
+                        "certificate": "webcert2",
+                        "sniDefault": true
                     }]
                 },
                 "webcert1": {

diff --git a/make.bat b/make.bat
@@ -15,7 +15,7 @@ if "%1" == "" goto help
 
 node scripts/build/schema-build-doc.js
 node scripts/build/schema-to-rst.js
-node scripts/build/generate-all-properties-declaration.js
+node scripts/build/generate-all-properties-declaration.js -- --skip-require
 
 %SPHINXBUILD% >NUL 2>NUL
 if errorlevel 9009 (