创建集群_MonogDB 中文网

MongoDB 工具

MongoDB工具 >MongoDB命令行界面 >参考 >阿特拉斯 > 创建集群

在本页面

句法
选件
输出量
例子

该命令在指定项目中创建集群。您还可以使用Atlas UI 或API创建集群。cluster create

语法¶

mongocli atlas cluster create <cluster-name>
     [ --backup true|false ]
     [ --diskSizeGB <size-of-disk> ]
     [ --file|-f <path-to-cluster-config-file> ]
     [ --mdbVersion <mogodb-version>]
     [ --members|-m <number-of-members> ]
     [ --projectId <project-ID> ]
     [ --profile|-P <profile-name> ]
       --provider AWS|GCP|AZURE
       --region|-r <region-name>

注意

使用-h或--help查看此命令的命令行帮助。

选项¶

选项类型描述需要？

--backup

布尔值

标记以在大型群集上启用或禁用备份M10。此选项不适用于小于的群集M10。值可以是：

true启用Atlas 云提供商快照
false禁用Atlas 云提供商快照

如果省略，则默认为false。

没有

<cluster-name> 串集群名称。创建集群后，无法更改集群名称。群集名称可以包含ASCII字母，数字和连字符。是

--diskSizeGB

整型

用于存储的磁盘大小（以GB为单位）。如果省略，则使用默认磁盘大小作为实例类型。选择您的云提供商选项卡以查看每种实例类型的默认磁盘大小：

AWS
蔚蓝
GCP

实例大小	默认存储	默认RAM
`M2`	2 GB	共享
`M5`	5 GB	共享
`M10`	10 GB	2 GB
`M20`	20 GB	4GB
`M30`	40 GB	8 GB
`M40` 要么 `R40`	80 GB	16 GB
`M40_NVME`	380 GB	15.25 GB
`M50` 要么 `R50`	160 GB	32 GB
`M50_NVME`	760 GB	30.5 GB
`M60` 要么 `R60`	320 GB	64 GB
`M60_NVME`	1.6 TB	61 GB
`M80`	760 GB	131 GB
`R80`	750 GB	122 GB
`M80_NVME`	1.6 TB	122 GB
`M100`	1 TB	160 GB
`M140` ^1个	1 TB	192 GB
`M200` 要么 `R200`	1.5 TB	256 GB
`M200_NVME`	3.1 TB	244 GB
`M300` ^1个	2 TB	384 GB
`R300`	2 TB	384 GB
`R400`	3 TB	488 GB
`M400_NVME` ²	4 TB	512 GB
`R700`	4 TB	768 GB

¹providerSettings.regionName等于时不可用AP_SOUTHEAST_2。

²可用性限定于以下的区域： - US_EAST_1 - US_EAST_2 - US_WEST_2 - EU_WEST_1 - EU_CENTRAL_1 -AP_NORTHEAST_1

集群层	默认存储	默认RAM
`M2`	2 GB	共享
`M5`	5 GB	共享
`M10`	32 GB	2 GB
`M20`	32 GB	4GB
`M30`	32 GB	8 GB
`M40`	128 GB	16 GB
`M50`	128 GB	32 GB
`M60`	128 GB	64 GB
`M80`	256 GB	128 GB
`M200`	256 GB	256 GB

集群层	默认存储	默认RAM
`M2`	2 GB	共享
`M5`	5 GB	共享
`M10`	10 GB	1.70 GB
`M20`	20 GB	3.75 GB
`M30`	40 GB	7.5 GB
`M40`	80 GB	15 GB
`M50`	160 GB	30 GB
`M60`	320 GB	60 GB
`M80`	750 GB	120 GB
`M200`	1.5 TB	240 GB
`M300` ^1个	2.2 TB	360 GB

¹不可用，如果providerSettings.regionName等于： - SOUTH_AMERICA_EAST_1 - EUROPE_WEST_3 - NORTHEASTERN_ASIA_PACIFIC -AUSTRALIA_SOUTHEAST_1

没有

--file， -f

串

定义集群设置的JSON配置文件的路径。配置文件中指定的任何设置都优先于命令选项指定的设置。

有关您可以定义的设置的列表，请参阅“ 创建一个群集API”。

注意

您无法通过MongoDB CLI创建全局集群。

没有

--mdbVersion

串

要部署的集群的主要版本。值可以是：

4.2
4.0- M10+仅适用于集群
3.6- M10+仅适用于集群

默认情况下，部署v4.2。

没有

--members， -m 整型副本集中的成员数。默认值为3。没有

--profile， -P 串设置项目公钥和私钥的配置文件的名称。如果省略，则使用 default配置文件。要了解有关创建配置文件的更多信息，请参阅配置MongoDB CLI。没有

--projectId 串您要在其中创建集群的项目的唯一标识符。如果省略，请在配置文件或环境变量中使用项目ID 。没有

--provider

串

在其上配置服务器的云服务提供商。值可以是：

AWS -亚马逊AWS
GCP -Google云端平台
AZURE -Microsoft Azure

是

--region， -r

串

MongoDB集群的物理位置。选择您的云提供商选项卡以查看可用区域：

AWS
蔚蓝
GCP

US_EAST_1
US_WEST_2
EU_WEST_1

有关受支持的AWS区域的完整列表，请参阅 Amazon Web Services（AWS）。

US_EAST_2
US_WEST
EUROPE_NORTH

有关受支持的Azure区域的完整列表，请参见 Microsoft Azure。

CENTRAL_US
WESTERN_EUROPE
EASTERN_ASIA_PACIFIC

有关受支持的GCP区域的完整列表，请参阅 Google Cloud Platform（GCP）。

是

输出¶

如果命令成功，则该命令以JSON格式输出以下字段。如果命令显示错误，请参阅故障排除以获取建议的解决方案。

领域描述

autoScaling 配置为自动缩放群集存储空间层。

autoscaling.diskGBEnabled

指定是否启用磁盘自动缩放。

值可以是：

true 如果启用
false 如果禁用

默认情况下，禁用磁盘自动缩放。

backupEnabled

指定是否启用云提供程序快照。值可以是：

true 如果启用
false 如果禁用

biConnector 群集上用于Atlas的BI Connector的配置。

biConnector.enabled

指定是否启用BI连接器。值可以是：

true 如果启用
false 如果禁用

默认值为false。

biConnector.readPreference

指定群集上BI Connector的读取首选项。值可以是：

primary以允许BI连接器从主服务器读取。
secondary以允许BI Connector从辅助服务器读取。
analytics允许BI连接器从分析节点读取。

默认值为secondary集群中没有分析节点。如果集群中有分析节点，则默认值为analytics。

clusterType

指定集群的类型。值可以是：

REPLICASET
SHARDED
GEOSHARDED

默认值为REPLICASET。

diskSizeGB 指定主机根卷的容量（以GB为单位）。

encryptionAtRestProvider 静态加密的配置。默认值为NONE。

id 指定集群的唯一标识符。

groupId

指定项目的唯一标识符。

注意

组和项目是同义词。您的{GROUP-ID}与您的项目ID相同。

mongoDBVersion 指定已部署的MongoDB版本。

mongoDBMajorVersion 指定已部署的MongoDB的主要版本。

mongoURI 指定集群的基本连接字符串。

MongoURIUpdated 在最后一次更新连接字符串时，以ISO 8601日期和时间格式（以UTC格式）指定Timestamp中的时间戳。

name 指定集群的名称。

numShards

指定分片群集中分片的数量。值可以是：

1 如果集群是副本集。
2或更高，12如果集群是分片集群，则最高为。

paused

指定是否暂停集群。值可以是：

true 如果集群已暂停。
false 如果集群处于活动状态。

providerBackupEnabled

指定是否启用云提供商快照。值可以是：

true 如果启用。
false 如果禁用。

providerSettings 运行MongoDB的已配置服务器的配置。

providerSettings.backingProviderName

指定在其上配置服务器的云提供程序服务。值可以是：

AWS 适用于Amazon AWS
GCP 适用于Google Cloud Platform
AZURE 适用于Microsot Azure

providerSettings.instanceSizeName

指定用于Atlas群集的群集层的名称。

AWS
蔚蓝
GCP

实例大小	默认存储	默认RAM
`M2`	2 GB	共享
`M5`	5 GB	共享
`M10`	10 GB	2 GB
`M20`	20 GB	4GB
`M30`	40 GB	8 GB
`M40` 要么 `R40`	80 GB	16 GB
`M40_NVME`	380 GB	15.25 GB
`M50` 要么 `R50`	160 GB	32 GB
`M50_NVME`	760 GB	30.5 GB
`M60` 要么 `R60`	320 GB	64 GB
`M60_NVME`	1.6 TB	61 GB
`M80`	760 GB	131 GB
`R80`	750 GB	122 GB
`M80_NVME`	1.6 TB	122 GB
`M100`	1 TB	160 GB
`M140` ^1个	1 TB	192 GB
`M200` 要么 `R200`	1.5 TB	256 GB
`M200_NVME`	3.1 TB	244 GB
`M300` ^1个	2 TB	384 GB
`R300`	2 TB	384 GB
`R400`	3 TB	488 GB
`M400_NVME` ²	4 TB	512 GB
`R700`	4 TB	768 GB

¹providerSettings.regionName等于时不可用AP_SOUTHEAST_2。

²可用性限定于以下的区域： - US_EAST_1 - US_EAST_2 - US_WEST_2 - EU_WEST_1 - EU_CENTRAL_1 -AP_NORTHEAST_1

集群层	默认存储	默认RAM
`M2`	2 GB	共享
`M5`	5 GB	共享
`M10`	32 GB	2 GB
`M20`	32 GB	4GB
`M30`	32 GB	8 GB
`M40`	128 GB	16 GB
`M50`	128 GB	32 GB
`M60`	128 GB	64 GB
`M80`	256 GB	128 GB
`M200`	256 GB	256 GB

集群层	默认存储	默认RAM
`M2`	2 GB	共享
`M5`	5 GB	共享
`M10`	10 GB	1.70 GB
`M20`	20 GB	3.75 GB
`M30`	40 GB	7.5 GB
`M40`	80 GB	15 GB
`M50`	160 GB	30 GB
`M60`	320 GB	60 GB
`M80`	750 GB	120 GB
`M200`	1.5 TB	240 GB
`M300` ^1个	2.2 TB	360 GB

¹不可用，如果providerSettings.regionName等于： - SOUTH_AMERICA_EAST_1 - EUROPE_WEST_3 - NORTHEASTERN_ASIA_PACIFIC -AUSTRALIA_SOUTHEAST_1

providerSettings.providerName

指定在其上配置服务器的云服务提供商的名称。值可以是：

AWS 适用于Amazon AWS
GCP 适用于Google Cloud Platform
AZURE 适用于Microsot Azure

providerSettings.regionName

指定集群的物理位置。有关区域的完整列表，请参阅云提供商参考：

replicationFactor 指定集群中副本集成员的数量。可能的值是3，5，7。

replicationSpec 集群中每个区域的配置。此对象中的每个元素代表一个群集部署的区域。

replicationSpec.<region>

指定区域的物理位置。

每个<region>对象都描述了区域在选举中的优先级以及Atlas部署到该区域的MongoDB节点的数量和类型。

replicationSpec.<region>.analyticsNodes 指定区域中分析节点的数量。Analytics（分析）节点是只读的，永远不能成为主节点。

replicationSpec.<region>.electableNodes 指定区域中的可选节点数。可选节点可以成为主要节点，并可以促进本地读取。

replicationSpec.<region>.priority

指定区域的选举优先级。最高优先级是7，它标识集群的。Atlas将主要节点放置在中。可能的最低优先级是，它标识一个只读区域。Preferred RegionPreferred Region0

您可以具有任意数量的优先级0只读区域。优先级1直通7是排他性的：每个群集只能为一个区域分配给定的优先级。

replicationSpec.<region>.readOnlyNodes 指定区域中只读节点的数量。只读节点永远不能成为主要成员，但可以促进本地读取。

replicationSpecs 全局群集中每个区域的配置。此阵列中的每个对象都代表一个区域，Atlas在该区域中为Global Cluster部署节点。

replicationSpecs.id 指定复制对象的唯一标识符。

replicationSpecs.numShards 指定要在指定区域中部署的分片数。

replicationSpecs.zoneName 指定全局群集中区域的名称。

replicationSpecs.regionConfig 区域物理位置的配置。每个 regionsConfig对象都描述了该区域在选举中的优先级以及Atlas部署到该区域的MongoDB节点的数量和类型。

replicationSpecs[n].regionsConfig

.<regionName>.analyticsNodes

指定要在区域中部署的分析节点的数量。

replicationSpecs[n].regionsConfig

.<regionName>.electableNodes

Atlas部署到该区域的可选节点数。可选节点可以成为主要节点，并可以促进本地读取。

replicationSpecs[n].regionsConfig

.<regionName>.priority

该地区的选举优先级。如果您的区域只有只读节点，请将此值设置为0。

replicationSpecs[n].regionsConfig

.<regionName>.readOnlyNodes

Atlas部署到该区域的只读节点数。只读节点永远不能成为主要节点，但可以促进本地读取。

指定0是否在该区域中不希望有任何只读节点。

srvAddress 用于连接到Atlas集群的连接字符串。该+srv修正的力量连接使用TLS。该mongoURI参数列出了其他选项。

stateName

集群的当前状态。值可以是：

IDLE
CREATING
UPDATING
DELETING
DELETED
REPAIRING

例子¶

实施例1 ¶

以下命令将在带有节点的AWS区域中创建一个示例集群。该命令使用名为的配置文件，其中包含用于访问Atlas的公钥和私钥。mongocli atlas cluster createM2myClusterUS_EAST_13egAtlasProfile

~ mongocli atlas cluster create myCluster --projectId 5e2211c17a3e5a48f5497de3 --provider AWS --region US_EAST_1 --members 3 --instanceSize M2 --mdbVersion 4.2 --diskSizeGB 2 --profile egAtlasProfile

该命令将以下内容输出到终端。要了解有关这些字段的更多信息，请参见Output。

{
         "autoScaling": {
                  "diskGBEnabled": false
         },
         "backupEnabled": false,
         "biConnector": {
                  "enabled": false,
                  "readPreference": "secondary"
         },
         "clusterType": "REPLICASET",
         "diskSizeGB": 2,
         "encryptionAtRestProvider": "NONE",
         "id": "5e272af4f10fab7c87718918",
         "groupId": "5e2211c17a3e5a48f5497de3",
         "mongoDBVersion": "4.2.2",
         "mongoDBMajorVersion": "4.2",
         "mongoURIUpdated": "2020-01-21T16:46:44Z",
         "name": "myCluster",
         "numShards": 1,
         "paused": false,
         "providerBackupEnabled": false,
         "providerSettings": {
                  "backingProviderName": "AWS",
                  "instanceSizeName": "M2",
                  "providerName": "TENANT",
                  "regionName": "US_EAST_1"
         },
         "replicationFactor": 3,
         "replicationSpec": {
                  "US_EAST_1": {
                            "analyticsNodes": 0,
                                  "electableNodes": 3,
                            "priority": 7,
                            "readOnlyNodes": 0
                  }
         },
       "replicationSpecs": [{
                        "id": "5e272af4f10fab7c87718912",
                        "numShards": 1,
                        "zoneName": "Zone 1",
                        "regionsConfig": {
                                  "US_EAST_1": {
                                          "analyticsNodes": 0,
                                          "electableNodes": 3,
                                          "priority": 7,
                                          "readOnlyNodes": 0
                                  }
                        }
             }],
         "stateName": "CREATING"
}

示例2¶

以下命令创建一个在AWS区域中命名的示例集群，其中的节点带有配置文件。该命令使用名为的配置文件，其中包含用于访问Atlas的公钥和私钥。mongocli atlas cluster createM40myClusterUS_EAST_13egAtlasProfile

~ mongocli atlas cluster create myCluster --file cluster-config.json --projectId 5e2211c17a3e5a48f5497de3 --profile egAtlasProfile

群集配置文件包含以下设置：

{
  "name": "myCluster",
  "diskSizeGB": 100,
  "numShards": 1,
  "providerSettings": {
    "providerName": "AWS",
    "diskIOPS": 300,
    "instanceSizeName": "M40",
    "regionName": "US_EAST_1"
  },
  "clusterType" : "REPLICASET",
  "replicationFactor": 3,
  "replicationSpecs": [{
    "numShards": 1,
    "regionsConfig": {
      "US_EAST_1": {
        "analyticsNodes": 0,
        "electableNodes": 3,
        "priority": 7,
        "readOnlyNodes": 0
      }
    },
    "zoneName": "Zone 1"
  }],
  "backupEnabled": false,
  "providerBackupEnabled" : true,
  "autoScaling": {
    "diskGBEnabled": true
  }
}

该命令将以下内容输出到终端。要了解有关这些字段的更多信息，请参见Output。