CI: run sanity tests on ansible-core 2.15 to 2.22 and devel

.github/workflows/ansible-test.yml

@@ -25,12 +25,33 @@ jobs:
   sanity:
     name: Sanity (Ⓐ${{ matrix.ansible }})
     strategy:
+      # run every ansible-core version even if one of them fails
+      fail-fast: false
       matrix:
-        ansible:
-          # It's important that Sanity is tested against all stable-X.Y branches
-          # Testing against `devel` may fail as new tests are added.
-          - stable-2.15
-          - stable-2.16
+        # It's important that Sanity is tested against all stable-X.Y branches
+        # Testing against `devel` may fail as new tests are added.
+        # python is the controller version used to install that ansible-core version
+        include:
+          - ansible: stable-2.15
+            python: '3.11'
+          - ansible: stable-2.16
+            python: '3.12'
+          - ansible: stable-2.17
+            python: '3.12'
+          - ansible: stable-2.18
+            python: '3.13'
+          - ansible: stable-2.19
+            python: '3.13'
+          - ansible: stable-2.20
+            python: '3.13'
+          - ansible: stable-2.21
+            python: '3.13'
+          - ansible: stable-2.22
+            python: '3.13'
+          - ansible: devel
+            python: '3.13'
+    # devel is tested for early warning only, a failure there does not fail the run
+    continue-on-error: ${{ matrix.ansible == 'devel' }}
     runs-on: ubuntu-latest
     steps:
 
@@ -47,7 +68,7 @@ jobs:
         with:
           # it is just required to run that once as "ansible-test sanity" in the docker image
           # will run on all python versions it supports.
-          python-version: '3.10'
+          python-version: ${{ matrix.python }}
 
       # Install the head of the given branch (devel, stable-2.10)
       - name: Install ansible-base (${{ matrix.ansible }})

docs/cp_gaia_simulate_packet.rst

@@ -140,7 +140,7 @@ Examples
 Return Values
 -------------
 
-packet rulebase execution result (always., dict, )
+simulate_packet (always., dict, )
   the NAT and Access rulebase execution result.
 
 

docs/cp_gaia_virtual_systems_facts.rst

@@ -62,19 +62,40 @@ Return Values
 -------------
 
 ansible_facts (always., dict, )
-  The VSNext state facts.
+  The Virtual Systems facts.
 
 
-  enabled (always, bool, )
-    The VSNext state.
+  objects (always, list, )
+    List of configured Virtual Systems.
 
 
-  session-virtual-system-id (always, int, )
-    The Virtual System ID of the current Gaia API session.
+    id (always, int, )
+      Virtual System ID.
 
 
-  member-id (On Scalable and Elastic XL platforms only., int, )
-    The member on which the command was executed.
+    name (always, str, )
+      Virtual System name.
+
+
+    virtual_system_type (always, str, )
+      Virtual System type, Gateway or Switch.
+
+
+    interfaces (always, list, )
+      Network interfaces attached to the Virtual System.
+
+
+
+  from (always, int, )
+    From which element number the query was done.
+
+
+  to (always, int, )
+    To which element number the query was done.
+
+
+  total (always, int, )
+    Total number of elements returned by the query.
 
 
 

docs/cp_gaia_vsnext_state_facts.rst

@@ -69,11 +69,11 @@ ansible_facts (always., dict, )
     The VSNext state.
 
 
-  session-virtual-system-id (always, int, )
+  session_virtual_system_id (always, int, )
     The Virtual System ID of the current Gaia API session.
 
 
-  member-id (On Scalable and Elastic XL platforms only., int, )
+  member_id (On Scalable and Elastic XL platforms only., int, )
     The member on which the command was executed.
 
 

plugins/modules/cp_gaia_simulate_packet.py

@@ -138,7 +138,7 @@
 """
 
 RETURN = """
-packet rulebase execution result:
+simulate_packet:
   description: the NAT and Access rulebase execution result.
   returned: always.
   type: dict

plugins/modules/cp_gaia_virtual_systems_facts.py

@@ -51,21 +51,44 @@
 
 RETURN = """
 ansible_facts:
-    description: The VSNext state facts.
+    description: The Virtual Systems facts.
     returned: always.
     type: dict
     contains:
-        enabled:
-            description: The VSNext state.
+        objects:
+            description: List of configured Virtual Systems.
             returned: always
-            type: bool
-        session-virtual-system-id:
-            description: The Virtual System ID of the current Gaia API session.
+            type: list
+            elements: dict
+            contains:
+                id:
+                    description: Virtual System ID.
+                    returned: always
+                    type: int
+                name:
+                    description: Virtual System name.
+                    returned: always
+                    type: str
+                virtual_system_type:
+                    description: Virtual System type, Gateway or Switch.
+                    returned: always
+                    type: str
+                interfaces:
+                    description: Network interfaces attached to the Virtual System.
+                    returned: always
+                    type: list
+                    elements: str
+        from:
+            description: From which element number the query was done.
             returned: always
             type: int
-        member-id:
-            description: The member on which the command was executed.
-            returned: On Scalable and Elastic XL platforms only.
+        to:
+            description: To which element number the query was done.
+            returned: always
+            type: int
+        total:
+            description: Total number of elements returned by the query.
+            returned: always
             type: int
 """
 

plugins/modules/cp_gaia_vsnext_state_facts.py

@@ -57,11 +57,11 @@
             description: The VSNext state.
             returned: always
             type: bool
-        session-virtual-system-id:
+        session_virtual_system_id:
             description: The Virtual System ID of the current Gaia API session.
             returned: always
             type: int
-        member-id:
+        member_id:
             description: The member on which the command was executed.
             returned: On Scalable and Elastic XL platforms only.
             type: int