Sign inSign up

joeyx22lm/docker-github-actions-runner

By joeyx22lm

Updated almost 7 years ago

Self-hosted GitHub Actions Runner, now available in a Docker container.

Image
0

6.4K

joeyx22lm/docker-github-actions-runner repository overview

GitHub Actions Runner

Docker Cloud Automated build Docker Cloud Build Status Docker Pulls

Self-hosted GitHub Actions Runner, now available in a Docker container.

Getting Started

Example using Headless Mode:

docker run -d \
  -e GITHUB_REPOSITORY="..." \
  -e GITHUB_TOKEN="..." \
  -e RUNNER_NAME="SelfHostedRunner-001" \
  -e REPLACE_EXISTING_RUNNER="true" \
  joeyx22lm/docker-github-actions-runner

Example using Interactive Mode:

docker run -it \
  -e INTERACTIVE_MODE="true" \
  joeyx22lm/docker-github-actions-runner
Interactive Mode

The runner can be executed in an Interactive Mode, allowing the user to manually provide runner configuration at runtime. Interactive Mode can be enabled using the INTERACTIVE_MODE environment variable. No other environment variables are required for this mode.

Headless Mode

Interactive Mode can be disabled by using or omitting the INTERACTIVE_MODE environment variable.

In order for the GitHub Action Runner to begin listening without any interaction, the following environment variables must be populated:

  • GITHUB_REPOSITORY
  • GITHUB_TOKEN
Environment Variables
NameDescriptionDefaultExample
GITHUB_REPOSITORYGitHub Repository URL"""https://github.com/joeyx22lm/example"
GITHUB_TOKENGitHub API Token""N/A
RUNNER_NAMESelf-hosted Runner Name<hostname>N/A
WORK_DIRWorking Directory.workdirN/A
REPLACE_EXISTING_RUNNERReplace existing runner with matching name. Ignored when using Interactive Mode.falsetrue or false
INTERACTIVE_MODEDon't skip runner configuration promptfalsetrue or false

Releases

Docker Tags
TagDescription
alphaNot Stable. Regularly updated from the development branch.
latestStable. Latest Version.
<version>Stable.
Changelog
ReleaseDescription
v0.1.0Added support for runner name, custom working directory, interactive mode and runner replacement policy.
v0.0.1Ubuntu 16.04, Runner v2.160.0

Tag summary

Content type

Image

Digest

Size

225.4 MB

Last updated

almost 7 years ago

docker pull joeyx22lm/docker-github-actions-runner