README.md

Actions Runner on DigitalOcean App Platform

This is a self hosted GitHub Actions runner for deploying to DigitalOcean App Platform. You will get the simplicity of automated cluster deployment and scaling by DigitalOcean App Platform.

It will register and remove itself automatically when DigitalOcean App Platform start and stop the container. You can vertical scale or horizontal scale your runner. If you do a horizontal scale (Pro plan only), all runners will be automatically registered to GitHub.

This project is part of DigitalOcean App Platform Hackathon. See submission post.

Usage

Currently, we cannot deploy a new app that only has the worker. So you need to create a new app with a service then delete that service and create a worker.

This actions runners can be installed as a runner for repository and organization.

Environment variable

You must provide the following environment variables.

• TOKEN – Your GitHub personal access token with repo scope for repository-level and admin:org scope for organization-level runner. This token will be used for self-hosted runner registration.

Repository-level runner

• OWNER – Owner of the repository
• REPO – Repository name

Organization-level runner

• ORG – Organization name

Screenshots

GitHub settings

Horizontal scaling

DigitalOcean dashboard

Additional resources