openkruise/kruise-game-manager

游戏服务器Kubernetes管理镜像

概述

该Docker镜像专为在Kubernetes集群环境中管理游戏服务器而设计，提供从部署、扩展到监控、运维的全流程管理能力。通过集成Kubernetes原生功能与游戏服务器特性，实现游戏服务器集群的自动化管理，降低运维复杂度，提升集群可用性与资源利用率。

核心功能与特性

1. 部署自动化

• 支持主流游戏服务器引擎（如Unity Dedicated Server、Unreal Engine Dedicated Server、Source Engine等）的一键部署
• 集成Kubernetes Deployment/StatefulSet资源，自动生成符合游戏服务器特性的部署配置
• 支持多版本游戏服务器并行部署与灰度更新

2. 弹性扩展

• 基于CPU、内存使用率的自动扩缩容
• 支持游戏内指标（如在线玩家数、房间负载）触发的自定义扩缩容策略
• 集成Kubernetes HPA（Horizontal Pod Autoscaler），实现负载感知的动态资源调整

3. 监控与告警

• 内置Prometheus指标采集器，暴露游戏服务器关键指标（延迟、帧率、玩家数、资源使用率等）
• 支持Grafana仪表盘集成，可视化集群状态与性能趋势
• 自定义告警规则配置（如高延迟、服务器崩溃、资源耗尽等场景）

4. 配置与运维管理

• 支持通过ConfigMap/Secret管理游戏服务器配置文件，实现动态配置更新
• 集成日志聚合（与ELK/EFK stack兼容），集中管理游戏服务器日志
• 自动化备份策略（游戏存档、配置文件定期备份至持久化存储）

5. 多环境适配

• 支持单机测试、开发环境与生产集群的环境隔离配置
• 兼容主流Kubernetes发行版（EKS、GKE、AKS、自建K8s集群）

使用场景

• 游戏工作室：管理多区域、多实例游戏服务器集群，保障高并发场景下的服务稳定性
• 独立开发者：简化单人/小团队的游戏服务器运维流程，专注游戏逻辑开发
• 大型多人在线游戏（MMO）：实现基于玩家负载的动态扩容，优化资源成本
• 竞技类游戏：保障低延迟要求下的服务器资源稳定分配，提升玩家体验

使用方法

环境要求

• Kubernetes集群：v1.21+
• Docker Engine：v20.10+
• 集群资源：至少2 CPU核心、4GB内存（生产环境建议8 CPU核心、16GB内存起）
• 存储：支持PVC的持久化存储（如NFS、Ceph、云厂商块存储）

镜像获取

bash
docker pull docker.xuanyuan.run/game-server-manager/k8s-controller:latest

Kubernetes部署示例

1. 基础部署（Deployment）

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: game-server-manager
  namespace: game-servers
spec:
  replicas: 1
  selector:
    matchLabels:
      app: game-server-manager
  template:
    metadata:
      labels:
        app: game-server-manager
    spec:
      containers:
      - name: manager
        image: docker.xuanyuan.run/game-server-manager/k8s-controller:latest
        ports:
        - containerPort: 8080  # 管理API端口
        env:
        - name: GAME_TYPE
          value: "unreal"  # 游戏引擎类型，支持unreal/unity/source等
        - name: NAMESPACE
          value: "game-servers"  # 游戏服务器部署命名空间
        - name: MONITORING_ENABLED
          value: "true"  # 是否启用监控（true/false）
        volumeMounts:
        - name: config-volume
          mountPath: /app/config
      volumes:
      - name: config-volume
        configMap:
          name: game-manager-config  # 挂载配置文件ConfigMap

2. 应用配置（ConfigMap示例）

yaml
apiVersion: v1
kind: ConfigMap
metadata:
  name: game-manager-config
  namespace: game-servers
data:
  server.properties: |
    max_players=100
    tick_rate=60
    log_level=info
  scaling-policy.yaml: |
    scale_up_threshold: 70  # 扩容阈值（CPU使用率百分比）
    scale_down_threshold: 30  # 缩容阈值（CPU使用率百分比）
    min_replicas: 2
    max_replicas: 10

环境变量说明

管理API使用

镜像内置REST API用于管理操作，默认监听8080端口，主要接口：

• GET /api/servers：获取当前管理的游戏服务器列表
• POST /api/servers/deploy：部署新的游戏服务器实例
• PUT /api/servers/{id}/scale：手动调整指定服务器的副本数
• GET /api/metrics：获取Prometheus格式的监控指标

注意事项

• 生产环境建议部署至少2个管理实例（通过Deployment replicas=2），确保高可用性
• 自定义游戏引擎需通过GAME_TYPE=custom并挂载对应配置文件
• 弹性扩缩容功能依赖Kubernetes Metrics Server或Prometheus Adapter（自定义指标场景）
• 持久化存储需提前配置，确保游戏存档、日志数据的持久化