Add Kubernetes example configurations for Hytale server deployment

Author: zuedev

examples/k8s/README.md

@@ -0,0 +1,39 @@
+A Kubernetes example configuration for deploying the Hytale server.
+
+## Files
+
+- `namespace.yaml` - Creates a dedicated namespace for the Hytale server
+- `deployment.yaml` - Deploys the Hytale server container
+- `service.yaml` - Exposes the server via a NodePort service (UDP)
+- `pvc.yaml` - Persistent Volume Claim for server data
+
+## Quick Start
+
+1. Apply all manifests:
+
+```bash
+kubectl apply -f examples/k8s/
+```
+
+2. Or apply individually in order:
+
+```bash
+kubectl apply -f examples/k8s/namespace.yaml
+kubectl apply -f examples/k8s/pvc.yaml
+kubectl apply -f examples/k8s/deployment.yaml
+kubectl apply -f examples/k8s/service.yaml
+```
+
+## Accessing the Server
+
+By default, the server is exposed via NodePort on port `30520`. Connect to your Hytale server using:
+
+```
+<node-ip>:30520
+```
+
+## Customization
+
+- Modify the `pvc.yaml` to adjust storage size or use a different StorageClass
+- Update the `service.yaml` to use LoadBalancer type if your cluster supports it
+- Adjust resource limits in `deployment.yaml` based on your server requirements

examples/k8s/deployment.yaml

@@ -0,0 +1,42 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: hytale-server
+  namespace: hytale
+  labels:
+    app: hytale-server
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: hytale-server
+  strategy:
+    type: Recreate
+  template:
+    metadata:
+      labels:
+        app: hytale-server
+    spec:
+      containers:
+        - name: hytale
+          image: ghcr.io/zuedev/hytale-server-docker:main
+          ports:
+            - containerPort: 5520
+              protocol: UDP
+              name: game
+          volumeMounts:
+            - name: hytale-data
+              mountPath: /app/Hytale
+          stdin: true
+          tty: true
+          resources:
+            requests:
+              memory: "2Gi"
+              cpu: "1"
+            limits:
+              memory: "4Gi"
+              cpu: "2"
+      volumes:
+        - name: hytale-data
+          persistentVolumeClaim:
+            claimName: hytale-data

examples/k8s/namespace.yaml

@@ -0,0 +1,6 @@
+apiVersion: v1
+kind: Namespace
+metadata:
+  name: hytale
+  labels:
+    app: hytale-server

examples/k8s/pvc.yaml

@@ -0,0 +1,13 @@
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: hytale-data
+  namespace: hytale
+  labels:
+    app: hytale-server
+spec:
+  accessModes:
+    - ReadWriteOnce
+  resources:
+    requests:
+      storage: 10Gi

examples/k8s/service.yaml

@@ -0,0 +1,17 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: hytale-server
+  namespace: hytale
+  labels:
+    app: hytale-server
+spec:
+  type: NodePort
+  selector:
+    app: hytale-server
+  ports:
+    - port: 5520
+      targetPort: 5520
+      nodePort: 30520
+      protocol: UDP
+      name: game