GitHub-Actions

Shared GitHub Actions workflows for SiteNetSoft projects.

Reusable workflows

deploy-pages.yml

Publishes a prepared GitHub Pages artifact. Language-agnostic: the caller builds its site however it likes and uploads it with actions/upload-pages-artifact, and this workflow owns only the deployment — so environment wiring, permissions and action versions are maintained in one place.

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: pages
  cancel-in-progress: false

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - run: make site
      - uses: actions/configure-pages@v6
      - uses: actions/upload-pages-artifact@v5
        with:
          path: build/site

  deploy:
    needs: build
    uses: SiteNetSoft/GitHub-Actions/.github/workflows/deploy-pages.yml@master

Input	Default	Purpose
artifact-name	github-pages	Name of the uploaded Pages artifact
environment-name	github-pages	Deployment environment to publish into
runs-on	ubuntu-latest	Runner label
timeout-minutes	10	Deployment timeout

Output: page-url — the URL of the deployed site.

The caller must grant pages: write and id-token: write at workflow level; a called workflow cannot widen the permissions it is given. Pages must also be enabled once per repository under Settings → Pages → Source = GitHub Actions, which the workflow token cannot do itself.

Used by htmx-ext-tus.