Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/
Atlas CLI
/
Gerir atlas

Criar um cluster do Atlas usando um arquivo de configuração

Nesta página

  • Pré-requisitos
  • Crie um cluster do Atlas a Partir de um Arquivo de Configuração
  • Exportar as configurações de cluster existentes para um arquivo
  • (Opcional) Edite o arquivo de configuração do novo cluster
  • Criar um novo cluster usando o arquivo de configuração

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:

  1. 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 .

  2. 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 cluster do Atlas

  • Atlas CLI

  • 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

1

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.

2

Execute o seguinte comando para exportar os detalhes de um cluster existente para um arquivo de configuração JSON myCluster do denominado.

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

1

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}
2

(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.

3

Salve e feche o arquivo de configuração.

Criar um novo cluster usando o arquivo de configuração

1

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.

2

Execute o comando a seguir para criar um cluster do Atlas usando o arquivo de configuração.

atlas clusters create <new-cluster-name> -f myCluster.json

Substitua <new-cluster-name> no comando anterior pelo nome do novo cluster que você deseja criar.

3

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.”

Voltar

Crie & Configure Clusters

Próximo

Sistemas locais em nuvem &