Skip to main content
借助此新功能,游戏开发人员可以安全地上传、列出、更新和使用游戏服务器上的机密,例如检测密钥和密钥。

如何使用机密管理功能

要有效地管理和使用机密,推荐的工作流程包括:
  1. 添加机密(可以对多个机密重复执行此步骤)
  2. 在创建新构建时按名称引用机密
  3. 从游戏服务器访问机密
  4. 根据需要更新机密

添加机密

可以通过 UploadSecret API 添加机密。 此 API 允许将新机密上传到服务,或通过将 ForceUpdate 参数设置为 true 来更新现有机密。

部署机密

要在新创建的 VM 中部署机密,请在 CreateBuild API 中使用 GameSecretReferences 参数将机密包含在构建中(适用于基于容器和基于进程的部署)。
创建构建后,无法向其添加新机密;但是,更新现有机密将允许在新 VM 中使用其更新后的值(现有 VM 将保留原始值)。
以下是引用机密的示例:

访问机密

在新构建中添加并引用机密后,游戏服务器可以通过每个游戏服务器内的环境变量访问这些机密值,无论是基于容器还是基于进程的服务器。 环境变量的命名约定为:

删除机密

要删除旧机密,请使用 DeleteSecret API。 在尝试删除机密之前,请确保任何构建中都未使用该机密,否则删除将不会成功。

在 VM 启动脚本中使用机密

VM 启动脚本可以通过引用如上所述的环境变量来使用机密值。例如,这使得在启动任何游戏服务器之前使用遥测密钥或其他必要值成为可能。

另请参阅

最后修改于 2026年8月25日