ci(deploy): integrate domain warmup into deployment workflow

Add warmup step to GitHub Pages deployment workflow that runs after publication. Includes Node.js setup, warmup execution with summary output, and enhanced deployment status reporting that captures both publish and warmup outcomes.

Co-Authored-By: Hagicode <noreply@hagicode.com>
Signed-off-by: newbe36524 <newbe36524@qq.com>

Author: newbe36524

.github/workflows/docs-deploy-gh-pages.yml

@@ -71,13 +71,19 @@ jobs:
         with:
           fetch-depth: 0
 
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+
       - name: Download validated gh-pages payload
         uses: actions/download-artifact@v4
         with:
           name: docs-gh-pages-payload
           path: .deploy/gh-pages
 
       - name: Publish validated gh-pages payload
+        id: publish-gh-pages
         uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
@@ -86,12 +92,37 @@ jobs:
           force_orphan: true
           enable_jekyll: false
 
+      - name: Warm deployment domains
+        id: warmup
+        run: node ./scripts/warm-deployment-domains.mjs --summary-markdown ./.deploy/docs-warmup-summary.md
+
       - name: Summarize deployment output
+        if: always()
+        env:
+          PUBLISH_OUTCOME: ${{ steps.publish-gh-pages.outcome }}
+          WARMUP_OUTCOME: ${{ steps.warmup.outcome }}
+          WARMUP_SUMMARY_MARKDOWN: ./.deploy/docs-warmup-summary.md
         run: |
           echo "## Publication status" >> "$GITHUB_STEP_SUMMARY"
           echo "- Publication source: validated build artifact" >> "$GITHUB_STEP_SUMMARY"
-          echo "- \`gh-pages\` publication: succeeded" >> "$GITHUB_STEP_SUMMARY"
+          echo "- \`gh-pages\` publication: ${PUBLISH_OUTCOME}" >> "$GITHUB_STEP_SUMMARY"
           echo "- Published payload: branch-root \`esa.jsonc\`, \`wrangler.jsonc\`, plus \`dist/\`" >> "$GITHUB_STEP_SUMMARY"
           echo "- GitHub environment: docs-production" >> "$GITHUB_STEP_SUMMARY"
           echo "- Expected public URL: https://docs.hagicode.com" >> "$GITHUB_STEP_SUMMARY"
-          echo "Published the validated gh-pages payload with ./esa.jsonc, ./wrangler.jsonc, and ./dist/."
+          echo "- Post-publication warmup: ${WARMUP_OUTCOME}" >> "$GITHUB_STEP_SUMMARY"
+          if [ -f "$WARMUP_SUMMARY_MARKDOWN" ]; then
+            echo "" >> "$GITHUB_STEP_SUMMARY"
+            cat "$WARMUP_SUMMARY_MARKDOWN" >> "$GITHUB_STEP_SUMMARY"
+          elif [ "$PUBLISH_OUTCOME" = "success" ]; then
+            echo "" >> "$GITHUB_STEP_SUMMARY"
+            echo "## Deployment domain warmup" >> "$GITHUB_STEP_SUMMARY"
+            echo "- Warmup summary file was not created." >> "$GITHUB_STEP_SUMMARY"
+          fi
+          if [ "$PUBLISH_OUTCOME" = "success" ] && [ "$WARMUP_OUTCOME" = "failure" ]; then
+            echo "- Publication note: gh-pages snapshot was already published before warmup verification failed." >> "$GITHUB_STEP_SUMMARY"
+          fi
+          if [ "$PUBLISH_OUTCOME" = "success" ]; then
+            echo "Published the validated gh-pages payload with ./esa.jsonc, ./wrangler.jsonc, and ./dist/."
+          else
+            echo "Validated gh-pages publication did not complete successfully."
+          fi

package.json

@@ -49,6 +49,7 @@
     "test:desktop-version-guidance": "node --test ./tests/desktop-version-guidance.test.mjs",
     "test:docs-translation-report": "node --test ./tests/docs-translation-report.test.mjs",
     "test:indexnow": "node --test ./tests/submit-indexnow.test.mjs",
+    "test:warm-deployment-domains": "node --test ./tests/warm-deployment-domains.test.mjs",
     "verify:blog-sidebar-i18n": "node ./scripts/verify-blog-sidebar-i18n.mjs",
     "verify:blog-i18n-completeness": "node ./scripts/verify-blog-i18n-completeness.mjs",
     "report:translation": "node ./scripts/report-translation-status.mjs",