IONOS(ci): Implement complete rc/* branch support

Add full CI/CD pipeline support for release candidate (rc/*) branches
across all workflow stages:

Workflow Triggers:
- Add 'rc/**' pattern to push trigger branches
- Update concurrency group to prevent rc/* builds from interfering

Branch Validation:
- Extend configuration check to recognize rc/* as valid trigger branch
- Update validation messages to include rc/* in expected patterns

Artifactory Integration:
- Enable artifact upload for rc/* branches
- Create separate 'rc/' directory for rc/* build artifacts
- Set ARTIFACTORY_STAGE_PREFIX='rc' for proper organization

GitLab Pipeline Integration:
- Set BUILD_TYPE='rc' for rc/* branch builds
- Update trigger conditions to include rc/* branches
- Add rc/* to branch-to-GitLab mapping documentation table

This provides complete parity with ionos-dev and ionos-stable branches,
enabling proper release candidate workflow with isolated artifacts.

Author: printminion-co

.github/workflows/build-artifact.yml

@@ -31,6 +31,7 @@ on:
     branches:
       - ionos-dev
       - ionos-stable
+      - 'rc/**'
   workflow_dispatch:  # Manual trigger to bypass all caches
     inputs:
       force_rebuild:
@@ -50,7 +51,7 @@ on:
         default: ''
 
 concurrency:
-  group: ${{ github.workflow }}-${{ github.ref == 'refs/heads/ionos-dev' && github.run_id || github.event.pull_request.number || github.ref }}
+  group: ${{ github.workflow }}-${{ (github.ref == 'refs/heads/ionos-dev' || startsWith(github.ref, 'refs/heads/rc/')) && github.run_id || github.event.pull_request.number || github.ref }}
   cancel-in-progress: true
 
 env:
@@ -142,11 +143,12 @@ jobs:
               echo "   ✅ Event type is 'push'"
             fi
 
-            # Check if branch matches expected patterns: ionos-dev, ionos-stable
+            # Check if branch matches expected patterns: ionos-dev, ionos-stable, or rc/*
             if [ "${{ github.ref_name }}" != "ionos-dev" ] && \
-               [ "${{ github.ref_name }}" != "ionos-stable" ]; then
-              echo "- ❌ Branch must be 'ionos-dev' or 'ionos-stable' (current: \`${{ github.ref_name }}\`)" >> $GITHUB_STEP_SUMMARY
-              echo "   ❌ Branch is '${{ github.ref_name }}' (must be 'ionos-dev' or 'ionos-stable')"
+               [ "${{ github.ref_name }}" != "ionos-stable" ] && \
+               [[ ! "${{ github.ref_name }}" =~ ^rc/ ]]; then
+              echo "- ❌ Branch must be 'ionos-dev', 'ionos-stable', or 'rc/*' (current: \`${{ github.ref_name }}\`)" >> $GITHUB_STEP_SUMMARY
+              echo "   ❌ Branch is '${{ github.ref_name }}' (must be 'ionos-dev', 'ionos-stable', or 'rc/*')"
               WILL_TRIGGER=false
             else
               echo "- ✅ Branch is '\`${{ github.ref_name }}\`'" >> $GITHUB_STEP_SUMMARY
@@ -678,10 +680,10 @@ jobs:
 
   upload-to-artifactory:
     runs-on: self-hosted
-    # Upload the artifact to the Artifactory repository on PR *OR* on "ionos-dev|ionos-stable" branch push defined in the on:push:branches
+    # Upload the artifact to the Artifactory repository on PR *OR* on "ionos-dev|ionos-stable|rc/*" branch push defined in the on:push:branches
     if: |
       always() &&
-      (github.event_name == 'pull_request' || github.ref_name == 'ionos-dev' || github.ref_name == 'ionos-stable') &&
+      (github.event_name == 'pull_request' || github.ref_name == 'ionos-dev' || github.ref_name == 'ionos-stable' || startsWith(github.ref_name, 'rc/')) &&
       needs.prepare-matrix.result == 'success' &&
       (needs.build-external-apps.result == 'success' || needs.build-external-apps.result == 'skipped') &&
       needs.build-artifact.result == 'success'
@@ -766,12 +768,16 @@ jobs:
           # | Pull Request     | dev            | dev/pr/nextcloud-workspace-pr-<number>.zip         |
           # | ionos-dev        | dev            | dev/nextcloud-workspace-<ncVersion>.zip            |
           # | ionos-stable     | stable         | stable/nextcloud-workspace-<ncVersion>.zip         |
+          # | rc/*             | rc             | rc/nextcloud-workspace-<ncVersion>.zip             |
 
           ARTIFACTORY_STAGE_PREFIX="dev"
 
           # Set stage prefix based on branch
           if [ "${{ github.ref_name }}" == "ionos-stable" ]; then
               ARTIFACTORY_STAGE_PREFIX="stable"
+          # set ARTIFACTORY_STAGE_PREFIX=rc on rc/* branches
+          elif [[ "${{ github.ref_name }}" == "rc/"* ]]; then
+              ARTIFACTORY_STAGE_PREFIX="rc"
           fi
 
           export PATH_TO_DIRECTORY="${{ env.ARTIFACTORY_REPOSITORY_SNAPSHOT }}/${ARTIFACTORY_STAGE_PREFIX}"
@@ -914,13 +920,13 @@ jobs:
 
     name: Trigger remote workflow
     needs: [upload-to-artifactory]
-    # Trigger remote build on "ionos-dev|ionos-stable" branch *push* defined in the on:push:branches
+    # Trigger remote build on "ionos-dev|ionos-stable|rc/*" branch *push* defined in the on:push:branches
     # Can be disabled via repository variable 'DISABLE_REMOTE_TRIGGER' (set to 'true' to disable)
     # Configure at: https://github.com/IONOS-Productivity/ncw-server/settings/variables/actions
     if: |
       always() &&
       github.event_name == 'push' &&
-      (github.ref_name == 'ionos-dev' || github.ref_name == 'ionos-stable') &&
+      (github.ref_name == 'ionos-dev' || github.ref_name == 'ionos-stable' || startsWith(github.ref_name, 'rc/')) &&
       needs.upload-to-artifactory.result == 'success' &&
       vars.DISABLE_REMOTE_TRIGGER != 'true'
     steps:
@@ -934,12 +940,16 @@ jobs:
           # |--------------|--------------|-------------|
           # | ionos-dev    | main         | dev         |
           # | ionos-stable | main         | stable      |
+          # | rc/*         | main         | rc          |
 
           BUILD_TYPE="dev"
 
           # Override build type for stable branch
           if [ "${{ github.ref_name }}" == "ionos-stable" ]; then
               BUILD_TYPE="stable"
+          # Override build type for rc/* branches
+          elif [[ "${{ github.ref_name }}" == "rc/"* ]]; then
+              BUILD_TYPE="rc"
           fi
 
           # Construct source build URL for traceability