Gitea Actions Helm Chart

This helm chart serves as the way to deploy the Gitea act-runners alongside a running Gitea instance.
It serves as a standalone chart and does not rely on Gitea to be present in the same environment, however it needs to be able to reach a Gitea instance to function.
The parameters which can be used to customize the deployment are described below, check those out if you want to see if something is supported.

If you want to propose a new feature or mechanism, submit an issue here.

Quick-start

Documentation

To get started, add the Helm repo, assuming you have not already:

helm repo add gitea-charts https://dl.gitea.com/charts/
helm repo update

Then pull the values.yaml file and fill it accordingly.

helm show values gitea-charts/actions > values.yaml

Deploy with your values, make sure the path is correct:

helm upgrade --install gitea-actions gitea-charts/actions -f values.yaml

You should be good to go!

Runner Token Secret Template

For reference, a template for the secret is given below:

apiVersion: v1
kind: Secret
metadata:
  name: runner-secret
  namespace: "my-gitea-namespace"
type: Opaque
stringData:
    runner-token: "my-cool-runner-token-given-by-gitea"

Rootless Options

If .Values.statefulset.dind.rootless: true is set, then the following will be required:
.Values.statefulset.dind.tag must be a rootless image such as: 29.3.1-dind-rootless

Parameters

Gitea Actions

Name	Description	Value
enabled	Create an act runner StatefulSet.	false
statefulset.replicas	the amount of (replica) runner pods deployed	1
statefulset.timezone	is the timezone that will be set in the act_runner image	Etc/UTC
statefulset.annotations	Act runner annotations	{}
statefulset.labels	Act runner labels	{}
statefulset.resources	Act runner resources	{}
statefulset.nodeSelector	NodeSelector for the statefulset	{}
statefulset.tolerations	Tolerations for the statefulset	[]
statefulset.affinity	Affinity for the statefulset	{}
statefulset.extraVolumes	Extra volumes for the statefulset	[]
statefulset.actRunner.registry	image registry, e.g. gcr.io,docker.io	docker.gitea.com
statefulset.actRunner.repository	The Gitea act runner image	act_runner
statefulset.actRunner.tag	The Gitea act runner tag	0.3.0
statefulset.actRunner.digest	Image digest. Allows to pin the given image tag. Useful for having control over mutable tags like latest	""
statefulset.actRunner.pullPolicy	The Gitea act runner pullPolicy	IfNotPresent
statefulset.actRunner.fullOverride	Completely overrides the image registry, path/image, tag and digest.	""
statefulset.actRunner.extraVolumeMounts	Allows mounting extra volumes in the act runner container	[]
statefulset.actRunner.config	Act runner custom configuration. See Act Runner documentation for details.	Too complex. See values.yaml
statefulset.dind.rootless	a simple flag to let helm know we are dealing with a rootless dind container	false
statefulset.dind.uid	a field to set the running user id for the rootless dind container, so it knows where to look for the socket	""
statefulset.dind.registry	image registry, e.g. gcr.io,docker.io	docker.io
statefulset.actRunner.extraEnvs	Allows adding custom environment variables	[]
statefulset.dind.repository	The Docker-in-Docker image	docker
statefulset.dind.tag	The Docker-in-Docker image tag	29.3.1-dind
statefulset.dind.digest	Image digest. Allows to pin the given image tag. Useful for having control over mutable tags like latest	""
statefulset.dind.fullOverride	Completely overrides the image registry, path/image, tag and digest.	""
statefulset.dind.pullPolicy	The Docker-in-Docker pullPolicy	IfNotPresent
statefulset.dind.extraVolumeMounts	Allows mounting extra volumes in the Docker-in-Docker container	[]
statefulset.dind.extraEnvs	Allows adding custom environment variables, such as DOCKER_IPTABLES_LEGACY	[]
statefulset.persistence.size	Size for persistence to store act runner data	1Gi
statefulset.securityContext	Customize the SecurityContext	{}
statefulset.serviceAccountName	Customize the service account name	""

Gitea Actions Init

Name	Description	Value
init.image.registry	image registry, e.g. gcr.io,docker.io	""
init.image.repository	The init image	busybox
init.image.tag	the init image tag	1.37.0
init.image.digest	Image digest. Allows to pin the given image tag. Useful for having control over mutable tags like latest	""
init.image.pullPolicy	The init image pullPolicy	IfNotPresent
init.image.fullOverride	Completely overrides the image registry, path/image, tag and digest.	""

Runner Token Secret Configuration

Name	Description	Value
existingSecret	Secret that contains the token	""
existingSecretKey	Secret key	""

Gitea URL Setting

Name	Description	Value
giteaRootURL	URL the act_runner registers and connect with	""

Extra Init Containers

Name	Description	Value
preExtraInitContainers	Additional init containers to run in the pod before Gitea-actions runs it owns init containers.	[]
postExtraInitContainers	Additional init containers to run in the pod after Gitea-actions runs it owns init containers.	[]

Global

Name	Description	Value
global.imageRegistry	global image registry override	""
global.imagePullSecrets	global image registry pull secrets	[]
global.storageClass	global storage class override	""