Add Helm chart to deploy Valheim dedicated server
StatefulSet with persistent world data, NodePort service for game/query/ crossplay ports, and secret for the server password. Co-authored-by: Copilot <[email protected]>
This commit is contained in:
+14
@@ -0,0 +1,14 @@
|
||||
apiVersion: v2
|
||||
name: valheim
|
||||
description: Helm chart to run a Valheim dedicated game server on Kubernetes
|
||||
type: application
|
||||
version: 0.1.0
|
||||
appVersion: "latest"
|
||||
home: https://git.smokyzone.de/SmokyZone/valheim-gitops
|
||||
sources:
|
||||
- https://git.smokyzone.de/SmokyZone/valheim-gitops
|
||||
keywords:
|
||||
- valheim
|
||||
- gameserver
|
||||
maintainers:
|
||||
- name: SmokyZone
|
||||
@@ -0,0 +1,43 @@
|
||||
# valheim-gitops
|
||||
|
||||
Helm chart to run a [Valheim](https://www.valheimgame.com/) dedicated server on Kubernetes,
|
||||
using the community [`lloesche/valheim-server`](https://github.com/lloesche/valheim-server-docker)
|
||||
image.
|
||||
|
||||
## What's included
|
||||
|
||||
- **Namespace** (`valheim` by default, toggle with `namespace.create`)
|
||||
- **StatefulSet** running the game server with a persistent volume for world data
|
||||
(`/config` and `/opt/valheim`) so the world survives restarts/upgrades
|
||||
- **Secret** holding the server join password (`SERVER_PASS`)
|
||||
- **Service** (`NodePort` by default) exposing the game (2456/udp), query (2457/udp)
|
||||
and crossplay (2458/udp) ports
|
||||
- Headless **Service** for the StatefulSet
|
||||
|
||||
## Configuration
|
||||
|
||||
See [`values.yaml`](values.yaml) for all options. Important ones:
|
||||
|
||||
| Key | Description | Default |
|
||||
|---|---|---|
|
||||
| `server.name` | Server name shown in the browser | `Valtersheim` |
|
||||
| `server.worldName` | World save name | `Midgard` |
|
||||
| `server.password` | Join password (override via `-f secret-values.yaml`, never commit real passwords) | `changeme-please-override` |
|
||||
| `service.type` | `NodePort` or `LoadBalancer` | `NodePort` |
|
||||
| `persistence.storageClassName` | StorageClass for world data, empty = cluster default | `""` |
|
||||
| `persistence.size` | Size of the world data volume | `10Gi` |
|
||||
|
||||
## Usage
|
||||
|
||||
```sh
|
||||
helm upgrade --install valheim . -n valheim --create-namespace \
|
||||
--set server.password=<your-password>
|
||||
```
|
||||
|
||||
### Deploying via ArgoCD
|
||||
|
||||
This repository is intended to be deployed as an ArgoCD `Application` using this
|
||||
chart as the Helm source (see `apps-in-apps` repo for the bootstrap Application).
|
||||
|
||||
> Never commit real passwords in `values.yaml`. Use `--set`, a separate values file
|
||||
> excluded from git, or a secrets manager (SealedSecrets/ExternalSecrets) for production.
|
||||
|
||||
@@ -0,0 +1,9 @@
|
||||
{{- if .Values.namespace.create }}
|
||||
apiVersion: v1
|
||||
kind: Namespace
|
||||
metadata:
|
||||
name: {{ .Values.namespace.name }}
|
||||
labels:
|
||||
app.kubernetes.io/name: valheim
|
||||
app.kubernetes.io/managed-by: {{ .Release.Service }}
|
||||
{{- end }}
|
||||
@@ -0,0 +1,10 @@
|
||||
apiVersion: v1
|
||||
kind: Secret
|
||||
metadata:
|
||||
name: valheim-server
|
||||
namespace: {{ .Values.namespace.name }}
|
||||
labels:
|
||||
app.kubernetes.io/name: valheim
|
||||
type: Opaque
|
||||
stringData:
|
||||
SERVER_PASS: {{ .Values.server.password | quote }}
|
||||
@@ -0,0 +1,49 @@
|
||||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
name: valheim-headless
|
||||
namespace: {{ .Values.namespace.name }}
|
||||
labels:
|
||||
app.kubernetes.io/name: valheim
|
||||
spec:
|
||||
clusterIP: None
|
||||
selector:
|
||||
app.kubernetes.io/name: valheim
|
||||
ports:
|
||||
- name: game
|
||||
port: {{ .Values.service.gamePort }}
|
||||
protocol: UDP
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
name: valheim
|
||||
namespace: {{ .Values.namespace.name }}
|
||||
labels:
|
||||
app.kubernetes.io/name: valheim
|
||||
spec:
|
||||
type: {{ .Values.service.type }}
|
||||
selector:
|
||||
app.kubernetes.io/name: valheim
|
||||
ports:
|
||||
- name: game
|
||||
port: {{ .Values.service.gamePort }}
|
||||
targetPort: {{ .Values.service.gamePort }}
|
||||
protocol: UDP
|
||||
{{- if and (eq .Values.service.type "NodePort") .Values.service.nodePorts.game }}
|
||||
nodePort: {{ .Values.service.nodePorts.game }}
|
||||
{{- end }}
|
||||
- name: query
|
||||
port: {{ .Values.service.queryPort }}
|
||||
targetPort: {{ .Values.service.queryPort }}
|
||||
protocol: UDP
|
||||
{{- if and (eq .Values.service.type "NodePort") .Values.service.nodePorts.query }}
|
||||
nodePort: {{ .Values.service.nodePorts.query }}
|
||||
{{- end }}
|
||||
- name: crossplay
|
||||
port: {{ .Values.service.crossplayPort }}
|
||||
targetPort: {{ .Values.service.crossplayPort }}
|
||||
protocol: UDP
|
||||
{{- if and (eq .Values.service.type "NodePort") .Values.service.nodePorts.crossplay }}
|
||||
nodePort: {{ .Values.service.nodePorts.crossplay }}
|
||||
{{- end }}
|
||||
@@ -0,0 +1,106 @@
|
||||
apiVersion: apps/v1
|
||||
kind: StatefulSet
|
||||
metadata:
|
||||
name: valheim
|
||||
namespace: {{ .Values.namespace.name }}
|
||||
labels:
|
||||
app.kubernetes.io/name: valheim
|
||||
spec:
|
||||
serviceName: valheim-headless
|
||||
replicas: 1
|
||||
selector:
|
||||
matchLabels:
|
||||
app.kubernetes.io/name: valheim
|
||||
template:
|
||||
metadata:
|
||||
labels:
|
||||
app.kubernetes.io/name: valheim
|
||||
{{- with .Values.podAnnotations }}
|
||||
annotations:
|
||||
{{- toYaml . | nindent 8 }}
|
||||
{{- end }}
|
||||
spec:
|
||||
securityContext:
|
||||
{{- toYaml .Values.securityContext | nindent 8 }}
|
||||
containers:
|
||||
- name: valheim-server
|
||||
image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
|
||||
imagePullPolicy: {{ .Values.image.pullPolicy }}
|
||||
ports:
|
||||
- name: game
|
||||
containerPort: {{ .Values.service.gamePort }}
|
||||
protocol: UDP
|
||||
- name: query
|
||||
containerPort: {{ .Values.service.queryPort }}
|
||||
protocol: UDP
|
||||
- name: crossplay
|
||||
containerPort: {{ .Values.service.crossplayPort }}
|
||||
protocol: UDP
|
||||
env:
|
||||
- name: SERVER_NAME
|
||||
value: {{ .Values.server.name | quote }}
|
||||
- name: WORLD_NAME
|
||||
value: {{ .Values.server.worldName | quote }}
|
||||
- name: SERVER_PASS
|
||||
valueFrom:
|
||||
secretKeyRef:
|
||||
name: valheim-server
|
||||
key: SERVER_PASS
|
||||
- name: SERVER_PUBLIC
|
||||
value: {{ .Values.server.public | ternary "1" "0" | quote }}
|
||||
{{- if .Values.server.admins }}
|
||||
- name: ADMINLIST_IDS
|
||||
value: {{ .Values.server.admins | quote }}
|
||||
{{- end }}
|
||||
- name: UPDATE_INTERVAL
|
||||
value: {{ .Values.server.updateIntervalSeconds | quote }}
|
||||
- name: BACKUPS_INTERVAL
|
||||
value: {{ .Values.server.backupIntervalSeconds | quote }}
|
||||
{{- if .Values.server.backupCronExpression }}
|
||||
- name: BACKUPS_CRON
|
||||
value: {{ .Values.server.backupCronExpression | quote }}
|
||||
{{- end }}
|
||||
{{- range .Values.server.extraEnv }}
|
||||
- name: {{ .name }}
|
||||
value: {{ .value | quote }}
|
||||
{{- end }}
|
||||
volumeMounts:
|
||||
- name: valheim-data
|
||||
mountPath: /config
|
||||
subPath: config
|
||||
- name: valheim-data
|
||||
mountPath: /opt/valheim
|
||||
subPath: server
|
||||
resources:
|
||||
{{- toYaml .Values.resources | nindent 12 }}
|
||||
{{- if not .Values.persistence.enabled }}
|
||||
volumes:
|
||||
- name: valheim-data
|
||||
emptyDir: {}
|
||||
{{- end }}
|
||||
{{- with .Values.nodeSelector }}
|
||||
nodeSelector:
|
||||
{{- toYaml . | nindent 8 }}
|
||||
{{- end }}
|
||||
{{- with .Values.tolerations }}
|
||||
tolerations:
|
||||
{{- toYaml . | nindent 8 }}
|
||||
{{- end }}
|
||||
{{- with .Values.affinity }}
|
||||
affinity:
|
||||
{{- toYaml . | nindent 8 }}
|
||||
{{- end }}
|
||||
{{- if .Values.persistence.enabled }}
|
||||
volumeClaimTemplates:
|
||||
- metadata:
|
||||
name: valheim-data
|
||||
spec:
|
||||
accessModes:
|
||||
{{- toYaml .Values.persistence.accessModes | nindent 10 }}
|
||||
{{- if .Values.persistence.storageClassName }}
|
||||
storageClassName: {{ .Values.persistence.storageClassName }}
|
||||
{{- end }}
|
||||
resources:
|
||||
requests:
|
||||
storage: {{ .Values.persistence.size }}
|
||||
{{- end }}
|
||||
+66
@@ -0,0 +1,66 @@
|
||||
## Default values for the valheim chart
|
||||
|
||||
namespace:
|
||||
# If true, the chart creates the namespace itself.
|
||||
create: true
|
||||
name: valheim
|
||||
|
||||
image:
|
||||
repository: lloesche/valheim-server
|
||||
tag: latest
|
||||
pullPolicy: IfNotPresent
|
||||
|
||||
server:
|
||||
name: "Valtersheim"
|
||||
worldName: "Midgard"
|
||||
# Leave empty to auto-generate a random password on first deploy via the secret below.
|
||||
# It is strongly recommended to override this via --set or a separate values file that is
|
||||
# NOT committed to git (or use SealedSecrets/ExternalSecrets in production).
|
||||
password: "changeme-please-override"
|
||||
public: true
|
||||
# Comma separated SteamIDs allowed to join/admin the server (optional)
|
||||
admins: ""
|
||||
updateIntervalSeconds: 900
|
||||
backupIntervalSeconds: 3600
|
||||
backupCronExpression: ""
|
||||
# extra env vars appended to the container, e.g. SERVER_ARGS, CROSSPLAY, etc.
|
||||
extraEnv: []
|
||||
# - name: CROSSPLAY
|
||||
# value: "true"
|
||||
|
||||
service:
|
||||
type: NodePort
|
||||
# Game (2456), query (2457) and crossplay (2458) ports.
|
||||
gamePort: 2456
|
||||
queryPort: 2457
|
||||
crossplayPort: 2458
|
||||
# Only used when type is NodePort. Leave 0 to let Kubernetes pick a random port.
|
||||
nodePorts:
|
||||
game: 30456
|
||||
query: 30457
|
||||
crossplay: 30458
|
||||
|
||||
persistence:
|
||||
enabled: true
|
||||
size: 10Gi
|
||||
# Leave empty to use the cluster default StorageClass.
|
||||
storageClassName: ""
|
||||
accessModes:
|
||||
- ReadWriteOnce
|
||||
|
||||
resources:
|
||||
requests:
|
||||
cpu: 1000m
|
||||
memory: 3Gi
|
||||
limits:
|
||||
cpu: 2000m
|
||||
memory: 6Gi
|
||||
|
||||
securityContext:
|
||||
fsGroup: 1000
|
||||
|
||||
podAnnotations: {}
|
||||
|
||||
nodeSelector: {}
|
||||
tolerations: []
|
||||
affinity: {}
|
||||
Reference in New Issue
Block a user