Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Criar e Configurar um Atlas cluster

Este tutorial demonstra como usar o comando Atlas set para:

  1. Crie um cluster no seu projeto Atlas.

  2. Carregue dados de amostra em seu cluster do Atlas.

  3. Adicione seu endereço IP à lista de acesso IP do seu projeto.

  4. Crie um usuário MongoDB para seu cluster do Atlas.

  5. Conecte-se ao seu novo cluster usando o MongoDB Shell, mongosh.

Para executar todas estas etapas e, ao mesmo tempo, criar uma nova conta do Atlas, consulte Introdução ao Atlas.

Para criar um cluster utilizando um arquivo de configuração, execute o comando cluster do Atlas create com a opção --file em vez de atlas setup. Para saber mais sobre o arquivo de configuração de um cluster do Atlas, consulte Arquivo de Configuração do Cluster.

Você também pode utilizar o atlas setup para criar uma conta do Atlas e autenticar com o Atlas. Para saber mais, consulte Introdução ao Atlas.

Antes de começar, conclua as seguintes tarefas:

Confirme o acesso de saída na porta 443 (HTTPS) para a API do Atlas e na porta 27017 para conexões do MongoDB.

Utilize o comando atlas setup para criar um cluster M0 no Atlas. Os clusters M0 têm algumas limitaçõesoperacionais .

Você pode executar este comando das seguintes maneiras:

  • Modo de configurações padrão: o comando cria um cluster de camada compartilhada de amostra com as configurações padrão.

  • Modo interativo: o comando solicita as configurações do cluster e fornece os valores padrão.

  • Modo não interativo: você executa o comando com as opções.

Clique na aba para ver o comando do seu modo preferido.

O comando cria um cluster de tier compartilhado de amostra com as seguintes configurações padrão:

  • Nome do cluster: Cluster<number>

  • Provedor de serviços: AWS

  • Região do provedor: US_EAST_1

  • Tier do cluster: M0

  • Tamanho do disco: 0.5 GB

  • Nome de usuário do banco de dados: Cluster<number>

  • Senha do usuário do banco de dados: abcdef12345

  • Permitir conexões do Endereço IP: <YourIPAddress>

  • Carregue dados de amostra: Yes

  • Abrir shell: No

Observação

A senha é um valor gerado automaticamente aleatório. abcdef12345 é um valor de exemplo.

atlas setup --force
We are deploying Cluster9876543...
Please store your database authentication access details in a secure location
Database User Username: Cluster9876543
Database User Password: abcdef12345
Creating your cluster... [Its safe to 'Ctrl + C']
Cluster created.
Your connection string: mongodb+srv://cluster9876543.example.mongodb.net
Loading sample data into your cluster... [Its safe to 'Ctrl + C']
Now you can connect to your Atlas cluster with: mongosh -u Cluster9876543 -p abcdef12345 mongodb+srv://cluster9876543.example.mongodb.net

O comando solicita as configurações do cluster e fornece opções padrão. Quando solicitado, pressione Y e, em seguida, pressione Enter para aceitar as configurações padrão.

atlas setup
Press [Enter] to use the default values.
Enter [?] on any option to get help.
[Default Settings]
Cluster Name: Cluster9876543
Cloud Provider and Region: AWS - US_EAST_1
Database User Username: Cluster9876543
Load sample data: Yes
Allow connections from (IP Address): <your-IP>
? Do you want to set up your first free database in Atlas with default settings (it's free forever)? Yes
We are deploying Quickstart-9876543...
Please store your database authentication access details in a secure location:
Database User Username: Cluster9876543
Database User Password: abcdef12345
Creating your cluster... [Its safe to 'Ctrl + C']
Cluster created.
Your connection string: mongodb+srv://cluster9876543.example.mongodb.net
Loading sample data into your cluster... [Its safe to 'Ctrl + C']
Now you can connect to your Atlas cluster with: mongosh -u Cluster9876543 -p abcdef12345 mongodb+srv://cluster9876543.example.mongodb.net

O comando cria um cluster de camada compartilhada de amostra com as seguintes configurações:

  • Nome do cluster: getStarted

  • Provedor de serviços: AWS

  • Região do provedor: US_EAST-1

  • Tier do cluster: M0

  • Tamanho do disco: 2 GB

  • Versão do MongoDB : 5.0

  • Membros do conjunto de réplicas: 3

atlas setup --clusterName getStarted --provider AWS --region US_EAST_1 --username testUser --password changeMe --accessListIp 192.0.2.15 --skipSampleData --force
We are deploying getStarted...
Please store your database authentication access details in a secure location:
Database User Username: testUser
Database User Password: changeMe
Creating your cluster... [Its safe to 'Ctrl + C']
Now you can connect to your |service| cluster with: mongosh -u testUser -p changeMe mongodb+srv://getStarted.example.mongodb.net

Depois que o cluster for provisionado, confirme se ele está pronto antes de conectar.

checkpoint
Etapa de verificação

CLI instalada

Execute atlas --version. O comando retorna informações de versão.

Autenticado

Execute atlas auth whoami. O comando retorna seu usuário autenticado.

Cluster criado

A saída da CLI mostra Cluster created. com uma string de conexão.

lista de acesso IP atualizada

Saída da CLI confirma que seu endereço IP foi adicionado.

A conexão é bem-sucedida

Execute atlas clusters connect <cluster-name> ou conecte-se com mongosh usando a string de conexão.

Depois de criar e verificar seu cluster do Atlas, você pode:

  • Conecte seu aplicativo: use a string de conexão com mongosh ou um driver MongoDB.

  • Configurar segurança: adicione endereços IP à sua lista de acesso, crie usuários de banco de dados específicos do aplicativo ou ative private endpoints para cargas de trabalho de produção.

  • Carregar dados: Use o sinalizador --loadSampleData durante configurar ou carregue seus próprios dados com mongoimport ou mongorestore.

  • Exibir status do cluster: Conecte-se à IU ou execute um comando atlas clusters no Atlas CLI.

  • Dimensionar ou modificar seu cluster: consulte Modificar um cluster.