From 90ea0807cb35438874a475b5a50ddc74eefc4250 Mon Sep 17 00:00:00 2001 From: Henry Schreiner Date: Mon, 29 Dec 2025 13:30:04 -0500 Subject: [PATCH] docs: use and mention ubuntu-slim for small tasks Signed-off-by: Henry Schreiner --- .github/workflows/docs-link.yml | 2 +- .../workflows/reusable-change-detection.yml | 2 +- docs/pages/guides/gha_basic.md | 18 +++++++++++++++++- 3 files changed, 19 insertions(+), 3 deletions(-) diff --git a/.github/workflows/docs-link.yml b/.github/workflows/docs-link.yml index 74e89980..1b62af3c 100644 --- a/.github/workflows/docs-link.yml +++ b/.github/workflows/docs-link.yml @@ -15,7 +15,7 @@ concurrency: jobs: documentation-links: - runs-on: ubuntu-latest + runs-on: ubuntu-slim if: github.event.repository.fork == false steps: - uses: readthedocs/actions/preview@v1 diff --git a/.github/workflows/reusable-change-detection.yml b/.github/workflows/reusable-change-detection.yml index 485a0b4b..106e7c78 100644 --- a/.github/workflows/reusable-change-detection.yml +++ b/.github/workflows/reusable-change-detection.yml @@ -12,7 +12,7 @@ on: jobs: change-detection: name: Identify source changes - runs-on: ubuntu-latest + runs-on: ubuntu-slim timeout-minutes: 1 outputs: run-cookie: ${{ steps.cookie-changes.outputs.run-cookie || false }} diff --git a/docs/pages/guides/gha_basic.md b/docs/pages/guides/gha_basic.md index 81baaca7..659f03d8 100644 --- a/docs/pages/guides/gha_basic.md +++ b/docs/pages/guides/gha_basic.md @@ -134,6 +134,22 @@ The formula here for installing should be identical for all users; and using builds, you are even guaranteed a consistent wheel will be produced just as if you were building a final package. +There are a variety of +[images to pick from](https://docs.github.com/en/actions/reference/runners/github-hosted-runners#single-cpu-runners), +such as: + +| Image name | Description | |==================|=============| | +`ubuntu-latest` | Standard Linux runner (specific versions available) | | +`windows-latest` | Standard Windows runner (specific versions available) | | +`macos-latest` | Standard MacOS runner (specific versions available) | | +`ubuntu-24.04-arm` | Linux ARM runner (no `latest` tag) | | `windows-11-arm` | +Windows ARM runner (no specific versions) | | `macos-15-intel` | MacOS Intel +runner (final version) | | `ubuntu-slim` | Fast startup single-core container | + +Note that while versioned images are available, like `ubuntu-24.04`, these are +all rolling images; selecting a specific image will not make your CI completely +static. And old versioned images are decommissioned. + ## Updating {% rr GH200 %} {% rr GH210 %} If you use non-default actions in your repository @@ -348,7 +364,7 @@ As an example, if you had `lint` and `checks` jobs, use this: pass: if: always() needs: [lint, checks] - runs-on: ubuntu-latest + runs-on: ubuntu-slim steps: - uses: re-actors/alls-green@release/v1 with: