ci: add trigger to run compatibility tests

see https://gravitee.atlassian.net/browse/GKO-1348

Author: a-cordier

.circleci/config.yml

@@ -24,6 +24,10 @@ parameters:
       - rollout-apim
       - release
       - none
+  apim-version:
+    type: string
+    default: ""
+    description: "The version of APIM to use when we run a test suite. Leave empty to use the version defined in the hack/apim.yaml file."
   apim-source-branch:
     type: string
     default: ""
@@ -310,7 +314,8 @@ jobs:
                 command: echo 'export APIM_VALUES=values-dbless.yaml' >> $BASH_ENV
       - run:
           name: Start cluster
-          command: make start-cluster
+          command: |
+            APIM_IMAGE_TAG=<< pipeline.parameters.apim-version >> make start-cluster 
       - run:
           name: Run IT with filter << parameters.ginkgo-filter >>
           command: |
@@ -1033,7 +1038,7 @@ workflows:
         - << pipeline.parameters.trigger >>
     jobs:
       - job-integration-test:
-          name: Run all integration tests
+          name: Run integration tests with APIM version << pipeline.parameters.apim-version >>
           context: cicd-orchestrator
           ginkgo-filter: integration
           pre-steps:

.github/workflows/trigger-compat-test.yaml

@@ -0,0 +1,52 @@
+# Copyright (C) 2015 The Gravitee team (http://gravitee.io)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Trigger Compatibility Test
+on:
+  workflow_dispatch: {}
+  push:
+    branches:
+      - gko-1348-apim-compatibility
+jobs:
+  trigger-test-suite:
+    runs-on: ubuntu-latest
+    env:
+      BRANCH: ${{ matrix.branch }}
+      APIM_VERSION: ${{ matrix.apim-version }}
+      CIRCLECI_TOKEN: ${{ secrets.CIRCLECI_TOKEN }}
+    strategy:
+      fail-fast: false
+      matrix:
+        branch:
+          - 4.5.x
+          - 4.6.x
+          - 4.7.x
+          - 4.8.x
+          - 4.9.x
+        apim-version:
+          - 4.5.x-latest
+          - 4.6.x-latest
+          - 4.7.x-latest
+          - 4.8.x-latest
+          - 4.9.x-latest
+          - master-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+      - name: Trigger test pipeline and notify on failure
+        run: |
+          echo "🧪 Triggering test pipeline"
+          npx zx hack/scripts/trigger-test.mjs --notify true --branch ${BRANCH} --apimVersion ${APIM_VERSION}

hack/scripts/trigger-test.mjs

@@ -18,16 +18,40 @@ import { triggerPipeline } from "./lib/circleci.mjs";
 
 import { toggleVerbosity, LOG } from "./lib/index.mjs";
 
+import { Version } from "./lib/version.mjs";
+
 const VERBOSE = argv.verbose;
 const BRANCH = argv["branch"];
 const NOTIFY = argv["notify"] === "true" || argv["notify"] === true;
+const APIM_VERSION = argv["apimVersion"];
+
+const apimVersion = new Version(APIM_VERSION);
+const gkoVersion = new Version(BRANCH);
+
+if (apimVersion !== "master-latest") {
+  if (apimVersion.majorDigit < gkoVersion.majorDigit) {
+    LOG.blue(
+      `Skipping test because we don't support forward compatibility between major versions`,
+    );
+    process.exit(0);
+  }
+  
+  if (apimVersion.minorDigit < gkoVersion.minorDigit) {
+    LOG.blue(
+      `Skipping test because we don't support forward compatibility between minor versions`,
+    );
+    process.exit(0);
+  }
+}
+
 
 toggleVerbosity(VERBOSE);
 
 LOG.blue(`Triggering test pipeline`);
 
 const parameters = {
   trigger: "test",
+  "apim-version": APIM_VERSION,
   notify: NOTIFY,
 };