github · GitHub Actions Docs
Actions Choosing the runner for a job - GitHub Docs
Explains how to select and configure different types of runners, including GitHub-hosted runners and self-hosted runners, for specific jobs within a GitHub Actions workflow.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Actions Choosing the runner for a job - GitHub Docs
Explains how to select and configure different types of runners, including GitHub-hosted runners and self-hosted runners, for specific jobs within a GitHub Actions workflow.
When To Use
Use when you need to determine whether to use GitHub-hosted runners or self-hosted runners and how to specify them in your workflow YAML configuration to meet hardware or networking requirements.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/actions-how-tos-write-workflows-choosing-the-runner-for-a-job-github-doc-workflow-guide.md | Documentation explaining how to select and configure different types of runners for GitHub Actions jobs. | Questions about documentation explaining how to select and configure different types of runners for GitHub Actions jobs. |
examples/actions-how-tos-write-workflows-choosing-the-runner-for-a-job-github-doc.text | A YAML workflow snippet demonstrating how to use the runs-on key to specify self-hosted runner labels including linux, x64, and gpu. | Exact payloads, commands, or snippets shown in A YAML workflow snippet demonstrating how to use the runs-on key to specify self-hosted runner labels including linux... |
examples/actions-how-tos-write-workflows-choosing-the-runner-for-a-job-github-doc-2.text | A YAML workflow example demonstrating how to use workflow dispatch inputs to dynamically select a runner operating system. | Exact payloads, commands, or snippets shown in A YAML workflow example demonstrating how to use workflow dispatch inputs to dynamically select a runner operating sy... |
examples/actions-how-tos-write-workflows-choosing-the-runner-for-a-job-github-doc-3.text | A YAML workflow configuration snippet demonstrating the use of the runs-on keyword to specify different runner operating systems. | Exact payloads, commands, or snippets shown in A YAML workflow configuration snippet demonstrating the use of the runs-on keyword to specify different runner operat... |
examples/actions-how-tos-write-workflows-choosing-the-runner-for-a-job-github-doc-4.text | A YAML workflow configuration demonstrating how to specify self-hosted runners using the runs-on key. | Exact payloads, commands, or snippets shown in A YAML workflow configuration demonstrating how to specify self-hosted runners using the runs-on key. |
examples/actions-how-tos-write-workflows-choosing-the-runner-for-a-job-github-doc-5.text | A GitHub Actions workflow YAML example demonstrating how to use the runs-on key with a runner group. | Exact payloads, commands, or snippets shown in A GitHub Actions workflow YAML example demonstrating how to use the runs-on key with a runner group. |
examples/actions-how-tos-write-workflows-choosing-the-runner-for-a-job-github-doc-6.text | A YAML workflow example demonstrating how to use the runs-on property with runner groups and labels to select a specific job runner. | Exact payloads, commands, or snippets shown in A YAML workflow example demonstrating how to use the runs-on property with runner groups and labels to select a speci... |
What This Skill Covers
-
- GitHub Actions / - How-tos / - Write workflows / - Choose where workflows run / - Choose the runner for a job
- Main sections:
In this article,Overview,Choosing GitHub-hosted runners,Standard GitHub-hosted runners for public repositories,Standard GitHub-hosted runners for private repositories.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://docs.github.com/en/actions/how-tos/write-workflows/choose-where-workflows-run/choose-the-runner-for-a-job