Este tutorial demonstra como usar comandos Atlas CLI para criar um novo cluster do Atlas a partir de um arquivo de configuração. Especificamente, demonstra como:
Obtenha as definições de configuração de um Atlas cluster existente e salve as configurações em um arquivo de configuração usando o comando Atlas clusters describe .
Crie um cluster do Atlas a partir do arquivo de configuração usando o comando clusters do Atlas create.
Pré-requisitos
Antes de começar, você deve ter o seguinte:
Um perfil que contém os IDs da organização e do projeto Atlas de onde você deseja recuperar as configurações de cluster existentes e onde deseja criar o novo cluster.
Crie um cluster do Atlas a Partir de um Arquivo de Configuração
Você pode usar os procedimentos nesta seção para criar facilmente um novo cluster exportando configurações de um cluster existente em vez de criar manualmente um arquivo de configuração.
Exportar as configurações de cluster existentes para um arquivo
Conecte-se à sua conta Atlas para acesso programático se ainda não tiver se conectado.
Para saber mais, consulte Conectar a partir do Atlas CLI.
Execute o seguinte comando para exportar os detalhes de um cluster existente para um arquivo de configuração JSON denominado myCluster.
atlas clusters describe <cluster-name> --output json > myCluster.json
Substitua <cluster-name> no comando anterior pelo nome do cluster existente que você deseja clonar.
(Opcional) Edite o arquivo de configuração do novo cluster
Abra o arquivo JSON em um editor de texto para visualizar as definições de configuração.
Exemplo
O exemplo a seguir usa o editor vi para exibir as configurações do conjunto de réplicas de um cluster M10 chamado mySandbox no arquivo 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) Faça alterações nas configurações no arquivo de configuração conforme necessário.
Para saber mais sobre as configurações opcionais e obrigatórias, consulte Arquivo de Configuração de Cluster.
Criar um novo cluster usando o arquivo de configuração
Conecte-se à sua conta Atlas para acesso programático se ainda não estiver conectado à sua conta Atlas.
Para saber mais, consulte Conectar a partir do Atlas CLI.
Execute o comando a seguir para verificar o status do cluster.
atlas clusters watch <new-cluster-name>
Substitua <new-cluster-name> no comando anterior pelo nome do novo cluster.
Este comando verifica o status do cluster periodicamente até atingir o estado IDLE . Quando o cluster atingir o estado esperado, o comando imprimirá “Cluster disponível.”