You need to enable JavaScript to run this app.
导航
文档数据库 MongoDB 版
  • 文档首页
    • /文档数据库 MongoDB 版/快速入门/创建实例
创建实例
最近更新时间：2024.12.04 11:35:43首次发布时间：2022.01.11 15:50:29
我的收藏

创建实例是开始使用文档数据库 MongoDB 版的第一步，本文介绍如何创建 MongoDB 实例。

前提条件

  • 已注册火山引擎账号，并完成实名认证。账号注册和实名认证的方法，请参见如何进行账号注册和实名认证。
  • 已完成跨服务访问授权以允许 MongoDB 访问其他服务（如 VPC、EIP 等）。具体操作步骤，请参见跨服务访问授权。

操作步骤

  1. 登录 MongoDB 控制台。

  2. 在顶部菜单栏的左上角，选择实例所属的项目和地域。

  3. 根据实例类型，在左侧导航栏中选择副本集实例列表或分片集实例列表。

  4. 在目标实例类型列表页，单击创建实例。

  5. 在创建实例页，设置如下参数。

    参数
    说明

    基本信息

    实例名称

    输入实例名称，选填。名称需同时满足如下要求：

    • 不能以数字、中划线（-）开头。
    • 只能包含中文、字母、数字、下划线（_）和中划线（-）。
    • 长度需为 2~64 个字符。

    说明

    • 若该参数不填，实例 ID 默认作为实例名称。
    • 您可以根据需要自定义实例名称，实例名称无唯一性要求。

    数据库版本

    选择数据库版本。支持的取值范围如下：

    • MongoDB 4.0
    • MongoDB 4.2
    • MongoDB 4.4
    • MongoDB 5.0
    • MongoDB 6.0

    关于 MongoDB 版本的更多详情，请参见版本介绍。

    实例类型

    选择 MongoDB 的实例类型，您可以选择副本集或分片集群。
    关于实例类型的更多信息，请参见产品架构。

    部署方式

    您可以根据业务需要选择单可用区部署或多可用区部署，其中：

    • 设置单可用区部署
      1. 选择部署方案为单可用区部署。
      2. 从可用区右侧选择需要的可用区，并根据业务需要选择是否添加只读节点。
    • 设置多可用区部署
      1. 选择部署方案为多可用区部署。
      2. 从可用区下拉列表中，分别为主节点和各从节点设置需要的可用区，并根据业务需要选择是否添加只读节点。

    说明

    • 当前仅副本集实例和分片集群实例中 Shard 分片支持添加只读节点。
    • 每个实例（或每个 Shard 分片）最多可添加 5 个只读节点。更多关于只读节点的功能介绍和使用限制，请参见 MongoDB 只读节点。
    • 实例所在地域需要支持 3 个及以上的可用区资源才支持选择多可用区部署方式。
    • 跨可用区部署可提高可用性，同时可能会出现 2~3ms 的网络延迟。关于多可用区部署的更多信息，请参见多可用区同城容灾解决方案。

    实例配置

    若实例类型为副本集，需要设置如下配置：

    • 节点规格：选择副本集实例的规格。更多详情，请参见计算节点规格。
    • 节点数：当前每个副本集实例固定支持 3 个节点，无需选择。
    • 存储空间：选择实例的存储空间，单位：GiB，步长为 10。 节点规格不同，对应支持的存储空间上限也不同，存储空间的具体取值范围请以控制台为准。

    若选择实例类型为分片集群，需要对 Mongos、Shard 和 ConfigServer 组件进行配置：

    • Mongos：
      • 节点规格：选择分片集群中 Mongos 的节点规格。更多详情，请参见计算节点规格。
      • 节点数量：选择 Mongos 节点的数量，取值范围：2~32。
    • Shard：
      • 分片数：选择分片集群中 Shard 分片数，取值范围：2~32。
      • 分片节点数：每个 Shard 默认为三副本集架构，即每个分片中均包含 3 个节点，无需选择。
      • 节点规格：选择 Shard 分片的节点规格，每个分片中的每个节点规格一致。更多详情，请参见计算节点规格。
      • 存储空间：选择 Shard 的存储空间，单位：GiB，步长为 10。 节点规格不同，对应支持的存储空间上限也不同，存储空间的具体取值范围请以控制台为准。
    • ConfigServer：
      • 节点规格：选择 ConfigServer 的节点规格，更多详情，请参见计算节点规格。
      • 存储空间：选择 ConfigServer 的存储空间，单位：GiB，步长为 10。 节点规格不同，对应支持的存储空间上限也不同，存储空间的具体取值范围请以控制台为准。
    规格预览查看并确认已选择的规格性能详情，包括节点规格、节点数、存储空间等。

    密码设置

    设置密码

    设置实例的默认账号（即 root 账号）密码。您可以选择立即设置或稍后设置实例的账号密码。

    • 若选择立即设置，您需要输入实例密码并确认密码。密码需满足如下条件：
      • 只能为大小写字母、数字及以下特殊字符 _#!@$%^&*()+=-。
      • 长度为 8~32 个字符。
      • 至少包含大写字母、小写字母、数字或特殊字符中的 3 种。
    • 若选择稍后设置，您可以在实例创建后再为 root 账号设置密码，密码设置方法，请参见重置密码。您还可以根据业务需要设置新的账号和密码。具体方法，请参见创建账号。

    网络配置

    私有网络

    从下拉列表中选择实例所在的私有网络。
    建议 MongoDB 实例与需要连接的 ECS 实例在同一私有网络，否则它们无法通过内网互通来实现最佳性能。更多关于私有网络和子网的信息，请参见什么是私有网络。

    说明

    • 若您还未创建任何私有网络，请先单击下拉列表右侧的创建私有网络，具体操作步骤，请参见创建私有网络。
    • 实例创建成功后，私有网络不可更改。
    • 当使用子账号登录控制台时，仅能看到该子账号所属项目下的私有网络信息。若您看不到目标私有网络，请确认是否使用了子账号，以及该子账号是否具备目标项目资源的权限。

    子网

    从下拉列表中选择当前私有网络中可使用的子网。
    子网是私有网络内的 IP 地址块。私有网络中的所有云资源都必须部署在子网内，子网为云资源分配私网 IP 地址。

    说明

    • 若您还未创建任何子网，请先单击下拉列表右侧的创建子网，具体操作步骤，请参见创建子网。
    • 子网具有可用区属性，下拉列表中仅展示当前私有网络中和实例属于同一可用区下的子网。
    • 创建私有网络时可指定项目，但创建子网时不支持指定项目，子网默认与与所属 VPC 在同一项目下。VPC 和子网的项目变更具有独立性，即修改 VPC 所属项目并不会同时修改当前 VPC 下子网的所属项目。更多详情，请参见私有网络项目管理。
    • 若修改了 VPC 所属项目，您还需要将 VPC 下的子网项目也进行相应变更，保证两者所属项目的一致性，否则非全局权限子用户创建云资源（如文档数据库 MongoDB 版）时将无法选择子网或出现异常报错。修改所属项目的具体操作步骤，请参见 项目资源管理。

    白名单

    参考如下操作步骤将新建实例加入新白名单或已有的白名单中：

    1. 单击白名单组输入框。
    2. 在弹出的控制面板中，根据选择的绑定模式，完成后续操作。
      • 若选择了新白名单（即创建一个新的白名单，并自动绑定至当前实例）您需要：
        1. 从所属项目下拉列表中，为新建白名单选择需要加入的项目，默认会加入 default 项目。
        2. 输入新的白名单名称、描述（选填）和 IP 地址。
        3. 单击确定。
      • 若选择了已有白名单（即绑定已有白名单至当前实例），您需要：
        1. 在已有白名单列表中勾选需要绑定的白名单。
        2. 单击确定。

    说明

    • 关于创建白名单时的名称、描述和 IP 地址配置的更多说明，请参见创建白名单。
    • 您可以在已有白名单列表中同时勾选多个白名单进行批量绑定。
    • 若通过子用户使用 MongoDB 云服务，您只能看到已为当前子用户授权项目下的白名单信息。更多详情，请参见通过子用户使用 MongoDB 云服务。
    • 每个实例最多支持绑定 100 个白名单，每次可最多批量绑定 100 个白名单。

    高级配置

    所属项目

    根据业务需要设置实例所属的项目。
    项目是一个虚拟的概念，包括一组资源、用户和角色。通过项目可以对一组资源进行统一的查看和管理，并且控制项目内用户和角色对这些资源的权限。更多详情，请参见资源管理。
    根据您在 MongoDB 控制台左上角已选择的项目，执行对应的操作：

    • 若您选择的是账号全部资源，那么新建实例会默认加入 default（默认资源）项目中，您也可以根据业务需要选择其他项目。
    • 若您选择的不是账号全部资源，而是一个具体的项目（例如您自行创建的项目），那么新建实例将默认自动加入该项目，您也可以根据业务需要选择其他项目。

    说明

    实例创建成功后，您还可以改变实例的所属项目，例如将实例从当前项目移入至目标项目，或将未加入项目的云资源移入至目标项目。具体操作步骤，请参见资源移入项目。

    标签

    单击添加标签，输入标签键和标签值，为实例添加标签。
    标签由一个键值对（Key-Value）组成，用于标识云资源，可以帮助您从不同维度（例如用途、所有者或环境等）对具有相同特征的云资源进行分类，便于筛选和聚合，从而轻松管理云上资源。更多信息，请参见标签管理。

    参数配置

    从下拉列表中为新建实例选择一个参数模板。
    当前仅副本集实例支持参数模板功能，因此仅当实例类型选择副本集时才会看到该配置项。

    说明

    • 参数模板必须应用在数据库版本相同的实例中，因此下拉列表中仅展示与实例的数据库版本相同的参数模板。例如创建的是 MongoDB 6.0 实例，那么下拉列表中仅会展示数据库版本为 MongoDB 6.0 的参数模板。关于参数模板的更多详情，请参见参数模板管理。
    • 您可以选择系统参数模板，也可以单击下拉列表右侧的查看参数模板前往参数模板页创建自定义模板。具体操作步骤，请参见创建参数模板。
    • 若该配置项留空，表示不选择任何参数模板，此时实例的所有参数均使用默认参数值。
    • 若您选择了自定义参数模板，但自定义参数模板中并没有包含实例支持的所有参数，那么创建实例时会将参数模板中的参数值配置到实例中，而未在该参数模板中的参数则使用默认值。

    计费信息

    计费类型

    您可以选择按量计费或包年包月。

    说明

    若选择计费类型为选择包年包月，您需要确认购买时长，同时您还可以勾选到期自动续费，系统会在实例到期前自动续费。

  6. 在页面左下角选择实例购买数量，在右下角单击确认订单。

    说明

    • 每次需至少购买 1 个实例，最多可同时购买 10 个实例。
    • 每个火山引擎主账号在每个地域下默认最多可购买 30 个 MongoDB 实例。若您需要调整配额购买更多实例，请前往配额中心提交配额申请。

  7. 根据您选择的计费类型完成后续步骤。

    • 若选择了按量计费：
      在确认订单页面，确认订单详情，阅读并勾选服务条款，单击立即购买即可。
    • 若选择了包年包月：
      1. 在确认订单页面，确认订单详情，阅读并勾选服务条款，单击提交订单。
      2. 在确认订单信息页面，再次确认订单详情，单击下一步。
      3. 在提交支付信息页面，确认支付明细并选择支付方式，单击去支付即可。

相关 API

API
描述
CreateDBInstance调用 CreateDBInstance 接口创建 MongoDB 实例。
DescribeRegions调用 DescribeRegions 接口查询文档数据库 MongoDB 版可用的地域资源信息。
DescribeAvailabilityZones调用 DescribeZones 接口查询 MongoDB 实例在指地域定或所有地域下的可用区资源信息。