本页尚未翻译,当前显示英文版本。
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。
| 字段 | 规则 |
|---|---|
| Name | 2–16 个字符:小写字母、数字和单个短横线,以字母开头。在 Project 内唯一。 |
| Copy from another environment | 不勾选则创建空 Environment;勾选并选择一个 Ready 的源 Environment,则以其副本为起点。 |
空 Environment 几乎立即就绪。副本在后台创建,其状态显示复制进度。
| 状态 | 含义 |
|---|---|
| Creating… · Copying… | 正在设置,暂时无法选中或删除。 |
| Ready | 可以使用。 |
| Error | 复制失败;已复制的内容会被清理。 |
| Deleting… · Deleted | 正在删除或已删除,参见 下文。 |
副本包含什么
副本带走的是 Project 的内容,而不是其中的人和历史。
| 会复制 | 不会复制 |
|---|---|
| 数据 Record | Player 及其 Session |
| Schema | Analytics 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。
后续步骤
- API key 管理 —— 每个 Environment 的 key
- 使用 CLI 部署 —— 把 Function 和 Game server 发布到某个 Environment
- 创建新 Project —— Project 设置、slug 和删除 Project
更新于 2026年10月15日