liveBook · Manning

Runner

As explained in Learn Docker in a Month of Lunches, Second Edition

A build agent is a machine or hosted worker that executes automated software build jobs.

A runner is the compute provisioned by GitHub Actions to execute a build. After a push triggers a workflow, the runner checks out the repository, runs the defined steps, and is cleaned up when the build finishes. section 16.1

A typical runner workflow:

  • Receives a job from a YAML workflow triggered by a repository change. section 16.1
  • Checks out source code and executes the build logic, preferably through portable scripts. section 16.1
  • Reports success or failure before being cleaned up and decommissioned. section 16.1

Run a PowerShell build on Ubuntu

A workflow can assign a build job to an Ubuntu runner with `runs-on: ubuntu-latest`, check out the repository, and run `./build.ps1` using the PowerShell shell. section 16.1

Listing 16.3 A simple GitHub workflow to run a PowerShell script
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@master
      - name: build
        working-directory: cicd
        run: ./build.ps1
        shell: pwsh

Use the workflow listing to see how a runner checks out code and invokes the build script. section 16.1

How Learn Docker in a Month of Lunches, Second Edition covers it

How deep it goes
Explains provisioning, checkout, execution, and cleanup, but does not descend into runner internals.
Examples
Demonstrates an Ubuntu runner checking out code and running a PowerShell build script.
What it assumes
Assumes a GitHub repository and workflow basics while introducing the runner’s role in the build lifecycle.
What you can do after
Operate/configure a GitHub Actions job that runs a repository build on an Ubuntu runner.
How it connects
Connects runners with GitHub Actions, CI/CD, YAML workflows, build scripts, Docker, and unit tests.

Also explained in

Compare how 2 books explain runner →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Learn Docker in a Month of Lunches, Second Edition. The section links point to the parts of the book it draws on.