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:
Obtener los ajustes de configuración de un clúster Atlas existente y guarde la configuración en un archivo de configuración utilizando el comando atlas clusters describe.
Cree un clúster Atlas a partir del archivo de configuración utilizando 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.
Crear un clúster Atlas a partir de un archivo de configuración
Puede utilizar los procedimientos de esta sección para crear fácilmente un nuevo clúster exportando configuraciones de un clúster existente en lugar de crear manualmente un archivo de configuración usted mismo.
Exportar la configuración del clúster existente a un archivo
Conéctese a su cuenta Atlas para obtener acceso programático si aún no se ha conectado.
Para obtener más información, consulte Conectarse desde la Atlas CLI.
Ejecute el siguiente comando para exportar los detalles de un clúster existente a un Archivo de configuraciónJSON llamado 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 cambios en la configuración en el archivo de configuración según sea necesario.
Para obtener más información sobre las configuraciones opcionales y obligatorias, consulte Archivo de configuración del clúster.
Crear un nuevo clúster usando el archivo de configuración
Conéctese a su cuenta Atlas para obtener acceso programático si aún no está conectado a su cuenta 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".