This project builds a Docker image that can be used as a Gitea Actions runner in a Kubernetes cluster. It comes with Nix pre-installed and configured, allowing for reproducible builds and consistent CI environments.

Features

Based on Nix's pure Docker image
Includes Nix package manager
Contains essential development tools (git, curl, etc.)
Docker-in-Docker capability for container builds
Optimized for Kubernetes deployment

Usage

Build the image

# Build the Docker image
just build

# Load the image into Docker
just load

# Or do both in one step
just build-load

Running the image

To run the image locally for testing:

docker run -it --rm gitea-act-runner:latest

Deploying to Kubernetes

The image is designed to be used as a Gitea Actions runner in a Kubernetes cluster. You can configure your Gitea instance to use this runner for CI/CD pipelines.

Development

This project uses the Nix flake system for development. Make sure you have Nix installed with flakes enabled.

# Enter development shell
nix develop

# Run formatter
just fmt

# Run tests
just test