feat: allow custom runner configuration in most workflows

Author: galargh

.github/workflows/go-check.yml

@@ -15,13 +15,17 @@ on:
       env:
         required: false
         type: string
+      runner:
+        required: false
+        type: string
+        default: '"ubuntu-latest"'
     secrets:
       CHECKOUT_TOKEN:
         required: false
 
 jobs:
   unit:
-    runs-on: ubuntu-latest
+    runs-on: ${{ fromJSON(vars['UCI_GO_CHECK_RUNNER'] || inputs['runner']) }}
     name: All
     steps:
       - name: Set env

.github/workflows/go-test.yml

@@ -13,6 +13,18 @@ on:
       env:
         required: false
         type: string
+      runner-ubuntu:
+        required: false
+        type: string
+        default: '"ubuntu-latest"'
+      runner-windows:
+        required: false
+        type: string
+        default: '"windows-latest"'
+      runner-macos:
+        required: false
+        type: string
+        default: '"macos-latest"'
     secrets:
       CODECOV_TOKEN:
         required: false
@@ -34,7 +46,7 @@ jobs:
       GOTESTFLAGS: -cover -coverprofile=module-coverage.txt -coverpkg=./...
       GO386FLAGS: ''
       GORACEFLAGS: ''
-    runs-on: ${{ fromJSON(vars[format('UCI_GO_TEST_RUNNER_{0}', matrix.os)] || format('"{0}-latest"', matrix.os)) }}
+    runs-on: ${{ fromJSON(vars[format('UCI_GO_TEST_RUNNER_{0}', matrix.os)] || inputs[format('runner-{0}', matrix.os)]) }}
     name: ${{ matrix.os }} (go ${{ matrix.go }})
     steps:
       - name: Set env

.github/workflows/release-check.yml

@@ -14,14 +14,18 @@ on:
         required: false
         type: string
         default: '/'
+      runner:
+        required: false
+        type: string
+        default: '"ubuntu-latest"'
     outputs:
       json:
         description: JSON aggregation of release.json artifacts
         value: ${{ jobs.aggregate.outputs.json }}
 
 jobs:
   release-check:
-    runs-on: ubuntu-latest
+    runs-on: ${{ fromJSON(vars['UCI_RELEASE_CHECK_RUNNER'] || inputs['runner']) }}
     strategy:
       fail-fast: false
       matrix:
@@ -338,7 +342,7 @@ jobs:
           path: release.json
   aggregate:
     needs: [release-check]
-    runs-on: ubuntu-latest
+    runs-on: ${{ fromJSON(vars['UCI_RELEASE_CHECK_RUNNER'] || inputs['runner']) }}
     outputs:
       json: ${{ toJSON(fromJSON(steps.aggregate.outputs.json)) }}
     steps:

.github/workflows/releaser.yml

@@ -18,6 +18,10 @@ on:
         required: false
         type: boolean
         default: false
+      runner:
+        required: false
+        type: string
+        default: '"ubuntu-latest"'
     outputs:
       json:
         description: JSON aggregation of release.json artifacts
@@ -28,7 +32,7 @@ on:
 
 jobs:
   releaser:
-    runs-on: ubuntu-latest
+    runs-on: ${{ fromJSON(vars['UCI_RELEASER_RUNNER'] || inputs['runner']) }}
     strategy:
       fail-fast: false
       matrix:
@@ -185,7 +189,7 @@ jobs:
           overwrite: true
   aggregate:
     needs: [releaser]
-    runs-on: ubuntu-latest
+    runs-on: ${{ fromJSON(vars['UCI_RELEASER_RUNNER'] || inputs['runner']) }}
     outputs:
       json: ${{ toJSON(fromJSON(steps.aggregate.outputs.json)) }}
     steps:

.github/workflows/reusable-generated-pr.yml

@@ -2,10 +2,15 @@ name: Close Generated PRs
 
 on:
   workflow_call:
+    inputs:
+      runner:
+        required: false
+        type: string
+        default: '"ubuntu-latest"'
 
 jobs:
   stale:
-    runs-on: ubuntu-latest
+    runs-on: ${{ fromJSON(vars['UCI_GENERATED_PR_RUNNER'] || inputs['runner']) }}
     permissions:
       issues: write
       pull-requests: write

.github/workflows/reusable-semantic-pull-request.yml

@@ -2,11 +2,16 @@ name: Semantic PR
 
 on:
   workflow_call:
+    inputs:
+      runner:
+        required: false
+        type: string
+        default: '"ubuntu-latest"'
 
 jobs:
   main:
     name: Validate PR title
-    runs-on: ubuntu-latest
+    runs-on: ${{ fromJSON(vars['UCI_SEMANTIC_PULL_REQUEST_RUNNER'] || inputs['runner']) }}
     steps:
       - uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6.1.1
         env:

.github/workflows/reusable-spellcheck.yml

@@ -2,10 +2,15 @@ name: Check Spelling
 
 on:
   workflow_call:
+    inputs:
+      runner:
+        required: false
+        type: string
+        default: '"ubuntu-latest"'
 
 jobs:
   spellcheck:
-    runs-on: ubuntu-latest
+    runs-on: ${{ fromJSON(vars['UCI_SPELLCHECK_RUNNER'] || inputs['runner']) }}
     steps:
       - uses: actions/checkout@v5
 

.github/workflows/reusable-stale-issue.yml

@@ -2,10 +2,15 @@ name: Close Stale Issues
 
 on:
   workflow_call:
+    inputs:
+      runner:
+        required: false
+        type: string
+        default: '"ubuntu-latest"'
 
 jobs:
   stale:
-    runs-on: ubuntu-latest
+    runs-on: ${{ fromJSON(vars['UCI_STALE_ISSUE_RUNNER'] || inputs['runner']) }}
     permissions:
       issues: write
       pull-requests: write

.github/workflows/tagpush.yml

@@ -2,11 +2,16 @@ name: Manual Release Nag
 
 on:
   workflow_call:
+    inputs:
+      runner:
+        required: false
+        type: string
+        default: '"ubuntu-latest"'
 
 jobs:
   nag:
     if: startsWith(github.ref, 'refs/tags') && github.event.pusher.name != 'web3-bot'
-    runs-on: ubuntu-latest
+    runs-on: ${{ fromJSON(vars['UCI_TAGPUSH_RUNNER'] || inputs['runner']) }}
     name: All
     steps:
       - id: tag

CHANGELOG.md

@@ -8,6 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - `env` input support to `go-test` and `go-check` workflows
 - `CHECKOUT_TOKEN` secret support to `go-test` and `go-check` workflows
+- custom `runner` configuration to most workflows
 
 ## [1.0.34] - 2025-09-16
 ### Fixed