Neste guia, você aprenderá como criar um sistema do MongoDB Atlas localmente ou na nuvem. Em seguida, você aprenderá como criar um aplicação que se conecta ao seu sistema. Para saber como instalar as edições MongoDB Community ou MongoDB Enterprise em sua própria infraestrutura, consulte o guiaInstalar o MongoDB .
Criar um sistema do MongoDB Atlas
Esta seção mostra como configurar uma implantação local ou em nuvem do MongoDB Atlas e se conectar à implantação usando o MongoDB Shell.
Instalar dependências
Antes de iniciar este tutorial, você deve instalar as seguintes dependências em seu ambiente de desenvolvimento:
Atlas CLI: Interface de linha de comando que permite gerenciar seus sistemas a partir do terminal
MongoDB Shell: Ferramenta interativa que se conecta a um sistema e fornece suporte à operação do banco de dados
Docker: plataforma que permite executar software em contêineres, incluindo sistemas locais do MongoDB
Selecione a guia correspondente ao seu sistema operacional para visualizar os comandos que instalam essas ferramentas de desenvolvimento necessárias.
Execute os seguintes comandos para instalar as dependências usando o gerenciador de pacote Homebrew. Se você não tiver o Homebrew, pode instalá-lo seguindo as instruções no site da Homebrew.
brew install mongodb-atlas brew install --cask docker
Execute os seguintes comandos para instalar as dependências usando o gerenciador de pacote Chocolatey. Se você não tiver o Chocolatey, pode instalá-lo seguindo as instruções no site do Chocolatey.
choco install mongodb-atlas choco install docker-desktop
Para outras formas de instalar a Atlas CLI, consulte a página de instalação da Atlas CLI.
Observação
Docker Desktop
Os comandos anteriores instalam o aplicação Docker Desktop. Após a conclusão da instalação, certifique-se de criar uma conta Docker e iniciar o aplicação.
Configure uma implementação completa
Execute o comando a seguir e siga as instruções na shell para implantar um cluster. Se você não tiver uma conta Atlas , o seguinte comando solicitará que você crie uma.
Este comando cria um conjunto de réplicas de um único membro em um container que é executado em sua máquina local.
atlas deployments setup myDeployment --type local \ --mdbVersion 8.0 --port <port number> --connectWith skip
Observação
Substitua o espaço reservado <port number> pela porta que você deseja usar. A porta padrão é 27017, mas você pode especificar uma porta diferente se 27017 não estiver disponível.
O comando gera as seguintes informações:
Deployment created! Connection string: "<connection string URI>"
Salve o URI da string de conexão para uso em uma etapa futura.
Este comando cria um agrupamento de camada grátis no MongoDB Atlas.
atlas deployments setup myDeployment --type atlas \ --provider AWS -r us-east-1 --skipSampleData \ --username <database username> --password <database user password> \ --connectWith skip --force
Observação
Substitua os seguintes valores de espaço reservado para criar um novo usuário de banco de dados com privilégios atlasAdmin em sua implantação:
<database username>: Especifique um nome de usuário para seu novo usuário de banco de dados<database user password>: Especifique uma senha para o seu novo usuário de banco de dados
O comando gera as seguintes informações:
Cluster created. Your connection string: "<connection string URI>"
Salve o URI da string de conexão para uso em uma etapa futura.
Conecte-se à sua implantação
Você pode se conectar ao seu sistema com o shell do MongoDB (mongosh) executando o seguinte comando:
atlas deployments connect myDeployment --connectWith mongosh
atlas deployments connect myDeployment --username <database username> \ --password <database user password> --connectWith mongosh
Observação
Substitua os espaços reservados <database username> e <database user password> pelo nome de usuário e senha que você criou para o usuário de banco de dados.
Após conectar, você pode executar o seguinte comando para testar sua conexão:
show dbs
O comando retorna uma lista de bancos de dados em seu sistema.
Parabéns! Você configurou com sucesso sua implantação do MongoDB Atlas e conectou-se a ela. Para saber mais sobre como interagir com sua implantação usando o shell do MongoDB, consulte a documentação do shell do MongoDB.
Na próxima seção, você aprenderá como criar um aplicação que se conecta à sua implantação e interage com dados.
Crie seu primeiro aplicativo MongoDB
Para se conectar à sua implantação do MongoDB Atlas em um aplicação, você pode usar uma das bibliotecas oficiais do cliente do MongoDB.
Selecione sua linguagem de programação preferida no menu suspenso a seguir para saber como se conectar à sua implantação do MongoDB Atlas nesse idioma.
Dica
Antes de executar as etapas nesta seção, certifique-se de sair do MongoDB Shell executando o comando exit.