[CI] Add workflow for ad-hoc docs publishing

Signed-off-by: onobc <[email protected]>

Author: onobc

.github/workflows/deploy-docs-adhoc.yml

@@ -0,0 +1,75 @@
+name: Deploy Docs Ad Hoc
+
+on:
+  push:
+  workflow_dispatch:
+    inputs:
+      branch-or-tag:
+        description: 'Branch or tag name to deploy docs for (e.g. v2.0.0)'
+        required: true
+        type: string
+env:
+  GCHAT_WEBHOOK_URL: ${{ secrets.SPRING_RELEASE_GCHAT_WEBHOOK_URL }}
+  DEVELOCITY_ACCESS_KEY: ${{ secrets.GRADLE_ENTERPRISE_SECRET_ACCESS_KEY }}
+  COMMIT_OWNER: ${{ github.event.pusher.name }}
+  COMMIT_SHA: ${{ github.sha }}
+  ARTIFACTORY_USERNAME: ${{ secrets.ARTIFACTORY_USERNAME }}
+  ARTIFACTORY_PASSWORD: ${{ secrets.ARTIFACTORY_PASSWORD }}
+  GH_TOKEN: ${{ secrets.GH_ACTIONS_REPO_TOKEN }}
+
+jobs:
+  deploy_docs_artifactory:
+    name: Deploy Docs To Artifactory
+    runs-on: ubuntu-latest
+    if: github.repository == 'spring-projects/spring-pulsar'
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          ref: ${{ inputs.branch-or-tag }}
+      - uses: spring-io/spring-gradle-build-action@v2
+        with:
+          java-version: '25'
+          distribution: 'liberica'
+      - name: Publish docs module to Artifactory
+        env:
+          ORG_GRADLE_PROJECT_signingKey: ${{ secrets.GPG_PRIVATE_KEY }}
+          ORG_GRADLE_PROJECT_signingPassword: ${{ secrets.GPG_PASSPHRASE }}
+          ARTIFACTORY_BUILD_NAME: ${{ github.event.repository.name }}-${{ steps.branch-name.outputs.branch }}
+          ARTIFACTORY_BUILD_NUMBER: ${{ github.run_id }}
+          ARTIFACTORY_BUILD_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+          ARTIFACTORY_USER_AGENT_NAME: GitHub Actions
+          ARTIFACTORY_USER_AGENT_VERSION: Unknown
+          ARTIFACTORY_VCS_REVISION: ${{ github.sha }}
+        run: |
+          ./gradlew :spring-pulsar-docs:artifactoryPublish \
+              --stacktrace \
+              -PartifactoryUsername="$ARTIFACTORY_USERNAME" -PartifactoryPassword="$ARTIFACTORY_PASSWORD"
+  deploy_docs_antora:
+    name: Deploy Antora Docs
+    runs-on: ubuntu-latest
+    if: github.repository == 'spring-projects/spring-pulsar'
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          ref: ${{ inputs.branch-or-tag }}
+      - uses: spring-io/spring-gradle-build-action@v2
+        with:
+          java-version: '25'
+          distribution: 'liberica'
+      - name: Run Antora
+        run: |
+          ./gradlew antora
+      - name: Publish Docs
+        uses: spring-io/spring-doc-actions/[email protected]
+        with:
+          docs-username: ${{ secrets.DOCS_USERNAME }}
+          docs-host: ${{ secrets.DOCS_HOST }}
+          docs-ssh-key: ${{ secrets.DOCS_SSH_KEY }}
+          docs-ssh-host-key: ${{ secrets.DOCS_SSH_HOST_KEY }}
+          site-path: spring-pulsar-docs/build/site
+      - name: Bust Clouflare Cache
+        uses: spring-io/spring-doc-actions/[email protected]
+        with:
+          context-root: spring-pulsar
+          cloudflare-zone-id: ${{ secrets.CLOUDFLARE_ZONE_ID }}
+          cloudflare-cache-token: ${{ secrets.CLOUDFLARE_CACHE_TOKEN }}