runs-on - CI/CD Glossary Definition

runs-on selects which runner a job runs on, by hosted label or self-hosted labels.

runs-on is the required job key that selects which runner executes the job, either by hosted label like ubuntu-latest or by a set of self-hosted labels.

Every job needs runs-on. It maps the job to a hosted image or to self-hosted runners that carry all the listed labels.

Self-hosted example

jobs:
  build:
    runs-on: [self-hosted, linux, x64]

Related guides