fabianvf/game-server-operator

game-server-operator

![Build Status]([***]

镜像概述

game-server-operator是一个Kubernetes/OpenShift操作器，用于自动化部署和管理Minecraft游戏服务器。它基于itzg提供的minecraft-server镜像构建，支持灵活的配置选项，帮助用户快速在容器集群中搭建稳定的Minecraft服务。

核心功能

1. 在Kubernetes或OpenShift集群上一键部署Minecraft服务器
2. 支持多种服务器类型（Vanilla、Forge、Spigot、Paper等）
3. 可配置存储卷（PersistentVolumeClaim/EmptyDir）实现数据持久化
4. 提供丰富的服务器参数设置（难度、最大玩家数、PVP开关等）
5. 支持模组（Mod）和世界生成配置
6. 可调整JVM内存和参数优化服务器性能
7. 自动生成服务器访问URL并监控部署状态

使用场景

1. 个人或小团队搭建私用Minecraft多人服务器
2. 游戏社区在容器集群上规模化管理多个Minecraft实例
3. 开发/测试环境快速部署Minecraft服务器进行功能验证
4. 需要灵活配置和持久化存储的Minecraft服务场景

配置说明

部署操作器

确保您的kubeconfig已正确配置（可通过kubectl或oc连接集群），并拥有cluster-admin权限。安装ansible和openshift python客户端后，执行以下命令部署操作器：

bash
ansible-playbook deploy.yml

或手动部署：

bash
kubectl apply -f deploy/crds/games_v1alpha1_minecraft_crd.yaml
kubectl apply -f deploy/role.yaml
kubectl apply -f deploy/role_binding.yaml
kubectl apply -f deploy/service_account.yaml
kubectl apply -f deploy/operator.yaml

部署Minecraft服务器

创建games.fabianism.us/v1alpha1类型的Minecraft资源即可启动服务器。基础示例配置位于deploy/crds/minecraft.yaml，执行以下命令部署：

bash
kubectl apply -f deploy/crds/minecraft.yaml

监控部署状态：

bash
kubectl describe minecraft

部署完成后，状态字段会显示URL，通过该URL即可连接Minecraft服务器。

关键配置选项

基础配置

VolumeSpec（存储卷）

ServerSpec（服务器）

JvmSpec（JVM）

更多详细配置可参考镜像官方文档或itzg/minecraft-server镜像说明。