Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

欢迎来到的入门教程。Amazon GameLift Servers在本教程中，您将快速部署游戏服务器以托管在基于云的计算资源队列上。使用本教程可以跳过将服务器 SDK 集成Amazon GameLift Servers到游戏代码中的工作，而是使用最少的功能来部署游戏，以便与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
            

成功构建后，会向中添加一个 “out” 目录amazon-gamelift-servers-game-server-wrapper。此目录中有三个文件夹，每个文件夹对应一个支持的托管队列选项，其中包含一组构建工件。在本教程中，您将部署到托管 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上传游戏版本的最快方法是使用 Amazon 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_2016 \
    --server-sdk-version 5.3.0 \
    --region us-west-2
        

创建版本时，记录 API 响应中的构建 ID 以将其用于队列创建。

步骤 5：创建托管 EC2 舰队

以下步骤描述了最小的队列配置，因此您可以尽快启动并运行。

要创建您的舰队，请执行以下操作：

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

当您的舰队状态显示为 “活动” 时，这意味着游戏服务器已准备就绪，正在等待托管游戏会话。要开始游戏会话，请向Amazon GameLift Servers服务提出游戏会话请求。在这里，您将使用 Amazon 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
        

您也可以将自定义的游戏属性传递给服务器可执行文件。详情请参阅自述文件中的游戏服务器参数。当它接到 create-game-session呼叫时，会Amazon GameLift Servers通知包装器启动游戏服务器可执行文件并启动游戏会话。里面的内容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 步：扩展游戏服务器

在下一步中，您将设置自动缩放。借助 auto scaling，您可以根据游戏服务器活动动态扩展舰队容量。当玩家到达并开始游戏会话时，auto Scaling 会添加更多实例，而随着玩家需求的减少，auto scaling 会释放未使用的实例。这是一种有效的方法，可以最大限度地减少托管资源和成本，同时还能提供流畅、快速的玩家体验。

在为游戏发布做准备时，您需要为队列设置自动缩放。建议将自动缩放作为最大限度地减少托管资源和成本的有效方法，同时还能提供流畅、快速的玩家体验。

手动设置车队容量

手动设置车队容量

使用基于目标的 auto 缩放

使用基于目标的 auto 缩放

基于目标的自动缩放（目标跟踪）将舰队缩放与可用游戏会话的百分比联系起来。当玩家激增玩你的游戏并且可用游戏会话减少时，它会通过自动向队列添加更多实例来做出响应。

基于规则的 auto Scaling 可为您提供更精细的控制，例如能够将扩展与其他队列指标关联起来，并设置自定义阈值和扩展响应。它提供了强大的选项，但它还需要使用 CLI 和大量测试来了解自定义规则的实际运行情况。本教程重点介绍如何首先设置基于目标的方法。

常见问题故障排除

以下是您在运行游戏服务器和游戏会话时可能遇到的常见问题。当服务器或游戏会话无法正常运行时，第一步是检查日志，这些日志可能会发现新部署或生产中的游戏存在以下问题之一。

日志中经常显示以下内容：

查看您的Amazon GameLift Servers舰队的事件日志

查看您的Amazon GameLift Servers舰队的事件日志

查看游戏会话日志

查看游戏会话日志

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

您还可以为您的舰队配置 Amazon CloudWatch 日志。这提供了额外的日志记录功能以及与其他 Amazon 监控服务的集成。

通过 CloudWatch以下方式实时访问日志或延长保留期：

后续步骤