# 环境创建和管理

## 环境使用限制

- 微信云托管中环境是所有资源的依托，使用云托管必须先创建环境；
- 环境之间所有资源都互相隔离，环境内资源之间可以通过内网调用；
- 不同环境的资源之间只能使用公网调用；
- 单个环境下，总实例数量最大支持 28 个实例个数，也不可特殊申请；
- 单个环境下所有服务的 QPS（每秒并发请求数）最大为 500，超出可工单「云托管控制台-帮助-提交工单」特殊申请；

## 环境用法推荐

- 用法一：根据用途区分环境，如区分为测试环境、预发环境、生产环境等。
  - 可根据实际用途配置不同级别的告警策略。例如生产环境告警条件更细致严格。
  - 独立控制各环境的资源消耗、费用与预算。例如测试环境可以采用更小规格或更少数量的实例。
- 用法二：根据不同项目区分环境。如 SaaS 类业务可以为不同用户分配对应的独立环境，或每个小程序后端对应一个环境。
  - 使不同用户/项目的服务间逻辑隔离互不影响。
  - 每个用户/项目实际使用资源基于不同环境分别计费。

## 环境计费

- 不同环境独立计费并出账单；
- 不同环境无法共享资源包；
- 账号欠费时，所有环境都将被冻结，欠费超过 7 天，所有环境都将被删除，无法恢复。

## 环境配额

目前一个「小程序/公众号」账号最多支持创建 3 个微信云托管环境，仅第 1 个环境带有 3 个月免费额度。

## 创建环境

环境创建有以下几种情况：

### 首次创建环境

访问[微信云托管控制台](https://cloud.weixin.qq.com/cloudrun/)，用微信扫描网页上的登录二维码，进入控制台

进入控制台之前，会提示要求你选择「小程序/公众号」，如果你选择的「小程序/公众号」没有微信云托管环境，则会进入[无门槛部署流程](/minigame/dev/wxcloudrun/src/quickstart/template/index)。

> **如何选择「小程序/公众号」？**

> 微信云托管环境是建立在腾讯云账号上的，基于选择的「小程序/公众号」，复用其主体信息，建立腾讯云账号。如果你选择的「小程序/公众号」是企业主体，则腾讯云账号就是对应的企业主体，个人主体同理。

> 如果你之前在某个「小程序/公众号」中开通过云开发，则会与其共用一个腾讯云账号，不支持更换使用其他腾讯云账号。所以在这种情况下，可以实现微信云托管的资源和云开发的资源在内网联通（前提是要配置相同的 VPC）

你也可以选择使用自定义方式创建环境，具体操作如下：

![](https://res8.wxqcloud.qq.com.cn/wxdoc/abc9e3a4-5446-4e64-9a66-ed68ee54e30c.gif)

微信云托管会在你填写的「环境名称」后面追加一串字符组成环境 ID。并且在创建环境后默认创建一个服务，服务名称遵从你填写的服务名称。

自定义创建环境时，出现的字段解释如下：

- 环境名称：用作识别环境，建议按照环境属性进行命名，默认提供「prod」；
- 服务名称：创建环境后用于新建服务的命名，如你填写「test」，则环境创建后会有一个「test」名字的服务，你可以部署使用，也可以删除。服务名称不支持修改。
- 网络类型：如小程序已绑定腾讯云账号且该账号下已有上海地域的 VPC（微信云托管底层资源地域部署在上海），则创建环境内容字段将显示「网络类型」字段，支持选择自己已创建的上海地域的 VPC；如不使用可选择系统创建，后台会在该环境下自动创建一个 VPC 并配置一个微小型 NAT 网关。否则，不显示「网络类型」字段，统一由系统创建；（以下就是没有 VPC 的情况）
- 环境配额：环境计费项及其单价；具体见下文。
- 如当前小程序未开通/使用过「云开发」，首次创建环境时会同时给该小程序创建一个腾讯云账号（微信云托管底层资源均由腾讯云提供），如已有腾讯云账号且该腾讯云账号未绑定过小程序，可点击下方「绑定腾讯云账号」扫码授权绑定即可，自行绑定后，微信云托管不会再给当前小程序创建腾讯云账号。一个腾讯云账号支持绑定多个小程序。
- 如当前小程序已开通/使用过「云开发」，则微信云托管将继续使用该小程序已绑定的腾讯云账号，不会再额外创建；

环境创建成功后，网络 VPC 可在「设置-环境设置」中查看。

![](https://res8.wxqcloud.qq.com.cn/wxdoc/2873db4b-e6dd-40b0-8a2d-4c073cc0fbec.png)

### 非首次创建环境

当你已经存在一个或多个环境后，你想再创建新的环境，则按照如下步骤进行创建。

点击控制台右上角悬浮 TAB 中「环境」，下拉框中除了显示当前账号所有云托管环境外，在下方会显示「创建新环境」蓝色链接按钮，点击「创建新环境」，即进入环境创建页面。

![](https://res8.wxqcloud.qq.com.cn/wxdoc/c84f4328-00ab-40d6-9662-c8de7338ec5d.png)

由于在此之前已经存在微信云托管环境，或腾讯云账号中存在已有的 `vpc` ，则在创建页面中会显示「网络类型」字段，可以按照自身需求选择创建新的 VPC 还是和其他资源共同使用同一个 `vpc`

**2022 年 7 月后创建的环境，由于架构升级不再显示 VPC 信息**

关于 `vpc` 的更多知识，请参考[腾讯云 vpc 文档](https://cloud.tencent.com/document/product/215)

## 切换环境

当你存在多个环境后，想要在环境间切换，则按照如下步骤进行：

点击控制台右上角悬浮 TAB 中「环境」，下拉框中显示当前账号所有云托管环境，点击对应的环境就可完成切换。

## 环境删除

当你想要删除一个环境时，按照如下步骤进行：

点击控制台右上角悬浮 TAB 中「环境」，下拉框底部显示「管理我的环境」蓝色链接按钮，点击「管理我的环境」，即弹出右侧抽屉，包含账号下环境列表。

点击想要删除的环境后面的「删除」按钮，在弹出框中点击确认，开始删除过程

由于环境删除属危险操作，需「小程序/公众号」管理员扫码确认后方可删除。

![](https://res8.wxqcloud.qq.com.cn/wxdoc/a92dd44a-c5f0-4546-9957-3c30dc27871d.png)

> 注意事项：

> 1. 环境删除后，环境内所有资源将被释放，不可恢复，**请谨慎操作；**

> 2. 有免费额度的环境，无论免费额度是否用完，删除后，后续再次创建的环境不会再有免费额度。

## 环境冻结

如微信云托管环境在 30 天内未产生任何请求调用，则该环境将会被冻结，统计时长自本规则实行日期（2024 年 4 月 1 日）开始。云托管环境冻结后，云服务资源将无法使用，线上业务停服。

## 环境恢复

如云托管环境冻结后仍需使用这个环境，请前往微信云托管控制台进行恢复，恢复后将与冻结前的环境配置保持一致。云托管环境冻结时间超过 180 天，系统将自动销毁并删除环境，且不支持恢复。当前云托管环境已被冻结的，本规则生效日期（2024 年 4 月 1 日）起内的 180 天，依然可对环境进行恢复。

## 环境销毁

如云托管环境冻结时间超过 180 天，系统将自动销毁并删除该环境。销毁后该环境下所有云资源将被释放、环境参数将会清除、数据库信息将被删除，且无法恢复。如当前云托管环境已被冻结，为及时进行环境恢复，系统将按照本规则生效日期（2024 年 4 月 1 日）起的 180 天后进行销毁。
