Neste guia, você aprenderá como criar uma implantação do MongoDB Atlas localmente ou na nuvem. Em seguida, você aprenderá como criar um aplicativo que se conecta à sua implantação. Para saber como instalar as edições MongoDB Community ou MongoDB Enterprise em sua própria infraestrutura, consulte o Instalar MongoDB guia.
Criar uma implantação 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 da linha de comando que permite gerenciar suas implantações a partir do terminal
MongoDB Shell: Ferramenta interativa que se conecta a uma implantação e fornece suporte à operação do banco de dados
Docker: plataforma que permite executar software em contêineres, incluindo implantações locais do MongoDB
Selecione a aba 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 website.
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 website 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 aplicativo Docker Desktop. Após a conclusão da instalação, certifique-se de criar uma conta Docker e iniciar o aplicativo.
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 nó em um contêiner 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 cluster 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.