教程：使用 Amazon GameLift Servers 封装器快速入门

欢迎使用 Amazon GameLift Servers 的入门教程。在本教程中，您将快速部署游戏服务器，使其托管于基于云的计算资源实例集上。通过本教程，您无需将 Amazon GameLift Servers 的服务器 SDK 集成到游戏代码中，而是直接部署具备基本功能的游戏，使其能够与 Amazon GameLift Servers 服务通信并运行游戏会话。您将搭建基础托管解决方案，并通过该解决方案体验自动扩展、对战系统等全套功能。此解决方案同样适用于托管游戏原型，可用于现场演示或测试场景。

这种入门方法的核心优势：

先决条件

在开始之前，请确保您满足以下条件：

概览

本教程将引导您完成以下操作：

第 1 步：获取并构建游戏服务器封装器

使用以下命令获取游戏服务器封装器源代码并构建封装器。这些命令基于 SSH 执行，您也可直接访问 GitHub 存储库完成操作。

Windows

> git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
> cd amazon-gamelift-servers-game-server-wrapper
> powershell -file .\build.ps1
            

Mac 和 Linux

$ git clone git@github.com:amazon-gamelift/amazon-gamelift-servers-game-server-wrapper.git
$ cd amazon-gamelift-servers-game-server-wrapper
$ make
            

构建成功后，amazon-gamelift-servers-game-server-wrapper 目录下会新增一个“out”目录。该目录有三个文件夹，分别对应三种受支持的托管实例集选项，其中均包含一组构建构件。在本教程中，您将部署至托管式 EC2 实例集，因此需使用 gamelift-servers-managed-ec2 文件夹。

第 2 步：准备游戏服务器生成包

在此步骤中，您将准备要上传到 Amazon GameLift Servers 的游戏服务器生成包文件。

创建游戏目录

现在，在本地计算机上准备一个游戏目录。该目录需包含通过 Amazon GameLift Servers 运行游戏服务器所需的全部文件，包括游戏服务器封装器、游戏服务器生成包，以及使封装器与游戏服务器搭配运行的 config.yaml 配置文件。

使用以下步骤：

示例目录结构如下所示：

gamelift-servers-managed-ec2
│-- config.yaml
│-- amazon-gamelift-servers-game-server-wrapper
│-- MyGame
│   │-- server-executable.exe
│   │-- my-game-settings
│   │ ......
            

第 3 步：为实例集配置封装器

Amazon GameLift Servers 会管理实例集的计算实例生命周期，启动已安装您的服务器生成包的新实例，并根据需要回收实例。该服务同时管理每个实例上运行的游戏服务器进程生命周期。托管式 EC2 实例集可在多个位置部署实例，确保为全球各地的玩家提供服务支持。

编辑 config.yaml 文件以配置封装器的日志、端口设置及服务器初始化相关参数。

示例配置：

log-config:
  wrapper-log-level: debug
game-server-logs-dir: ./game-server-logs
ports:
  gamePort: 37016
game-server-details:
  executable-file-path: ./MyGame/my-server-executable
game-server-args:
  - arg: "--port"
    val: "{{.gameport}}"
    pos: 0
        

第 4 步：上传游戏服务器生成包

您现已完成游戏服务器生成包的全部必要配置（含游戏服务器封装器、config.yaml 配置文件及游戏服务器文件），可将该游戏生成包上传至 Amazon GameLift Servers 进行托管。上传游戏生成包的最快上传方式是使用 AWS CLI 命令 upload-build，如以下示例所示。

通过 Windows 上传游戏生成包：

aws gamelift upload-build \
    --name gamelift-test-2025-03-11-1 \
    --build-version gamelift-test-2025-03-11-1 \
    --build-root out/windows/amd64/gamelift-servers-managed-ec2 \
    --operating-system WINDOWS_2022 \
    --server-sdk-version 5.3.0 \
    --region us-west-2
        

创建生成包时，请记录 API 响应中的生成包 ID 以将其用于实例集创建。

第 5 步：创建托管式 EC2 实例集

以下步骤描述了最小化实例集配置流程，帮助您快速启动并运行实例集。

创建实例集：

第 6 步：创建游戏会话并连接

当实例集状态显示为活跃时，表明游戏服务器已准备就绪，可等待托管游戏会话。要启动游戏会话，需向 Amazon GameLift Servers 服务发起游戏会话请求。本教程将使用 AWS CLI 执行该请求操作。

使用以下命令创建游戏会话：

aws gamelift create-game-session \
--fleet-id <FLEET_ID> \
--game-properties '[{"Key": "exampleProperty", "Value": "exampleValue"}]' \
--maximum-player-session-count 3 \
--region us-west-2
        

您也可向服务器可执行文件传递自定义游戏属性。有关详细信息，请参阅自述文件中的“游戏服务器参数”部分。当 Amazon GameLift Servers 接收到 create-game-session 调用时，会通知封装器启动游戏服务器可执行文件并创建游戏会话。其中，config.yaml 中的配置影响游戏服务器的配置，而控制台中设置的启动参数则决定游戏会话本身的配置。

添加游戏属性的格式示例：

defaultArgs:
        - arg: "--port"
          val: "{{.GamePort}}"
          pos: 0
        - arg: "--ipAddress"
          val: "{{.IpAddress}}"
          pos: 1
        - arg: "--gameSessionId"
          val: "{{.GameSessionId}}"
          pos: 2
        

第 7 步：管理和监控实例集

您的游戏服务器实例集已配置完成且游戏会话已启动，您可通过 Amazon GameLift Servers 控制台对其进行管理和监控。最优操作方式是访问实例集详细信息页面，您可以在其中编辑实例集详细信息或在扩展选项卡上更改实例集扩展和容量。有关如何扩展游戏服务器，请参阅以下部分。

选择指标选项卡可查看描述监控活动指标和硬件指标的图表。有关指标图表的详细信息，请选择您的实例集 ID 旁边的信息链接。此外，您不仅可通过指标选项卡密切监控游戏服务器，还可在 CloudWatch 控制面板中为这些指标添加警报。

要从控制台导航到 CloudWatch 控制面板，请执行以下操作：

第 8 步：扩展游戏服务器

下一步将设置自动扩缩。通过自动扩缩，实例集容量会根据游戏服务器的活动负载动态调整。当玩家加入并创建游戏会话时，自动扩缩会新增实例；当玩家需求减少时，自动扩缩会释放闲置实例。这是一种高效的优化方案，可在保障玩家流畅快速体验的前提下，最大程度地降低托管资源消耗和成本。

在游戏启动前，建议为实例集配置自动扩缩。自动扩缩是一种推荐的高效优化方案，可在保障玩家流畅快速体验的前提下，最大程度地降低托管资源消耗和成本。

手动设置实例集容量

手动设置实例集容量

使用基于目标的自动扩缩

使用基于目标的自动扩缩

基于目标的自动扩缩（目标跟踪模式）将实例集扩展与可用游戏会话百分比关联。当玩家流量激增导致可用游戏会话减少时，系统会自动为实例集新增实例以应对需求。

基于规则的自动扩缩提供更精细的控制能力，例如能够将扩展与其他实例集指标关联起来，并设置自定义阈值和扩展响应。它提供功能强大的选项，但需使用 CLI 配置且需经过充分测试，以验证自定义规则的实际运行效果。本教程重点介绍如何首先设置基于目标的策略。

常见问题故障排除

以下是游戏服务器及游戏会话部署运行过程中可能遇到的常见问题。如果服务器或游戏会话运行异常，第一步是检查日志，日志内容可能会揭示新部署项目或生产环境游戏中出现的以下问题之一。

日志中常见问题及排查方向如下：

查看 Amazon GameLift Servers 实例集的事件日志

查看 Amazon GameLift Servers 实例集的事件日志

查看游戏会话日志

查看游戏会话日志

要通过 CLI 查看游戏会话日志，请使用 GetGameSessionLogURL API。Amazon GameLift Servers 会自动将日志存储 14 天。

您还可以为实例集配置 Amazon CloudWatch Logs。这提供了更多日志功能，并可与其他 AWS 监控服务集成。

要通过 CloudWatch 进行实时日志访问或延长保留期，请执行以下操作：

后续步骤