Cree un clúster para su proyecto.
Para comenzar rápidamente, especifica un nombre para tu clúster, un proveedor de nube y una región para implementar un set de réplicas de tres nodos con la última versión del servidor de MongoDB. Para un control total de su implementación, o para crear clústeres multi-nube, proporcione un archivo de configuración JSON con el indicador --file.
Nota de desaprobación: los niveles M2 y M5 ahora están en desuso; al seleccionar M2 o M5, se creará un nivel FLEX en su lugar. Para consultar la guía de migración, visita: https://dochub.mongodb.org/core/flex-migration.n
Para usar este comando, debes autenticarte con una cuenta de usuario, una cuenta de servicio o una clave API que tenga el rol de Propietario del proyecto.
Sintaxis
atlas clusters create [name] [options]
Arguments
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
Nombre | string | false | Nombre del clúster. El nombre del clúster no se puede cambiar después de que el clúster sea creado. El nombre del clúster puede contener letras ASCII, números y guiones. Debe especificar el argumento de nombre de clúster si no utiliza la opción --archivo. |
opciones
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
--autoScalingMode | string | false | Modo en el que el clúster escala. Los valores válidos son clusterWideScaling o independentShardScaling. Se excluye mutuamente con --file. El valor predeterminado es "clusterWideScaling". |
--backup | false | Bandera que habilita la Copia de Seguridad Continua en la Nube para su implementación. Esta opción no está disponible para clústeres de menos de M10. | |
--biConnector | false | Bandera que habilita BI Connector para Atlas en la implementación. Mutuamente excluyente con --file. | |
--diskSizeGB | float | false | Capacidad, en gigabytes, del volumen raíz del host. Mutuamente excluyente con --archivo. Este valor es por defecto 2. |
--enableTerminationProtection | false | Activa la protección contra terminación para tu clúster. No puedes borrar un clúster si la protección contra terminación está activada. | |
-f, --file | string | false | Ruta a un archivo de configuración JSON opcional que define la configuración del clúster. Nota: Se omiten los campos no admitidos en el archivo JSON. Para obtener más información sobre los archivos de configuración de clúster para Atlas CLI, consulta https://dochub.mongodb.org/core/cluster-config-file-atlascli. Mutuamente excluyente con --nivel, --proveedor, --nodos, --región, --diskSizeGB, --mdbVersion, --biConnector, --type, --particiones, --etiqueta, --autoScalingMode. |
-h, --help | false | ayuda para crear | |
--mdbVersion | string | false | Versión principal de MongoDB del clúster. Cuando no se especifica ningún valor, se utiliza la última versión estable de MongoDB. Consulta: https://www.mongodb.com/resources/products/mongodb-version-history. Mutuamente excluyente con --file. |
-m, --members | Int | false | Número de nodos en el set de réplicas. Mutuamente excluyente con --archivo. Este valor es 3 por defecto. |
-o, --output | string | false | Formato de salida. Los valores válidos son json, json-path, go-template o go-template-file. Para ver la salida completa, use la opción -o json. |
--projectId | string | false | string hexadecimal que identifica el Proyecto a utilizar. Esta opción anula la configuración en el archivo de configuración o la variable de entorno. |
--provider | string | false | Nombre de su proveedor de servicios en la nube. Los valores válidos son AWS, AZURE, o GCP. Debes especificar la opción provider si no utilizas la opción --file. Mutuamente excluyente con --file. |
-r, --region | string | false | Ubicación física de su clúster de MongoDB. Debe especificar la opción "región" si no usa la opción "--file". Para obtener una lista completa de las regiones de AWS compatibles, consulte: https://dochub.mongodb.org/core/aws-atlas. Para obtener una lista completa de las regiones de Azure compatibles, consulte: https://dochub.mongodb.org/core/azure-atlas. Para obtener una lista completa de las regiones de GCP compatibles, consulte: https://dochub.mongodb.org/core/gcp-atlas. Mutuamente excluyente con --file. |
-s, --shards | Int | false | Número de particiones en el clúster. Mutuamente excluyente con --archivo. Este valor es por defecto 1. |
--tag | clave=valor | false | Lista que contiene pares clave-valor entre 1 y 255 caracteres de longitud para etiquetar y categorizar el clúster. Mutuamente excluyente con --file. |
--tier | string | false | Nivel para cada servidor que almacena datos en el clúster. Para obtener más información sobre los niveles de clúster, consulta https://dochub.mongodb.org/core/cluster-tier-atlas. Se excluye mutuamente con --archivo. Este valor se establece por defecto en "FLEX". |
--type | string | false | Tipo de clúster que desea crear. Los valores válidos son REPLICASET o PARTICIONADO. Mutuamente excluyente con --archivo. Este valor se establece por defecto en "REPLICASET". |
-w, --watch | false | Bandera que indica si debe observar el comando hasta que complete su ejecución o se agote el tiempo de espera de la observación. Para establecer el tiempo que tarda el reloj en agotarse, utiliza la opción --watchTimeout. | |
--watchTimeout | Int | false | Tiempo en segundos hasta que una conexión se agote. Después de que una monitorización agote su tiempo, la CLI deja de monitorear el comando. |
Opciones heredadas
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
-P, --profile | string | false | Nombre del perfil que se usará en el archivo de configuración. Para obtener más información sobre los perfiles de la CLI de Atlas, consulte https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. |
Salida
Si el comando se ejecuta correctamente, el CLI devuelve una salida similar a la siguiente muestra. Los valores entre corchetes representan tus valores.
Cluster '<Name>' is being created.
Ejemplos
# Deploy a free cluster named myCluster for the project with the ID 5e2211c17a3e5a48f5497de3: atlas cluster create myCluster --projectId 5e2211c17a3e5a48f5497de3 --provider AWS --region US_EAST_1 --tier M0
# Deploy a Flex cluster named myFlexCluster for the project with the ID 5e2211c17a3e5a48f5497de3 and tag "env=dev": atlas cluster create myFlexCluster --projectId 5e2211c17a3e5a48f5497de3 --provider AWS --region US_EAST_1 --tier FLEX --tag env=dev
# Deploy a free cluster named myCluster for the project with the ID 5e2211c17a3e5a48f5497de3 and tag "env=dev": atlas cluster create myCluster --projectId 5e2211c17a3e5a48f5497de3 --provider AWS --region US_EAST_1 --tier M0 --tag env=dev
# Deploy a three-member replica set named myRS in AWS for the project with the ID 5e2211c17a3e5a48f5497de3: atlas cluster create myRS --projectId 5e2211c17a3e5a48f5497de3 --provider AWS --region US_EAST_1 --members 3 --tier M10 --mdbVersion 5.0 --diskSizeGB 10
# Deploy a three-member replica set named myRS in AZURE for the project with the ID 5e2211c17a3e5a48f5497de3: atlas cluster create myRS --projectId 5e2211c17a3e5a48f5497de3 --provider AZURE --region US_EAST_2 --members 3 --tier M10 --mdbVersion 5.0 --diskSizeGB 10
# Deploy a three-member replica set named myRS in GCP for the project with the ID 5e2211c17a3e5a48f5497de3: atlas cluster create myRS --projectId 5e2211c17a3e5a48f5497de3 --provider GCP --region EASTERN_US --members 3 --tier M10 --mdbVersion 5.0 --diskSizeGB 10
# Deploy a cluster or a multi-cloud cluster from a JSON configuration file named myfile.json for the project with the ID 5e2211c17a3e5a48f5497de3: atlas cluster create --projectId <projectId> --file myfile.json
# Deploy a three-member sharded cluster with independent shard scaling mode named myRS in GCP for the project with the ID 5e2211c17a3e5a48f5497de3: atlas cluster create myRS --projectId 5e2211c17a3e5a48f5497de3 --provider GCP --region EASTERN_US --members 3 --tier M10 --mdbVersion 5.0 --diskSizeGB 10 --autoScalingMode independentShardScaling