Skip to content

Using docker compose to handle self-hosted GitHub runner

Notifications You must be signed in to change notification settings

spindev/docker-compose-gha-runner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Docker Compose Runner

This project uses Docker Compose to manage scaled GitHub self-hosted Runner instances.

Prerequisites

  • Docker
  • Docker Compose

Usage

Setup

  1. Clone the repository:
git clone https://github.com/yourusername/docker-compose-gha-runner.git
cd docker-compose-gha-runner
  1. Edit the .env file and set the required environment variables:
RUNNER_GITHUB_URL=https://github.com
RUNNER_ORG=<org>
RUNNER_LABELS=<labels>
RUNNER_REG_TOKEN=<REG_TOKEN>
RUNNER_GROUP=<RUNNERGROUP>
  1. Start the Docker Compose services:
docker-compose up -d
  1. Verify that the runners are registered and active in your GitHub organization.

Stopping the Runners

To stop the runners, run:

docker-compose down

About

Using docker compose to handle self-hosted GitHub runner

Resources

Stars

Watchers

Forks