feat: add build-site-with-hugo as a shared composite action

2026-08-11 13:08:03 +02:00
parent 28bd005b99
commit 94eab19dd5
3 changed files with 152 additions and 0 deletions
@@ -0,0 +1,53 @@
+name: Build site with Hugo
+description: >-
+  Installs the requested Hugo version and builds the site into public/. Optionally serves the
+  result, which the quality gates need.
+
+inputs:
+  version:
+    description: Hugo version to install, without a leading "v" (e.g. "0.154.5").
+    required: true
+  args:
+    description: Full argument list for `hugo`; setting it drops the default --gc --minify.
+    required: false
+    default: --gc --minify
+  serve-port:
+    description: Port to serve public/ on. Needs http-server in the job image. Empty means do not serve.
+    required: false
+    default: ''
+
+runs:
+  using: composite
+  steps:
+    - uses: peaceiris/actions-hugo@v3
+      with:
+        hugo-version: ${{ inputs.version }}
+        extended: true
+
+    - name: Build
+      shell: bash
+      env:
+        ARGS: ${{ inputs.args }}
+      # ARGS stays unquoted on purpose - it carries a list of arguments, not a single one.
+      run: hugo ${ARGS}
+
+    # Polling beats a fixed sleep: the gates fail with "no FCP" when they start before the
+    # server is up, and that failure reads like a site problem.
+    - name: Serve built site
+      if: inputs.serve-port != ''
+      shell: bash
+      env:
+        SERVE_PORT: ${{ inputs.serve-port }}
+      run: |
+        command -v http-server >/dev/null || { echo "http-server is not installed in the job image." >&2; exit 1; }
+        # Server output goes to a file, not to the step pipe: a background process keeps stdout
+        # open and the runner then waits for EOF long after the audit is done (run 2145).
+        http-server public -p "${SERVE_PORT}" --silent > /tmp/http-server.log 2>&1 &
+        for _ in $(seq 1 60); do
+          if curl -sfo /dev/null "http://localhost:${SERVE_PORT}/"; then
+            exit 0
+          fi
+          sleep 1
+        done
+        echo "http-server did not come up on port ${SERVE_PORT} within 60s." >&2
+        exit 1