paolomainardi/additronk8s-game-engine

AdditronK8S 镜像概述

AdditronK8S是一个复古游戏机，以Kubernetes自定义控制器形式构建并使用Javascript实现。其名称"Additron"致敬发明家Josef Kates，他发明了首个数字游戏机Bertie the Brain以展示Additron管技术。本项目为概念验证（PoC），用于演示Kubernetes API在构建自定义应用时的灵活性。

核心功能

1. 基于Dosbox + noVNC + Pulseaudio/gStreamer的Docker镜像，支持浏览器端运行DOS游戏；
2. Javascript实现的Kubernetes自定义控制器，管理游戏资源的创建与运行；
3. 利用Configmap作为持久化存储层（无外部依赖）；
4. 支持从公共HTTP端点或GCP存储桶加载游戏压缩包。

使用场景

• 技术演示：展示Kubernetes API的扩展能力与自定义控制器开发；
• 复古游戏体验：在K8s集群中运行经典DOS游戏；
• 学习实践：探索Javascript与Kubernetes API的结合应用。

配置说明

前提条件

需拥有正常运行的Kubernetes集群，且具备外部网络连接能力。

部署步骤

1. 安装游戏控制器：

shell
kubectl apply -f k8s/manifests/namespace.yml
kubectl -n games apply -f k8s/manifests/crd-game-controller.yml
kubectl -n games apply -f k8s/manifests/game-controller-sa.yml
kubectl -n games apply -f k8s/manifests/game-controller-cluster-role.yml
kubectl -n games apply -f k8s/manifests/game-controller-cluster-role-binding.yml
kubectl -n games apply -f k8s/manifests/game-controller.yaml

2. 运行示例游戏（如Quake）：

shell
kubectl -n games apply -f k8s/games/quake.yml

3. 查看控制器日志：

shell
kubectl -n games logs deployment/game-controller -f

4. 访问游戏： 通过端口转发暴露服务：

shell
kubectl port-forward svc/quake 8080:8080 8081:8081

在浏览器中访问https://localhost:8080，按ALT+s启动音频WebSocket，再执行游戏命令即可开始游戏。

游戏资源配置

游戏资源清单示例（YAML）：

yaml
apiVersion: retro.sparkfabrik.com/v1
kind: Game
metadata:
  name: game-name
spec:
  name: "友好的游戏名称"
  zipUrl: "gs://my-gs-bucket/game.zip"  # 游戏压缩包地址
  dir: "GAME"  # 解压后的目录
  exe: "GAME.EXE"  # 游戏执行文件

开发环境

基于k3d和skaffold搭建，运行make dev可快速启动：

1. k3d Kubernetes集群；
2. 镜像加载至集群；
3. 游戏控制器热重载（代码变更自动更新）。

参考资料

• Retro DOS Games on Kubernetes：感谢William Lam的技术文章。 ===FULL_DESC===