跳至主要内容

Amazon GameLift Servers NodeJs 10 常见问题

Amazon GameLift Servers

一般性问题

全部打开

    Amazon GameLift Servers 将于 2026 年 9 月 30 日结束对 Node.js 10 的支持。在此日期之后,您将无法使用 Node.js 10 运行时脚本创建新的实例集。自 2026 年 10 月 1 日起,所有仍在使用 Node.js 10 脚本的活动实例集将被自动缩容至零实例并删除。游戏服务器将关闭,玩家将无法连接到您的游戏。

    Node.js 10 已到达生命周期终点,不再接收来自 Node.js 社区的安全更新、错误修复或技术支持。为了确保您的游戏服务器的安全性和可靠性,我们将终止对该过时运行时版本的支持。

    Node.js 24 引入了多项可能影响您脚本的变更,包括更新的 ECMAScript 标准支持、模块解析变更、已弃用 API 的移除、npm 版本更新及软件包兼容性要求、性能改进、增强的内存管理以及更新的安全协议。我们强烈建议您在迁移生产实例集之前,在开发环境中使用 Node.js 24 对脚本进行全面测试。请查阅 Node.js 发行说明,以获取版本间变更的完整详情。

    1.查看您的实例集。 确认是否存在使用 Node.js 10 运行的脚本创建的实例集。有关如何确定实例集是否使用 Node.js 10 的方法,请参阅常见问题 7。

    2.创建新脚本。创建并上传您现有的游戏服务器脚本,然后选择新的目标 NodeJsVersion(例如“24.x”表示 Node.js 24)。如果上传或启动脚本时出现错误,请按以下步骤操作:

    a.查看 AL2 和 AL2023 之间的变化。 有关 AL2023 以及 AL2 架构差异的更多信息,请参阅从 AL2 迁移到 AL2023 的指南

    b.查看 Node.js 版本之间的变更。 有关 Node.js 版本变更详情,请参阅 Node.js 发布说明

    c.更新您的游戏服务器脚本。对游戏服务器脚本进行必要的修改,使其与新的目标 Node.js 版本和操作系统兼容。有关集成游戏服务器脚本的更多信息,请参阅实时脚本游戏托管准备指南

    d.上传您的新脚本。 将新的游戏服务器脚本上传到 Amazon GameLift Servers。有关更多信息,请参阅上传 Amazon GameLift Servers 脚本

    3.使用新脚本创建测试实例集。 要创建新的测试实例集,请参阅为 Amazon GameLift Servers Realtime 创建托管 EC2 实例集。 我们建议采取此步骤来确保在初始化游戏服务器脚本和激活实例集时不会出错。

    4.查看实例集事件中是否存在错误。如果在创建实例集过程中出现错误,可以在实例集控制面板的“事件”选项卡上查找错误信息。有关排查常见实例集创建错误的指导,请参阅调试 Amazon GameLift Servers Realtime 托管 EC2 实例集

    5.(可选)更新您的游戏服务器脚本。如果在脚本或实例集创建过程中遇到错误,请修复并更新脚本,直至实例集成功激活且游戏服务器正常启动。请参阅更新您的实时脚本

    6.(可选)创建测试游戏会话。 测试实例集激活后,将后端服务设置为以您的新实例集为目标。我们建议您创建测试游戏会话来验证游戏客户端的连接性。有关游戏客户端集成的更多信息,请参阅集成游戏客户端

    7.将游戏服务器流量迁移到新的生产实例集。如果您的游戏已在生产环境中服务真实玩家流量,可使用 Amazon GameLift Servers 队列和别名将玩家从 Node.js 10 实例集迁移到新的 Node.js 24 实例集。有关更多信息,请参阅队列最佳实践

    不,您无需更新实时客户端 SDK。客户端 SDK 与 Node.js 10 和 Node.js 24 服务器端脚本兼容。但是,我们建议在升级后测试您的客户端与服务器的交互以确保兼容性。您可以从入门页面下载最新的实时客户端 SDK。

    会。您将通过多个渠道收到通知,包括发送到与您的 AWS 账户关联的电子邮件地址的电子邮件通知、包含受影响资源列表的 AWS Personal Health Dashboard 通知、查看受影响实例集或创建新实例集时的 Amazon GameLift Servers 控制台警告横幅和消息,以及在截止日期 2026 年 9 月 30 日之前的关键里程碑发送的提醒电子邮件。

    您可以通过多种方法识别受影响的实例集。在 AWS Personal Health Dashboard 中,导航到 AWS Personal Health Dashboard,查看 Node.js 10 终止支持通知,点击“受影响的资源”选项卡即可看到您的 Node.js 10 实例集列表。在 Amazon GameLift Servers 控制台中,导航至实例集页面,查找使用 Node.js 10 运行时脚本创建的实例集。您还可以在每个脚本资源的详情页中查看 Node.js 版本,以及使用该脚本创建的实例集。

    当满足以下条件时,即表示您已成功迁移:所有活动实例集均使用 Node.js 24 运行时的脚本;Personal Health Dashboard 中不再显示 Node.js 10 停止支持的相关通知;实例集运行时配置显示为 Node.js 24 和 Amazon Linux 2023;创建新实例集时不再收到 Node.js 10 弃用警告。如果符合以上条件,则无需进一步操作,您可以放心忽略后续关于 Node.js 10 停止支持的通知。

    会。Node.js 10 停止支持适用于 Amazon GameLift Servers 提供服务的所有 AWS 区域,包括标准 AWS 区域和中国区域(北京和宁夏)。各区域的时间表和要求都相同。

    不可以。为了帮助 Amazon GameLift Servers 客户维护安全的游戏服务器运行环境,我们要求所有客户在 2026 年 9 月 30 日停止支持日期前完成向 Node.js 24 的迁移。

    会。Amazon GameLift Servers 将在 2026 年 9 月 30 日之后缩减并终止在 Node.js 10 上运行的任何剩余活动实例集。