https://yafeiaa.github.io/tags/kubernetes/ Recent content in Kubernetes on yafeiaa Blogs Hugo en-us Wed, 14 Jan 2026 00:00:00 +0000 https://yafeiaa.github.io/posts/agones%E4%BD%93%E9%AA%8C/ Wed, 14 Jan 2026 00:00:00 +0000 https://yafeiaa.github.io/posts/agones%E4%BD%93%E9%AA%8C/ <h2 id="前言">前言</h2> <p>Agones 通过 SDK-Server 让 GameServer 自己管理生命周期状态。每个 GameServer 启动时会连接本地的 SDK Server，通过 gRPC API 同步状态。</p> <p>在实际部署时，sdk-server 会作为一个 sidecar 容器，和 gameserver 容器共享 network namespace，所以 gmaeserver 可以直接以 localhost 访问 sdk-server 的 api。</p> <p>sdk-server 作为 agones 和 gameserver 之间的状态同步器，负责将 gameserver 的状态同步给 agones，以及将 agones 的分配请求同步给 gameserver。</p> <h2 id="allocator-service">Allocator Service</h2> <p>Allocator 是 Agones 提供的 gRPC 服务，用于分配 GameServer。它监听集群中所有 Ready 状态的 GameServer，当收到分配请求时，选择一个合适的 GameServer 并将其状态改为 Allocated。</p> <p>Allocator 提供了两种分配方式：</p> <ol> <li><strong>gRPC Service</strong> - 直接调用 gRPC API（适合高性能、安全性要求高的场景，通过mtls认证）</li> <li><strong>Allocation API</strong> - 通过 Kubernetes CRD <code>GameServerAllocation</code>（更简单，通过k8s api调用）</li> </ol> <h2 id="核心-api">核心 API</h2> <ul> <li><strong>Ready()</strong> - 标记就绪，可以被分配</li> <li><strong>Health()</strong> - 发送心跳，保持健康状态</li> <li><strong>Shutdown()</strong> - 通知关闭</li> <li><strong>SetAnnotation()</strong> - 设置自定义信息（如 自定义的对外访问地址）</li> <li><strong>WatchGameServer()</strong> - 监听状态变化</li> </ul> <h2 id="状态流转">状态流转</h2> <pre tabindex="0"><code>Port -&gt; Ready -&gt; Allocated -&gt; Shutdown </code></pre><ol> <li><strong>Port</strong> - 刚启动，等待 Ready</li> <li><strong>Ready</strong> - 调用 <code>Ready()</code> 后进入，等待分配</li> <li><strong>Allocated</strong> - 被 match-maker 分配后进入，开始游戏逻辑</li> <li><strong>Shutdown</strong> - 调用 <code>Shutdown()</code> 或收到关闭信号后进入</li> </ol> <h2 id="一个dedicate-server和-match-maker通过-sdk-server-和-allocator-交互的例子">一个dedicate-server和 match-maker通过 sdk-server 和 allocator 交互的例子</h2> <h3 id="dedicate-server">dedicate-server</h3> <p>启动流程：</p>