feat(rspress): add Rspress documentation site with PR preview CI

.github/workflows/documentation.yml

@@ -16,6 +16,10 @@ jobs:
     uses: centreon/security-tools/.github/workflows/dependency-analysis.yml@main
 
   get-versions:
+    # Skip the Docusaurus build/preview for the rspress migration PR (the rspress
+    # site has its own preview workflow). Remove this guard once the migration
+    # branch is merged. Other branches and the staging push are unaffected.
+    if: github.head_ref != 'test-rspress'
     needs: [dependency-scan]
     runs-on: ubuntu-24.04
 

.github/workflows/rspress-pr-preview.yml

@@ -0,0 +1,121 @@
+name: rspress-pr-preview
+
+# Deploy a Cloudflare Pages preview of the rspress documentation for each pull
+# request that touches it, and post the preview URL as a sticky PR comment.
+#
+# Why Cloudflare Pages: preview deployments are unlimited and independent (one
+# stable URL per PR), bandwidth is unlimited, and deploying prebuilt assets with
+# wrangler does not consume the Cloudflare build quota — so it scales to many
+# concurrent PRs at no cost.
+#
+# Prerequisites (one-time, by a maintainer):
+#   - A free Cloudflare account with a Pages project named "centreon-docs-preview".
+#   - Repository secrets: CLOUDFLARE_API_TOKEN (Pages:Edit) and CLOUDFLARE_ACCOUNT_ID.
+# Note: secrets are not exposed to pull requests opened from forks, so previews
+# only run for branches pushed to this repository (see the fork guard below).
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+    paths:
+      - 'rspress/**'
+      - '.github/workflows/rspress-pr-preview.yml'
+
+permissions:
+  contents: read
+  pull-requests: write
+
+concurrency:
+  group: rspress-preview-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+env:
+  PAGES_PROJECT: centreon-docs-preview
+
+jobs:
+  preview:
+    name: Build and deploy preview
+    runs-on: ubuntu-24.04
+    # Secrets are unavailable to fork PRs; skip rather than fail.
+    if: github.event.pull_request.head.repo.full_name == github.repository
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v5.0.0
+
+      - uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4.2.0
+        with:
+          version: 10
+          run_install: false
+
+      - name: Set up Node
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
+        with:
+          node-version: 22
+          cache: pnpm
+          cache-dependency-path: pnpm-lock.yaml
+
+      - name: Install dependencies
+        run: |
+          pnpm install \
+            --frozen-lockfile \
+            --config.trustPolicy=no-downgrade \
+            --config.minimumReleaseAge=2880 \
+            --config.blockExoticSubdeps=true
+        shell: bash
+
+      - name: Restore rspack build cache
+        # Reuse rspack's persistent build cache between runs to speed up rebuilds
+        # (rspack invalidates only the modules that changed).
+        uses: actions/cache@cdf6c1fa76f9f475f3d7449005a359c84ca0f306 # v4.1.2
+        with:
+          path: rspress/node_modules/.cache
+          key: rspack-${{ runner.os }}-${{ hashFiles('pnpm-lock.yaml') }}-${{ github.run_id }}
+          restore-keys: |
+            rspack-${{ runner.os }}-${{ hashFiles('pnpm-lock.yaml') }}-
+            rspack-${{ runner.os }}-
+
+      - name: Build rspress site
+        # Drop code blocks from the search index so each per-language index stays
+        # under Cloudflare Pages' 25 MiB per-file limit (preview only).
+        env:
+          PREVIEW_BUILD: 'true'
+        run: pnpm --filter centreon-documentation-rspress build
+        shell: bash
+
+      - name: Reduce preview search index to headings
+        # Preview-only: rebuild the search index from page headings (title +
+        # H2/H3) so it stays well under Cloudflare Pages' 25 MiB per-file limit.
+        # Staging/production keep the full-text index.
+        working-directory: rspress
+        run: node scripts/trim-preview-search-index.mjs
+        shell: bash
+
+      - name: Deploy to Cloudflare Pages
+        id: deploy
+        working-directory: rspress
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          BRANCH_ALIAS: pr-${{ github.event.pull_request.number }}
+        run: |
+          # Create the project on first run (no-op if it already exists).
+          pnpm exec wrangler pages project create "$PAGES_PROJECT" \
+            --production-branch staging 2>/dev/null || true
+
+          pnpm exec wrangler pages deploy doc_build \
+            --project-name "$PAGES_PROJECT" \
+            --branch "$BRANCH_ALIAS" \
+            --commit-dirty=true
+
+          echo "url=https://${BRANCH_ALIAS}.${PAGES_PROJECT}.pages.dev" >> "$GITHUB_OUTPUT"
+        shell: bash
+
+      - name: Comment preview URL
+        uses: marocchino/sticky-pull-request-comment@773744901bac0e8cbb5a0dc842800d45e9b2b405 # v2.9.4
+        with:
+          header: rspress-preview
+          message: |
+            📘 **rspress documentation preview**
+
+            ${{ steps.deploy.outputs.url }}
+
+            Updated on every push to this pull request.

.gitignore

@@ -4,9 +4,11 @@
 # Production
 /build
 
-# Generated files 
+# Generated files
 .cache-loader
 .docusaurus/
+rspress/doc_build
+rspress/node_modules
 harmonize_tabs.php
 migrate_tabs.php
 clean_file.php