Home

Awesome

Docker Container for GitHub Actions Runner

awesome-runners

This project will build a Docker container with the specified version of the GitHub Actions Runner installed into it. It is built off of CentOS 8 as a base by default.

Building Container

You can build this container using the following command:

$ docker build -f [centos-actions-runner|ubuntu-actions-runner]/Dockerfile -t <container_tag> .

There are some configurable Build Arguments that you can pass in to modify the container build:

The Dockerfile has two lines that are hardcoded to use yum so you will have to ensure that you use a base container that supports yum if you change it.

The GitHub Actions Runner will update itself to the latest version when it gets the first job sent to it if it is running an out of date version. The purpose of this parameter is to be able to set it to a value to test this upgrade scenario. A future version of this will access the releases endpoint to get the latest version and use that.

Running the Container

The container image supports a number of environment variables that you can pass to the container to control the registration of the self hosted runner with GitHub.

When registering the runner you have three options for the type of runner that you are wanting to create, enterprise, organization or repository self-hosted runner.

You need to provide one of the following environment variable URLs which allow the runner to be registered:

A GitHub Personal Access Token is required so that it can be used to obtain a short lived access token for the runner to register with GitHub. The permissions required on the Personal Access Token will depend upon to the use case of the token;

The token needs to be provided as the environment variable GITHUB_TOKEN.

Optional environment variables:

Running using Docker commandline examples

  1. Registering an Enterprise Runner;

    $ docker run -d \
      -e RUNNER_ENTERPRISE_URL=https://github.com/enterprises/octodemo \
      -e GITHUB_TOKEN=<PAT_token_with_admin:enterprise> \
      <container_name>
    
  2. Registering an Organization Runner;

    $ docker run -d \
      -e RUNNER_ORGANIZATION_URL=https://github.com/octodemo \
      -e GITHUB_TOKEN=<PAT_token_with_admin:org> \
      <container_name>
    
  3. Registering an Repository Runner;

    $ docker run -d \
      -e RUNNER_REPOSITORY_URL=https://github.com/octodemo/demo-repo \
      -e GITHUB_TOKEN=<PAT_token_with_repo access> \
      <container_name>