Este tutorial muestra cómo utilizar comandos de la CLI de Atlas para crear un nuevo clúster de Atlas a partir de un archivo de configuración. En concreto, muestra cómo:
Obtén la configuración de un clúster Atlas existente y guardes la configuración en un archivo de configuración con el comando atlas clusters describe.
Crea un clúster de Atlas a partir del archivo de configuración usando el comando atlas clusters create.
Requisitos previos
Antes de comenzar, debes tener lo siguiente:
Un perfil que contiene los ID de la organización y el proyecto Atlas desde donde desea recuperar las configuraciones de clúster existentes y donde desea crear el nuevo clúster.
Crea un clúster de Atlas a partir de un archivo de configuración
Puedes utilizar los procedimientos de esta sección para crear fácilmente un nuevo clúster exportando la configuración de un clúster existente en lugar de crear tú mismo manualmente un archivo de configuración.
Exportar la configuración del clúster existente a un archivo
Conéctate a tu cuenta de Atlas para acceso programático si aún no te has conectado.
Para obtener más información, consulte Conectarse desde la Atlas CLI.
Ejecuta el siguiente comando para exportar los detalles de un clúster existente a un Archivo de configuración JSON denominado myCluster.
atlas clusters describe <cluster-name> --output json > myCluster.json
Reemplace <cluster-name> en el comando anterior con el nombre del clúster existente que desea clonar.
(Opcional) Edite el archivo de configuración para el nuevo clúster
Abre el archivo JSON en un editor de texto para ver la configuración.
Ejemplo
El siguiente ejemplo utiliza el editor vi para ver la configuración del conjunto de réplicas para un clúster M10 llamado mySandbox en el archivo myCluster.json.
vi myCluster.json
1 { 2 "backupEnabled": true, 3 "biConnector": { 4 "enabled": false, 5 "readPreference": "secondary" 6 }, 7 "clusterType": "REPLICASET", 8 "connectionStrings": { 9 "standard": "<connection-string>" 10 }, 11 "diskSizeGB": 10, 12 "encryptionAtRestProvider": "NONE", 13 "groupId": "<group-id>", 14 "id": "<64403dd1f2a6b45e71527d5a>", 15 "mongoDBMajorVersion": "6.0", 16 "mongoDBVersion": "6.0.5", 17 "name": "mySandbox", 18 "paused": false, 19 "pitEnabled": true, 20 "stateName": "IDLE", 21 "replicationSpecs": [ 22 { 23 "numShards": 1, 24 "id": "64403dbb0a052449df3d04ae", 25 "zoneName": "Zone 1", 26 "regionConfigs": [ 27 { 28 "analyticsAutoScaling": { 29 "diskGB": { 30 "enabled": true 31 }, 32 "compute": { 33 "enabled": true, 34 "scaleDownEnabled": true, 35 "minInstanceSize": "M10", 36 "maxInstanceSize": "M40" 37 } 38 }, 39 "analyticsSpecs": { 40 "diskIOPS": 3000, 41 "ebsVolumeType": "STANDARD", 42 "instanceSize": "M10", 43 "nodeCount": 0 44 }, 45 "electableSpecs": { 46 "diskIOPS": 3000, 47 "ebsVolumeType": "STANDARD", 48 "instanceSize": "M10", 49 "nodeCount": 3 50 }, 51 "readOnlySpecs": { 52 "diskIOPS": 3000, 53 "ebsVolumeType": "STANDARD", 54 "instanceSize": "M10", 55 "nodeCount": 0 56 }, 57 "autoScaling": { 58 "diskGB": { 59 "enabled": true 60 }, 61 "compute": { 62 "enabled": true, 63 "scaleDownEnabled": true, 64 "minInstanceSize": "M10", 65 "maxInstanceSize": "M40" 66 } 67 }, 68 "priority": 7, 69 "providerName": "AWS", 70 "regionName": "US_EAST_1" 71 } 72 ] 73 } 74 ], 75 "createDate": "2023-04-19T19:15:29Z", 76 "rootCertType": "ISRGROOTX1", 77 "versionReleaseSystem": "LTS", 78 "terminationProtectionEnabled": false 79 }
(Opcional) Realice los cambios necesarios en la configuración del archivo de configuración.
Para obtener más información sobre los ajustes opcionales y obligatorios, consulta el Archivo de configuración del clúster.
Crear un nuevo clúster usando el archivo de configuración
Conéctate a tu cuenta de Atlas para acceder programáticamente si aún no estás conectado a tu cuenta de Atlas.
Para obtener más información, consulte Conectarse desde la Atlas CLI.
Ejecute el siguiente comando para comprobar el estado del clúster.
atlas clusters watch <new-cluster-name>
Reemplace <new-cluster-name> en el comando anterior con el nombre del nuevo clúster.
Este comando verifica periódicamente el estado del clúster hasta que alcanza el estado IDLE. Una vez que el clúster alcanza el estado esperado, el comando imprime "Clúster disponible".