Gitea Actions runner

About

gitea-actions-runner was created to produce self-hosted Gitea Actions runner container images. This project is forked from actions/actions-runner-controller and incorporates code from actions-runner-controller/releases.

There are 3 main variants of the image, each available for amd64 and arm64:

1. gitea-actions-runner

Base image with Gitea Actions runner.

ghcr.io/rpenziol/gitea-actions-runner

2. gitea-actions-runner-dind

Image with Gitea Actions runner and Docker-in-Docker. Compatible with workflows with Docker steps. Does not require Docker socket to be mounted.

ghcr.io/rpenziol/gitea-actions-runner-dind

3. gitea-actions-runner-dind-rootless (coming soon)

Image with Gitea Actions runner and Docker-in-Docker. Compatible with workflows with Docker steps. Container runs as non-root user.

ghcr.io/rpenziol/gitea-actions-runner-dind-rootless

Getting Started

Follow Gitea's initial getting started guide for Gitea Actions https://blog.gitea.io/2023/03/hacking-on-gitea-actions/

Kubernetes

Tailor of the template below to meet your needs. As-is this will create a Gitea Runner pod in Kubernetes that will allow you to run Gitea Actions with Docker steps.

---
apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    io.kompose.service: gitea-runner
  name: gitea-runner
spec:
  replicas: 1
  selector:
    matchLabels:
      io.kompose.service: gitea-runner
  strategy:
    type: Recreate
  template:
    metadata:
      labels:
        io.kompose.service: gitea-runner
      annotations:
    spec:
      containers:
      - name: runner
        image: ghcr.io/rpenziol/gitea-actions-runner-dind
        volumeMounts:
        - mountPath: /.runner
          name: gitea-runner-configmap
          subPath: .runner
        securityContext:
          privileged: true
      hostNetwork: true
      volumes:
        - name: gitea-runner-configmap
          configMap:
            name: gitea-runner-configmap
status: {}

---
apiVersion: v1
kind: ConfigMap
metadata:
  name: gitea-runner-configmap
data:
  .runner: |
    {
      "id": 6,
      "uuid": "b66cdb63-c4ee-48e1-9326-4bb01afaff73",
      "name": "gitea-runner-1",
      "token": "your-generated-gitea-token-here",
      "address": "https://gitea.yourdomain.com",
      "insecure": "true",
      "labels": [
        "ubuntu-latest:docker://node:16-bullseye",
        "ubuntu-22.04:docker://node:16-bullseye",
        "ubuntu-20.04:docker://node:16-bullseye",
        "ubuntu-18.04:docker://node:16-buster"
      ]
    }

Contributing

We welcome contributions from the community. For more details on contributing to the project (including requirements), please refer to "Getting Started with Contributing."

Troubleshooting

We are very happy to help you with any issues you have. Please refer to the "Troubleshooting" section for common issues.