Crea un clúster para tu proyecto.
Para empezar rápidamente, especifique un nombre para su clúster, un proveedor de nube y una región para implementar un conjunto de réplicas de tres miembros con la última versión del servidor MongoDB. Para tener control total de su implementación o crear clústeres multinube, proporcione un archivo de configuración JSON con el indicador --file.
Nota sobre la obsolescencia: Los niveles M2 y M5 ya no se utilizan. Al seleccionar M2 o M5, se creará un nivel FLEX. Para consultar la guía de migración, visite: https://dochub.mongodb.org/core/flex-migration.n
Para utilizar este comando, debe autenticarse con una cuenta de usuario, una cuenta de servicio o una clave API con 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 una vez creado. Puede contener letras ASCII, números y guiones. Debe especificar el argumento del nombre del clúster si no utiliza la opción --file. |
opciones
Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
--autoScalingMode | string | false | Modo de escalado del clúster. Los valores válidos son clusterWideScaling o independentShardScaling. Se excluye mutuamente con --file. El valor predeterminado es "clusterWideScaling". |
--backup | false | Marca que habilita la copia de seguridad continua en la nube para su implementación. Esta opción no está disponible para clústeres menores 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 --file. El valor predeterminado es 2. |
--enableTerminationProtection | false | Habilita la protección contra la terminación del clúster. No se puede eliminar un clúster con esta protección habilitada. | |
-f, --file | string | false | Ruta a un archivo de configuración JSON opcional que define la configuración del clúster. Nota: Los campos no compatibles del archivo JSON se ignoran. Para obtener más información sobre los archivos de configuración del clúster para la CLI de Atlas, consulte https://dochub.mongodb.org/core/cluster-config-file-atlascli. Mutuamente excluyente con --tier, --provider, --members, --region, --diskSizeGB, --mdbVersion, --biConnector, --type, --shards, --tag, --autoScalingMode. |
-h, --ayuda | false | ayuda para crear | |
--mdbVersion | string | false | Versión principal de MongoDB del clúster. Si no se especifica ningún valor, se utiliza la última versión estable de MongoDB. Consulte: https://www.mongodb.com/resources/products/mongodb-version-history. Mutuamente excluyente con --file. |
-m, --members | Int | false | Número de miembros en el conjunto 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 | Cadena hexadecimal que identifica el proyecto que se utilizará. Esta opción anula la configuración del 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. Debe especificar la opción "proveedor" si no utiliza 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 fragmentos en el clúster. Mutuamente excluyente con --archivo. Este valor es por defecto 1. |
--tag | clave=valor | false | Lista que contiene pares clave-valor de 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. Mutuamente excluyente con --file. El valor predeterminado es "FLEX". |
--type | string | false | Tipo de clúster que desea crear. Los valores válidos son REPLICASET o SHARDED. Mutuamente excluyente con --file. Este valor predeterminado es "REPLICASET". |
-w, --watch | false | Indicador que indica si se debe supervisar el comando hasta que se complete su ejecución o hasta que se agote el tiempo de vigilancia. Para establecer el tiempo de vigilancia, utilice la opción --watchTimeout. | |
--watchTimeout | Int | false | Tiempo en segundos hasta que se agota el tiempo de vigilancia. Tras el tiempo de vigilancia, 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, la CLI devuelve un resultado similar al siguiente ejemplo. Los valores entre paréntesis representan sus 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