@futurelastic/colab-handbook 1.20.4-rc.7 → 1.20.4-rc.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/templates/README.md +2 -2
- package/templates/ci-laravel-heavy.yml +4 -4
- package/templates/ci-laravel.yml +5 -5
- package/templates/ci-node-heavy.yml +4 -4
- package/templates/ci-node.yml +5 -5
- package/templates/ci-python-heavy.yml +4 -4
- package/templates/ci-python.yml +5 -5
- package/templates/instruction-files.yml +3 -2
- package/templates/release-auto.yml +6 -4
- package/templates/release-tag.yml +1 -1
- package/tools/lib/adopt.js +1 -1
- package/tools/lib/release-runner.js +1 -1
package/package.json
CHANGED
package/templates/README.md
CHANGED
|
@@ -428,8 +428,8 @@ Decided 2026-07-19, after a GitHub Actions billing lock stopped every
|
|
|
428
428
|
| Repo class | `runs-on` | Why |
|
|
429
429
|
|---|---|---|
|
|
430
430
|
| **Public** repo | `ubuntu-latest` | Free minutes, unaffected by billing — and **never** self-hosted: a fork PR would execute arbitrary code on your runner. |
|
|
431
|
-
| **Private** CI |
|
|
432
|
-
| **Private** deploy | its own runner label | Deploys must never queue behind CI jobs. |
|
|
431
|
+
| **Private** CI | `[self-hosted, <class>]` — a job class, never a host ([CONVENTIONS.md §7, *Runner classes*](../CONVENTIONS.md#runner-classes--runs-on-names-a-job-class-never-a-host-720)) — **where the org's pool carries that class online**; `ubuntu-latest` otherwise | Immune to billing, persistent tool caches, local network. Runners are registered per-org — one org's runner serves nothing in another org. Register a runner for an org when its billing or scale makes it worth it, not preemptively. Each template's `runs-on` `EDIT:` names the class its job takes. |
|
|
432
|
+
| **Private** deploy | its own restricted runner label, outside the classes | Deploys must never queue behind CI jobs. |
|
|
433
433
|
|
|
434
434
|
Self-hosted job hygiene: no `sudo`, install tools into `$RUNNER_TEMP`, never
|
|
435
435
|
write outside the workspace, prefer the runner's native toolchains. A shared
|
|
@@ -64,7 +64,7 @@ jobs:
|
|
|
64
64
|
# that concludes `success` when the nightly skips: a run whose jobs all skip reads as not-green.
|
|
65
65
|
plan:
|
|
66
66
|
name: What to test
|
|
67
|
-
runs-on: ubuntu-latest # EDIT:
|
|
67
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes"); it needs `gh`.
|
|
68
68
|
timeout-minutes: 5
|
|
69
69
|
permissions:
|
|
70
70
|
actions: read
|
|
@@ -129,7 +129,7 @@ jobs:
|
|
|
129
129
|
name: Full suite @ ${{ needs.plan.outputs.sha }}
|
|
130
130
|
needs: plan
|
|
131
131
|
if: ${{ needs.plan.outputs.run == 'true' }}
|
|
132
|
-
runs-on: ubuntu-latest # EDIT: self-hosted
|
|
132
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: e2e (service containers), browser (browser-driven), else trunk (CONVENTIONS.md §7, "Runner classes").
|
|
133
133
|
timeout-minutes: 120 # EDIT: well above YOUR heavy p99; the default is 360.
|
|
134
134
|
permissions:
|
|
135
135
|
contents: read
|
|
@@ -357,7 +357,7 @@ jobs:
|
|
|
357
357
|
name: Secret scan, full history (gitleaks)
|
|
358
358
|
needs: plan
|
|
359
359
|
if: ${{ needs.plan.outputs.run == 'true' }}
|
|
360
|
-
runs-on: ubuntu-latest # EDIT: the
|
|
360
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes").
|
|
361
361
|
timeout-minutes: 30 # the whole history, not a range. EDIT: the default is 360.
|
|
362
362
|
permissions:
|
|
363
363
|
contents: read
|
|
@@ -482,7 +482,7 @@ jobs:
|
|
|
482
482
|
name: Report a red nightly
|
|
483
483
|
needs: [plan, heavy, secrets]
|
|
484
484
|
if: ${{ always() && github.event_name == 'schedule' && (needs.heavy.result == 'failure' || needs.secrets.result == 'failure') }}
|
|
485
|
-
runs-on: ubuntu-latest # EDIT: needs `gh`.
|
|
485
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class; it needs `gh`.
|
|
486
486
|
timeout-minutes: 5
|
|
487
487
|
permissions:
|
|
488
488
|
issues: write
|
package/templates/ci-laravel.yml
CHANGED
|
@@ -57,7 +57,7 @@ on:
|
|
|
57
57
|
# EDIT: on ONE self-hosted agent shared with trunk, go back to trunk-only until
|
|
58
58
|
# trunk has its own lane — branch runs queue ahead of the one trunk run a merge
|
|
59
59
|
# waits for (CONVENTIONS.md §7, "Self-hosted runners", #355). GitHub-hosted
|
|
60
|
-
# runners, a runner pool, or
|
|
60
|
+
# runners, a runner pool, or the `trunk` class picked in `runs-on` on
|
|
61
61
|
# github.ref all have that capacity; keep '**' there. Trunk-only means the
|
|
62
62
|
# branches this repo actually has — and never drop `dev` on a Tier A or C repo:
|
|
63
63
|
# dev is the trunk, so a main-only trigger runs zero checks on the branch you
|
|
@@ -141,7 +141,7 @@ jobs:
|
|
|
141
141
|
name: Already tested at this sha or tree?
|
|
142
142
|
# EDIT: the trunk refs here mirror `concurrency`'s list above (#493).
|
|
143
143
|
if: github.event_name == 'push' && (github.event.created || github.ref == 'refs/heads/main' || github.ref == 'refs/heads/dev')
|
|
144
|
-
runs-on: ubuntu-latest # EDIT: the
|
|
144
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the class of the jobs below, never a host (CONVENTIONS.md §7, "Runner classes"); it needs `gh`.
|
|
145
145
|
timeout-minutes: 5 # one `gh api` listing, a hung call must not hold the slot. EDIT: the default is 360.
|
|
146
146
|
permissions:
|
|
147
147
|
actions: read
|
|
@@ -266,7 +266,7 @@ jobs:
|
|
|
266
266
|
name: Secret scan (gitleaks)
|
|
267
267
|
needs: dedupe
|
|
268
268
|
if: ${{ !cancelled() && needs.dedupe.outputs.tested != 'true' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository) }}
|
|
269
|
-
runs-on: ubuntu-latest # EDIT: self-hosted
|
|
269
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: quick on a branch, trunk on trunk (CONVENTIONS.md §7, "Runner classes").
|
|
270
270
|
timeout-minutes: 15 # a scan of the checkout. EDIT: the default is 360.
|
|
271
271
|
steps:
|
|
272
272
|
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
|
|
@@ -419,7 +419,7 @@ jobs:
|
|
|
419
419
|
name: Build (Laravel + Vite)
|
|
420
420
|
needs: dedupe
|
|
421
421
|
if: ${{ !cancelled() && needs.dedupe.outputs.tested != 'true' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository) }}
|
|
422
|
-
runs-on: ubuntu-latest # EDIT: self-hosted
|
|
422
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: full (quick if it keeps quick's promise) on a branch, trunk on trunk (CONVENTIONS.md §7, "Runner classes").
|
|
423
423
|
timeout-minutes: 45 # a hung build must not hold the runner for the 360-minute default (#572).
|
|
424
424
|
# EDIT: measured (#572): the slowest Laravel adopter's build ran p99 20 / max 26 min. Keep this
|
|
425
425
|
# well above YOUR p99 — below it a slow but healthy suite goes red (`gh run view <id>` per job).
|
|
@@ -807,7 +807,7 @@ jobs:
|
|
|
807
807
|
# including `dedupe`, which is skipped on every ordinary push — so the implicit
|
|
808
808
|
# form would skip this job on exactly the runs it exists for (#418).
|
|
809
809
|
if: ${{ !cancelled() && needs.build.result == 'success' }}
|
|
810
|
-
runs-on: ubuntu-latest # EDIT: self-hosted
|
|
810
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: e2e (service containers) (CONVENTIONS.md §7, "Runner classes").
|
|
811
811
|
timeout-minutes: 15 # a hung round-trip must not hold the runner for the 360-minute default (#572).
|
|
812
812
|
# EDIT: measured (#572): p99 under 4 min / max 5 min on every adopter. Keep it well above your own p99.
|
|
813
813
|
strategy:
|
|
@@ -61,7 +61,7 @@ jobs:
|
|
|
61
61
|
# that concludes `success` when the nightly skips: a run whose jobs all skip reads as not-green.
|
|
62
62
|
plan:
|
|
63
63
|
name: What to test
|
|
64
|
-
runs-on: ubuntu-latest # EDIT:
|
|
64
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes"); it needs `gh`.
|
|
65
65
|
timeout-minutes: 5
|
|
66
66
|
permissions:
|
|
67
67
|
actions: read
|
|
@@ -126,7 +126,7 @@ jobs:
|
|
|
126
126
|
name: Full suite @ ${{ needs.plan.outputs.sha }}
|
|
127
127
|
needs: plan
|
|
128
128
|
if: ${{ needs.plan.outputs.run == 'true' }}
|
|
129
|
-
runs-on: ubuntu-latest # EDIT: self-hosted
|
|
129
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: e2e (service containers), browser (browser-driven), else trunk (CONVENTIONS.md §7, "Runner classes").
|
|
130
130
|
timeout-minutes: 120 # EDIT: well above YOUR heavy p99; the default is 360.
|
|
131
131
|
permissions:
|
|
132
132
|
contents: read
|
|
@@ -280,7 +280,7 @@ jobs:
|
|
|
280
280
|
name: Secret scan, full history (gitleaks)
|
|
281
281
|
needs: plan
|
|
282
282
|
if: ${{ needs.plan.outputs.run == 'true' }}
|
|
283
|
-
runs-on: ubuntu-latest # EDIT: the
|
|
283
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes").
|
|
284
284
|
timeout-minutes: 30 # the whole history, not a range. EDIT: the default is 360.
|
|
285
285
|
permissions:
|
|
286
286
|
contents: read
|
|
@@ -409,7 +409,7 @@ jobs:
|
|
|
409
409
|
name: Report a red nightly
|
|
410
410
|
needs: [plan, heavy, secrets]
|
|
411
411
|
if: ${{ always() && github.event_name == 'schedule' && (needs.heavy.result == 'failure' || needs.secrets.result == 'failure') }}
|
|
412
|
-
runs-on: ubuntu-latest # EDIT: needs `gh`.
|
|
412
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class; it needs `gh`.
|
|
413
413
|
timeout-minutes: 5
|
|
414
414
|
permissions:
|
|
415
415
|
issues: write
|
package/templates/ci-node.yml
CHANGED
|
@@ -44,7 +44,7 @@ on:
|
|
|
44
44
|
# EDIT: on ONE self-hosted agent shared with trunk, go back to trunk-only until
|
|
45
45
|
# trunk has its own lane — branch runs queue ahead of the one trunk run a merge
|
|
46
46
|
# waits for (CONVENTIONS.md §7, "Self-hosted runners", #355). GitHub-hosted
|
|
47
|
-
# runners, a runner pool, or
|
|
47
|
+
# runners, a runner pool, or the `trunk` class picked in `runs-on` on
|
|
48
48
|
# github.ref all have that capacity; keep '**' there. Trunk-only means the
|
|
49
49
|
# branches this repo actually has — and never drop `dev` on a Tier A or C repo:
|
|
50
50
|
# dev is the trunk, so a main-only trigger runs zero checks on the branch you
|
|
@@ -126,7 +126,7 @@ jobs:
|
|
|
126
126
|
name: Already tested at this sha or tree?
|
|
127
127
|
# EDIT: the trunk refs here mirror `concurrency`'s list above (#493).
|
|
128
128
|
if: github.event_name == 'push' && (github.event.created || github.ref == 'refs/heads/main' || github.ref == 'refs/heads/dev')
|
|
129
|
-
runs-on: ubuntu-latest # EDIT: the
|
|
129
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the class of the jobs below, never a host (CONVENTIONS.md §7, "Runner classes"); it needs `gh`.
|
|
130
130
|
timeout-minutes: 5 # one `gh api` listing, a hung call must not hold the slot. EDIT: the default is 360.
|
|
131
131
|
permissions:
|
|
132
132
|
actions: read
|
|
@@ -251,7 +251,7 @@ jobs:
|
|
|
251
251
|
name: Secret scan (gitleaks)
|
|
252
252
|
needs: dedupe
|
|
253
253
|
if: ${{ !cancelled() && needs.dedupe.outputs.tested != 'true' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository) }}
|
|
254
|
-
runs-on: ubuntu-latest # EDIT: self-hosted
|
|
254
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: quick on a branch, trunk on trunk (CONVENTIONS.md §7, "Runner classes").
|
|
255
255
|
timeout-minutes: 15 # a scan of the checkout. EDIT: the default is 360.
|
|
256
256
|
steps:
|
|
257
257
|
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
|
|
@@ -431,7 +431,7 @@ jobs:
|
|
|
431
431
|
# workspace isn't even checked out yet at job level, so a job-level
|
|
432
432
|
# hashFiles() would have been testing an empty directory even if it were
|
|
433
433
|
# allowed.
|
|
434
|
-
runs-on: ubuntu-latest # EDIT: self-hosted
|
|
434
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: full (quick if it keeps quick's promise) on a branch, trunk on trunk (CONVENTIONS.md §7, "Runner classes").
|
|
435
435
|
timeout-minutes: 60 # a hung build must not hold the runner for the 360-minute default (#572).
|
|
436
436
|
# EDIT: measured (#572): the slowest Node adopter's build ran p99 37 / max 43 min. Keep this
|
|
437
437
|
# well above YOUR p99 — below it a slow but healthy suite goes red (`gh run view <id>` per job).
|
|
@@ -785,7 +785,7 @@ jobs:
|
|
|
785
785
|
# # including `dedupe`, which is skipped on every ordinary push (#418). `roundtrip` is `on`
|
|
786
786
|
# # only once ROUNDTRIP_APPLY (the workflow env, above) is set — skipped until then (#625).
|
|
787
787
|
# if: ${{ !cancelled() && needs.build.result == 'success' && needs.build.outputs.roundtrip == 'on' }}
|
|
788
|
-
# runs-on: ubuntu-latest # EDIT: self-hosted
|
|
788
|
+
# runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: e2e (service containers) (CONVENTIONS.md §7, "Runner classes").
|
|
789
789
|
# timeout-minutes: 15 # a hung round-trip must not hold the runner for the 360-minute default (#572).
|
|
790
790
|
# # EDIT: measured (#572): p99 under 4 min on every adopter. Keep it well above your own p99.
|
|
791
791
|
# strategy:
|
|
@@ -63,7 +63,7 @@ jobs:
|
|
|
63
63
|
# that concludes `success` when the nightly skips: a run whose jobs all skip reads as not-green.
|
|
64
64
|
plan:
|
|
65
65
|
name: What to test
|
|
66
|
-
runs-on: ubuntu-latest # EDIT:
|
|
66
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes"); it needs `gh`.
|
|
67
67
|
timeout-minutes: 5
|
|
68
68
|
permissions:
|
|
69
69
|
actions: read
|
|
@@ -128,7 +128,7 @@ jobs:
|
|
|
128
128
|
name: Full suite @ ${{ needs.plan.outputs.sha }}
|
|
129
129
|
needs: plan
|
|
130
130
|
if: ${{ needs.plan.outputs.run == 'true' }}
|
|
131
|
-
runs-on: ubuntu-latest # EDIT: self-hosted
|
|
131
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: e2e (service containers), browser (browser-driven), else trunk (CONVENTIONS.md §7, "Runner classes").
|
|
132
132
|
timeout-minutes: 120 # EDIT: well above YOUR heavy p99; the default is 360.
|
|
133
133
|
permissions:
|
|
134
134
|
contents: read
|
|
@@ -289,7 +289,7 @@ jobs:
|
|
|
289
289
|
name: Secret scan, full history (gitleaks)
|
|
290
290
|
needs: plan
|
|
291
291
|
if: ${{ needs.plan.outputs.run == 'true' }}
|
|
292
|
-
runs-on: ubuntu-latest # EDIT: the
|
|
292
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes").
|
|
293
293
|
timeout-minutes: 30 # the whole history, not a range. EDIT: the default is 360.
|
|
294
294
|
permissions:
|
|
295
295
|
contents: read
|
|
@@ -418,7 +418,7 @@ jobs:
|
|
|
418
418
|
name: Report a red nightly
|
|
419
419
|
needs: [plan, heavy, secrets]
|
|
420
420
|
if: ${{ always() && github.event_name == 'schedule' && (needs.heavy.result == 'failure' || needs.secrets.result == 'failure') }}
|
|
421
|
-
runs-on: ubuntu-latest # EDIT: needs `gh`.
|
|
421
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class; it needs `gh`.
|
|
422
422
|
timeout-minutes: 5
|
|
423
423
|
permissions:
|
|
424
424
|
issues: write
|
package/templates/ci-python.yml
CHANGED
|
@@ -56,7 +56,7 @@ on:
|
|
|
56
56
|
# EDIT: on ONE self-hosted agent shared with trunk, go back to trunk-only until
|
|
57
57
|
# trunk has its own lane — branch runs queue ahead of the one trunk run a merge
|
|
58
58
|
# waits for (CONVENTIONS.md §7, "Self-hosted runners", #355). GitHub-hosted
|
|
59
|
-
# runners, a runner pool, or
|
|
59
|
+
# runners, a runner pool, or the `trunk` class picked in `runs-on` on
|
|
60
60
|
# github.ref all have that capacity; keep '**' there. Trunk-only means the
|
|
61
61
|
# branches this repo actually has — and never drop `dev` on a Tier A or C repo:
|
|
62
62
|
# dev is the trunk, so a main-only trigger runs zero checks on the branch you
|
|
@@ -137,7 +137,7 @@ jobs:
|
|
|
137
137
|
name: Already tested at this sha or tree?
|
|
138
138
|
# EDIT: the trunk refs here mirror `concurrency`'s list above (#493).
|
|
139
139
|
if: github.event_name == 'push' && (github.event.created || github.ref == 'refs/heads/main' || github.ref == 'refs/heads/dev')
|
|
140
|
-
runs-on: ubuntu-latest # EDIT: the
|
|
140
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the class of the jobs below, never a host (CONVENTIONS.md §7, "Runner classes"); it needs `gh`.
|
|
141
141
|
timeout-minutes: 5 # one `gh api` listing, a hung call must not hold the slot. EDIT: the default is 360.
|
|
142
142
|
permissions:
|
|
143
143
|
actions: read
|
|
@@ -262,7 +262,7 @@ jobs:
|
|
|
262
262
|
name: Secret scan (gitleaks)
|
|
263
263
|
needs: dedupe
|
|
264
264
|
if: ${{ !cancelled() && needs.dedupe.outputs.tested != 'true' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository) }}
|
|
265
|
-
runs-on: ubuntu-latest # EDIT: self-hosted
|
|
265
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: quick on a branch, trunk on trunk (CONVENTIONS.md §7, "Runner classes").
|
|
266
266
|
timeout-minutes: 15 # a scan of the checkout. EDIT: the default is 360.
|
|
267
267
|
steps:
|
|
268
268
|
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
|
|
@@ -419,7 +419,7 @@ jobs:
|
|
|
419
419
|
name: Build (Python)
|
|
420
420
|
needs: dedupe
|
|
421
421
|
if: ${{ !cancelled() && needs.dedupe.outputs.tested != 'true' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.repository) }}
|
|
422
|
-
runs-on: ubuntu-latest # EDIT: self-hosted
|
|
422
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: full (quick if it keeps quick's promise) on a branch, trunk on trunk (CONVENTIONS.md §7, "Runner classes").
|
|
423
423
|
timeout-minutes: 30 # a hung build must not hold the runner for the 360-minute default (#572).
|
|
424
424
|
# EDIT: NOT a measured fit (#572) — one Python adopter, whose build is a byte-compile (p99
|
|
425
425
|
# under 1 min). Set it well above YOUR p99 — below it a slow but healthy suite goes red.
|
|
@@ -754,7 +754,7 @@ jobs:
|
|
|
754
754
|
# # including `dedupe`, which is skipped on every ordinary push (#418). `roundtrip` is `on`
|
|
755
755
|
# # only once ROUNDTRIP_APPLY (the workflow env, above) is set — skipped until then (#625).
|
|
756
756
|
# if: ${{ !cancelled() && needs.build.result == 'success' && needs.build.outputs.roundtrip == 'on' }}
|
|
757
|
-
# runs-on: ubuntu-latest # EDIT: self-hosted
|
|
757
|
+
# runs-on: ubuntu-latest # EDIT: self-hosted → a class, never a host: e2e (service containers) (CONVENTIONS.md §7, "Runner classes").
|
|
758
758
|
# timeout-minutes: 15 # a hung round-trip must not hold the runner for the 360-minute default (#572).
|
|
759
759
|
# # EDIT: NOT measured for Python (#572) — ci-node's adopters ran p99 under 4 min. Keep it well above your own p99.
|
|
760
760
|
# strategy:
|
|
@@ -11,6 +11,7 @@ on:
|
|
|
11
11
|
jobs:
|
|
12
12
|
instruction-files:
|
|
13
13
|
uses: futurelastic/colab-handbook/.github/workflows/instruction-files.yml@main
|
|
14
|
-
# No GitHub-hosted minutes (self-hosted-only org)? Pass your runner (#594) — a label or a JSON list
|
|
14
|
+
# No GitHub-hosted minutes (self-hosted-only org)? Pass your runner (#594) — a label or a JSON list,
|
|
15
|
+
# naming a job class, never a host (CONVENTIONS.md §7, "Runner classes"):
|
|
15
16
|
# with:
|
|
16
|
-
# runs-on: '["self-hosted","
|
|
17
|
+
# runs-on: '["self-hosted","quick"]'
|
|
@@ -221,9 +221,11 @@
|
|
|
221
221
|
# owner's billing fails GitHub refuses a hosted job before it starts: main goes red, every landing
|
|
222
222
|
# is refused until a human steps in — measured twice in a row on one adopting repo, where this was
|
|
223
223
|
# the only workflow on main still on hosted runners. So:
|
|
224
|
-
# private / internal repo `release
|
|
225
|
-
#
|
|
226
|
-
#
|
|
224
|
+
# private / internal repo `release` and `npm-record` run on the trunk class, `[self-hosted,
|
|
225
|
+
# trunk]` — the class your ci.yml's trunk jobs use (CONVENTIONS.md §7,
|
|
226
|
+
# "Runner classes"); `deploy`, if you enable it, on its own restricted
|
|
227
|
+
# deploy label. The runner needs git, node, gh and jq on its PATH
|
|
228
|
+
# (GitHub-hosted images have all four).
|
|
227
229
|
# public repo `ubuntu-latest` is fine — hosted minutes are free there.
|
|
228
230
|
# the `npm` job GitHub-hosted on every repo: npm trusted publishing requires it. It only
|
|
229
231
|
# runs on a public repo (a private one is refused outright, #432), so it
|
|
@@ -359,7 +361,7 @@ jobs:
|
|
|
359
361
|
# the whole run as `skipped` at that main sha, and `colab ship` reads any finished run that is
|
|
360
362
|
# neither success nor cancelled as "not green". Re-run CI green on that sha and the skipped
|
|
361
363
|
# Release (auto) row would still sit beside it, refusing every ship until main moves.
|
|
362
|
-
# EDIT: PRIVATE repo →
|
|
364
|
+
# EDIT: PRIVATE repo → the trunk class, [self-hosted, trunk] — a class, never a host
|
|
363
365
|
# (RUNNERS, above). ubuntu-latest only on a public repo.
|
|
364
366
|
runs-on: ubuntu-latest
|
|
365
367
|
permissions:
|
|
@@ -107,7 +107,7 @@ jobs:
|
|
|
107
107
|
release:
|
|
108
108
|
name: Publish release
|
|
109
109
|
needs: heavy
|
|
110
|
-
runs-on: ubuntu-latest # EDIT: self-hosted
|
|
110
|
+
runs-on: ubuntu-latest # EDIT: self-hosted → the trunk class, never a host (CONVENTIONS.md §7, "Runner classes").
|
|
111
111
|
permissions:
|
|
112
112
|
# Required to create the release. Nothing else is needed — keep it minimal.
|
|
113
113
|
contents: write
|
package/tools/lib/adopt.js
CHANGED
|
@@ -363,7 +363,7 @@ function releaseRungSteps(ctx = {}) {
|
|
|
363
363
|
const texts = ctx.workflowTexts || {};
|
|
364
364
|
const releaseWf = Object.keys(texts).find((f) => /colab release cut/.test(texts[f] || ''));
|
|
365
365
|
if (releaseWf) {
|
|
366
|
-
steps.push({ n: 6, text: `Release workflow present (.github/workflows/${releaseWf}) — check its \`HANDBOOK_REF\` names a ref the handbook carries (#480) and its \`runs-on\` is the self-hosted
|
|
366
|
+
steps.push({ n: 6, text: `Release workflow present (.github/workflows/${releaseWf}) — check its \`HANDBOOK_REF\` names a ref the handbook carries (#480) and its \`runs-on\` is the trunk class, [self-hosted, trunk], on a private repo` });
|
|
367
367
|
} else {
|
|
368
368
|
steps.push({ n: 6, text: 'Copy the release workflow — `colab template release-auto`, then walk its `# EDIT:` points: `HANDBOOK_REF` (a channel or tag the handbook carries, #480), the test-suite workflow `name:`, and on a PRIVATE repo the self-hosted runner label from ci.yml on every job except `npm` (#492)' });
|
|
369
369
|
}
|
|
@@ -114,7 +114,7 @@ function findings({ readFile, workflows, visibility }) {
|
|
|
114
114
|
const own = selfHostedLabel(workflows, readFile, wf);
|
|
115
115
|
const hint = own
|
|
116
116
|
? `use the label your ${own.wf} already runs on: runs-on: [${own.labels.join(', ')}]`
|
|
117
|
-
: 'use
|
|
117
|
+
: 'use the trunk runner class: runs-on: [self-hosted, trunk] (CONVENTIONS.md §7, "Runner classes")';
|
|
118
118
|
for (const j of hosted) {
|
|
119
119
|
out.push(`${wf} job \`${j.job}\` runs on GitHub-hosted (${j.runsOn.join(', ')}, line ${j.line}) on a ${String(visibility).toLowerCase()} repo — hosted minutes are billed here, and a billing refusal fails this run at trunk's head, which turns trunk red for \`colab ship\`; ${hint} (templates/release-auto.yml, RUNNERS)`);
|
|
120
120
|
}
|