跳到主要内容
快速开始

本页尚未翻译,当前显示英文版本。

Environment

Environment 是 Project 后端的一份完全独立的副本。 每个 Environment 都有自己的数据、Schema、商品目录、Function、secret、Player 和 API key,因此在 dev 中的工作永远不会影响 prod。每个 Project 一开始都有 dev 和 prod;需要更多阶段时(例如 staging),随时可以添加。

Environment 也是 PlayServ 为数据做版本管理的方式:没有单独的版本功能。要保留某个版本的数据和内容,就复制 Environment;要安全地尝试某项改动,先在副本中进行。


切换 Environment

顶栏的 Environment 选择器决定了 Backoffice 大部分页面显示的内容:Data、Functions、Servers、Game Rooms、API keys 等都会跟随它切换。Environment 列表会显示各自的状态,只有 Ready 的 Environment 才能选中。

在 Backoffice 之外同样如此:一个 API key 只属于一个 Environment,CLI 在其登录所用 key 的 Environment 中工作。


创建 Environment

从顶栏的 Environment 菜单,或 Project 设置 的 Environments 标签页中打开 New environment。

字段规则
Name2–16 个字符:小写字母、数字和单个短横线,以字母开头。在 Project 内唯一。
Copy from another environment不勾选则创建空 Environment;勾选并选择一个 Ready 的源 Environment,则以其副本为起点。

空 Environment 几乎立即就绪。副本在后台创建,其状态显示复制进度。

状态含义
Creating… · Copying…正在设置,暂时无法选中或删除。
Ready可以使用。
Error复制失败;已复制的内容会被清理。
Deleting… · Deleted正在删除或已删除,参见 下文。

副本包含什么

副本带走的是 Project 的内容,而不是其中的人和历史。

会复制不会复制
数据 RecordPlayer 及其 Session
SchemaAnalytics Event 历史
商品目录和商店已吊销的 key
Secret允许部署新代码的关联(见下文)
活跃的 API key,使用新的密钥
Function,基于当前 build 重新部署

复制出的 key 带有无人见过的新密钥

每个活跃 key 都会保留名称和类型,但会获得一个从不显示的新密钥。要在新 Environment 中使用它,请 轮换该 key,得到一个可以保存的密钥。

副本从正在运行的源 Environment 中逐部分读取,因此复制期间对源 Environment 的修改可能包含在内,也可能不包含。如果需要完全一致的副本,请选择没有改动的时段复制。源 Environment 中从未部署过的 Function 会被跳过,没有值的 secret 绑定不会挂载;这两类情况都会列在该 Environment 的行中。

向副本发布代码之前,先重新关联部署。 复制出的 Environment 一开始禁止部署新代码。它的行会标记为 Deploys unlinked,在你点击 Environments 标签页中的 Re-link deploys 之前,部署都会以 env_not_linked 失败。在此期间,从源 Environment 复制来的 Function 会照常运行。

这是有意为之:副本不会接管源 Environment 的 分支绑定,并且在重新关联之前无法绑定到分支,因此原本要发布到源 Environment 的代码永远不会意外落到副本中。


删除与恢复 Environment

在 Environments 标签页中从对应行删除 Environment,并输入其名称确认。它的 key 会停止认证,Function 停止运行,数据、Schema 和商品目录都将无法访问。

你有 十秒钟可以撤销。之后,Environment 会移到 Deleted environments,数据会一直保留,直到有人处理:

操作谁可以执行结果
Restore所有者或组织管理员Environment 恢复原样。
Erase仅所有者数据被永久删除。

以下情况无法删除 Environment:它仍在创建中、正有其他 Environment 从它复制,或者它是 Project 的最后一个 Environment。


后续步骤

更新于 2026年10月15日