Importante
Os comandos atlas deployments são preteridos a partir da versão do Atlas CLI 1.52.0. Use comandos atlas local para sistemas locais e comandos atlas clusters para sistemas na nuvem. Atualizamos este guia para usar os novos comandos.
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 guia Instalar MongoDB.
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 local setup myDeployment \ --mdbVersion 8.0 --port <port number> --connectWith connectionString
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 gratuito no MongoDB Atlas.
atlas setup --clusterName myDeployment \ --provider AWS --region us-east-1 --skipSampleData \ --username <database username> --password <database user password> \ --connectWith skip --force
Observação
Replace the following placeholder values to create a new database user with atlasAdmin privileges in your deployment:
<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 local connect myDeployment --connectWith mongosh
atlas clusters 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.
Congratulations! You have successfully set up your MongoDB Atlas deployment and connected to it. To learn more about how to interact with your deployment by using the MongoDB Shell, see the MongoDB Shell documentation.
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
To connect to your MongoDB Atlas deployment in an application, you can use one of the official MongoDB client libraries.
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.