[#1428] Updated deployment bypass mechanism to use list-based variables.

- Replaced individual `VORTEX_DEPLOY_SKIP_PR_<NUMBER>` and `VORTEX_DEPLOY_SKIP_BRANCH_<SAFE_BRANCH>` variables with comma-separated list variables
- Added `VORTEX_DEPLOY_SKIP_PRS` for PR numbers (single or comma-separated)
- Added `VORTEX_DEPLOY_SKIP_BRANCHES` for branch names (single or comma-separated)
- Updated `scripts/vortex/deploy.sh` with new list-based skip logic
- Updated PHPUnit tests to cover new skip scenarios
- Updated documentation for deployment workflows and variables
- Updated GitHub Actions workflow to include new environment variables
- Updated CI variables configuration
- Updated installer baseline fixtures

  This is a breaking change. Projects using the old mechanism will need to migrate from:
  VORTEX_DEPLOY_SKIP_PR_123: "1"
  VORTEX_DEPLOY_SKIP_BRANCH_FEATURE_TEST: "1"

  To:
  VORTEX_DEPLOY_ALLOW_SKIP: "1"
  VORTEX_DEPLOY_SKIP_PRS: "123"
  VORTEX_DEPLOY_SKIP_BRANCHES: "feature/test"

Author: AlexSkrypnyk

.github/workflows/build-test-deploy.yml

@@ -475,5 +475,8 @@ jobs:
           VORTEX_DEPLOY_ARTIFACT_GIT_USER_NAME: ${{ vars.VORTEX_DEPLOY_ARTIFACT_GIT_USER_NAME }}
           VORTEX_DEPLOY_WEBHOOK_URL: ${{ vars.VORTEX_DEPLOY_WEBHOOK_URL }}
           VORTEX_DEPLOY_SKIP: ${{ vars.VORTEX_DEPLOY_SKIP }}
+          VORTEX_DEPLOY_ALLOW_SKIP: ${{ vars.VORTEX_DEPLOY_ALLOW_SKIP }}
+          VORTEX_DEPLOY_SKIP_PRS: ${{ vars.VORTEX_DEPLOY_SKIP_PRS }}
+          VORTEX_DEPLOY_SKIP_BRANCHES: ${{ vars.VORTEX_DEPLOY_SKIP_BRANCHES }}
         timeout-minutes: 30
   #;> DEPLOYMENT

.vortex/docs/.utils/variables/extra/ci.variables.sh

@@ -6,6 +6,15 @@
 # Skip all deployments.
 VORTEX_DEPLOY_SKIP=
 
+# Flag to allow skipping of a deployment using additional flags.
+VORTEX_DEPLOY_ALLOW_SKIP=
+
+# Pull request numbers to skip deployment for (single value or comma-separated list).
+VORTEX_DEPLOY_SKIP_PRS=
+
+# Branch names to skip deployment for (single value or comma-separated list).
+VORTEX_DEPLOY_SKIP_BRANCHES=
+
 # Proceed with container image deployment after it was exported.
 VORTEX_EXPORT_DB_CONTAINER_REGISTRY_DEPLOY_PROCEED=
 

.vortex/docs/content/workflows/deployment.mdx

@@ -75,31 +75,45 @@ variable to `1`.
 This is especially useful in continuous integration pipelines where you may want to build and test
 without triggering a deployment.
 
-### Skipping deployments for a specific Pull Requests or branches
+### Skipping deployments for specific Pull Requests or branches
 
-To skip a specific Pull Request or branch using the `$VORTEX_DEPLOY_SKIP`
-variable, you would define additional environment variables with a specific
-naming convention in your continuous integration pipeline configuration.
+To skip specific Pull Requests or branches, set `$VORTEX_DEPLOY_ALLOW_SKIP` to `1`
+and provide lists in the following variables:
 
-Here's an example of how this can be done:
+#### Skipping specific Pull Requests
 
-#### Skipping a specific Pull Request
+Set `$VORTEX_DEPLOY_SKIP_PRS` to a single PR number or comma-separated list:
 
-   Suppose you want to skip the deployment for Pull Request number 42. You would
-   set the following environment variable:
+```bash
+# Skip a single PR
+VORTEX_DEPLOY_ALLOW_SKIP=1
+VORTEX_DEPLOY_SKIP_PRS=42
 
-   ```bash
-   VORTEX_DEPLOY_SKIP_PR_42=1
-   ```
+# Skip multiple PRs
+VORTEX_DEPLOY_ALLOW_SKIP=1
+VORTEX_DEPLOY_SKIP_PRS=42,123,456
+```
 
-#### Skipping a specific branch
+#### Skipping specific branches
 
-   Suppose you want to skip the deployment for a branch named `feature-x`. You
-   would first create a "safe" version of the branch name by replacing any
-   special characters with underscores.
+Set `$VORTEX_DEPLOY_SKIP_BRANCHES` to a single branch name or comma-separated list:
 
-   Set the following environment variable:
+```bash
+# Skip a single branch
+VORTEX_DEPLOY_ALLOW_SKIP=1
+VORTEX_DEPLOY_SKIP_BRANCHES=feature/test
 
-   ```bash
-   VORTEX_DEPLOY_SKIP_BRANCH_FEATURE_X=1
-   ```
+# Skip multiple branches
+VORTEX_DEPLOY_ALLOW_SKIP=1
+VORTEX_DEPLOY_SKIP_BRANCHES=feature/test,hotfix/urgent,project/experimental
+```
+
+#### Combined usage
+
+You can use both variables together:
+
+```bash
+VORTEX_DEPLOY_ALLOW_SKIP=1
+VORTEX_DEPLOY_SKIP_PRS=42,123
+VORTEX_DEPLOY_SKIP_BRANCHES=feature/test,hotfix/urgent
+```

.vortex/docs/content/workflows/variables.mdx

@@ -852,7 +852,7 @@ Flag to allow skipping of a deployment using additional flags.
 
 Default value: `UNDEFINED`
 
-Defined or used in: `scripts/vortex/deploy.sh`
+Defined or used in: `CI config`, `scripts/vortex/deploy.sh`
 
 ### `VORTEX_DEPLOY_ARTIFACT_DST_BRANCH`
 
@@ -1042,6 +1042,22 @@ Default value: `UNDEFINED`
 
 Defined or used in: `CI config`
 
+### `VORTEX_DEPLOY_SKIP_BRANCHES`
+
+Branch names to skip deployment for (single value or comma-separated list).
+
+Default value: `UNDEFINED`
+
+Defined or used in: `CI config`, `scripts/vortex/deploy.sh`
+
+### `VORTEX_DEPLOY_SKIP_PRS`
+
+Pull request numbers to skip deployment for (single value or comma-separated list).
+
+Default value: `UNDEFINED`
+
+Defined or used in: `CI config`, `scripts/vortex/deploy.sh`
+
 ### `VORTEX_DEPLOY_SSH_FILE`
 
 Default SSH file used if custom fingerprint is not provided.

.vortex/installer/tests/Fixtures/install/_baseline/.github/workflows/build-test-deploy.yml

@@ -438,4 +438,7 @@ jobs:
           VORTEX_DEPLOY_ARTIFACT_GIT_USER_NAME: ${{ vars.VORTEX_DEPLOY_ARTIFACT_GIT_USER_NAME }}
           VORTEX_DEPLOY_WEBHOOK_URL: ${{ vars.VORTEX_DEPLOY_WEBHOOK_URL }}
           VORTEX_DEPLOY_SKIP: ${{ vars.VORTEX_DEPLOY_SKIP }}
+          VORTEX_DEPLOY_ALLOW_SKIP: ${{ vars.VORTEX_DEPLOY_ALLOW_SKIP }}
+          VORTEX_DEPLOY_SKIP_PRS: ${{ vars.VORTEX_DEPLOY_SKIP_PRS }}
+          VORTEX_DEPLOY_SKIP_BRANCHES: ${{ vars.VORTEX_DEPLOY_SKIP_BRANCHES }}
         timeout-minutes: 30

.vortex/installer/tests/Fixtures/install/deploy_types_none_gha/.github/workflows/build-test-deploy.yml

@@ -1,4 +1,4 @@
-@@ -369,73 +369,3 @@
+@@ -369,76 +369,3 @@
          timeout-minutes: 120 # Cancel the action after 15 minutes, regardless of whether a connection has been established.
          with:
            detached: true
@@ -71,4 +71,7 @@
 -          VORTEX_DEPLOY_ARTIFACT_GIT_USER_NAME: ${{ vars.VORTEX_DEPLOY_ARTIFACT_GIT_USER_NAME }}
 -          VORTEX_DEPLOY_WEBHOOK_URL: ${{ vars.VORTEX_DEPLOY_WEBHOOK_URL }}
 -          VORTEX_DEPLOY_SKIP: ${{ vars.VORTEX_DEPLOY_SKIP }}
+-          VORTEX_DEPLOY_ALLOW_SKIP: ${{ vars.VORTEX_DEPLOY_ALLOW_SKIP }}
+-          VORTEX_DEPLOY_SKIP_PRS: ${{ vars.VORTEX_DEPLOY_SKIP_PRS }}
+-          VORTEX_DEPLOY_SKIP_BRANCHES: ${{ vars.VORTEX_DEPLOY_SKIP_BRANCHES }}
 -        timeout-minutes: 30