Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/
Atlas CLI
/
Gerir atlas
/
Sistemas locais em nuvem &

Criar uma implantação local do Atlas

Nesta página

  • Sistema operacional compatível com as implantações locais do Atlas
  • Concluir os pré-requisitos
  • Criar uma implantação local do Atlas
  • Gerencie a implantação de um Atlas local
  • Use o Atlas Search com uma implantação local do Atlas
  • Use o Atlas Vector Search com uma implantação local do Atlas
  • Ações suportadas
  • Solução de problemas de erros

Este tutorial mostra como utilizar o comando atlas deployments para criar um sistema do Atlas local. Neste tutorial, implantaremos um conjunto de réplicas de um único nó no seu computador local. Você pode então managed seu sistema e utilizar o Atlas Search e o Atlas Vector Search.

Sistema operacional compatível com as implantações locais do Atlas

Sistema operacional
Versão do sistema operacional
Arquitetura
Núcleos mínimos de CPU
Mínimo de RAM livre (GB)
macOS
13.2 e posterior
x86-64, ARM
2
2
Red hat enterprise linux/CentOS
8, 9
x86-64, ARM
2
2
Ubuntu
22.04, 24.04
x86-64, ARM
2
2
Debian
11, 12
x86-64, ARM
2
2
Amazon linux
2023
x86-64, ARM
2
2
Windows
10, 11
x86
2
2

Concluir os pré-requisitos

Antes de começar, cumpra os seguintes pré-requisitos:

Importante

Para obter informações de compatibilidade sobre cada produto na lista de dependências, consulte a documentação de instalação do produto.

1

Instale as dependências.

  1. Instale o Atlas CLI.

    Se você usar Homebrew, poderá executar o seguinte comando no seu terminal:

    brew install mongodb-atlas-cli

    Para obter instruções de instalação em outros sistemas operacionais, consulte Instalar ou Atualizar a Atlas CLI.

  2. Instale o docker.

    O Docker requer uma conexão de rede para extrair e armazenar em cache imagens do MongoDB .

  3. (Opcional) Instale o mongosh versão 2.0 ou posterior.

    brew install mongosh

    Para obter instruções de instalação em outros sistemas operacionais,consulte Instalar o mongosh .mongosh

  4. (Opcional) Instale o Compass versão 1.39.4 ou posterior.

    brew install mongodb-compass

    Para obter instruções de instalação em outros sistemas operacionais,consulte Baixar e instalar o Compass.

2

Crie uma conta Atlas.

Se você ainda não tiver uma conta existente do Atlas , execute atlas setup em seu terminal ou crie uma nova conta.

Criar uma implantação local do Atlas

Use o comando atlas deployments para criar uma implantação local do Atlas.

Você pode executar este comando das seguintes maneiras:

  • Modo interativo (padrão): o comando solicita as configurações de implantação e fornece valores padrão.

  • Modo interativo (personalizado): o comando solicita as configurações de implantação e permite que você forneça valores personalizados.

  • Modo não interativo: você executa o comando com as opções especificadas. O comando não solicita que você forneça valores adicionais. Para verificar todas as ações compatíveis com atlas deployments, consulte implantações do Atlas.

Clique em uma das abas a seguir para verificar o comando de seu modo preferido.

1

Execute o atlas deployments comando no modo interativo.

atlas deployments setup
2

Especifique o que implementar.

Exemplo:

Especifique local - Local Database e pressione Enter..

? What would you like to deploy?  [Use arrows to move, type to filter, ? for more help]
> local - Local Database
  atlas - Atlas Database
[Default Settings]
Deployment Name   local50
MongoDB Version   7.0
Port              27017
3

Especifique como configurar seu banco de dados local Atlas.

Exemplo:

Especifique default - With default settings e pressione Enter..

? How do you want to setup your local MongoDB database?  [Use arrows to move, type to filter]
> default - With default settings
  custom - With custom settings
  cancel - Cancel set up
Creating your deployment local50 [this might take several minutes]
1/4: Downloading and completing configuration...
2/4: Starting your local environment...
3/4: Downloading MongoDB binaries to your local environment...
4/4: Creating your deployment local50...
Deployment created!
Connection string: mongodb://localhost:27017/?directConnection=true
1

Execute o atlas deployments comando no modo interativo.

atlas deployments setup
2

Especifique o que implementar.

Especifique local - Local Database e pressione Enter..

Exemplo:

? What would you like to deploy?  [Use arrows to move, type to filter, ? for more help]
> local - Local Database
  atlas - Atlas Database
[Default Settings]
Deployment Name   local50
MongoDB Version   7.0
Port              27017
3

Especifique como configurar seu banco de dados local Atlas.

Exemplo:

Especifique custom - With custom settings e pressione Enter..

? How do you want to setup your local MongoDB database?  [Use arrows to move, type to filter]
  default - With default settings
> custom - With custom settings
  cancel - Cancel set up
4

Especifique um nome de sistema.

Exemplo:

Especifique myLocalRs e pressione Enter..

? Deployment Name [This can't be changed later] (local3612) myLocalRs
5

Especifique uma versão do MongoDB .

Exemplo:

Especifique 7.0 e pressione Enter..

? MongoDB Version  [Use arrows to move, type to filter]
> 7.0
  6.0
6

Especifique uma porta.

Exemplo:

Especifique 37018 e pressione Enter..

? Specify a port (49469) 37018
Creating your deployment myLocalRs
1/2: Starting your local environment...
2/2: Creating your deployment myLocalRs...
Deployment created!
Connection string: mongodb://localhost:37018/?directConnection=true
1

Execute o atlas deployments comando com as opções.

Exemplo:

atlas deployments setup myLocalRs1 --type local --force
[Default Settings]
Deployment Name      myLocalRs1
MongoDB Version   7.0
Port              49684
Creating your deployment myLocalRs1
1/2: Starting your local environment...
2/2: Creating your deployment myLocalRs1...
Deployment created!
Connection string: mongodb://localhost:49684/?directConnection=true
connection skipped

Gerencie a implantação de um Atlas local

Use o comando atlas deployments para gerenciar uma implantação local do Atlas. Você pode usar os seguintes comandos para implantações locais e em nuvem do Atlas. Você pode usar --type local ou --type atlas para executar o comando para implantações do Atlas locais ou na nuvem, respectivamente.

1

Listar implantações disponíveis.

Exemplo:

atlas deployments list
NAME        TYPE    MDB VER   STATE
local50     LOCAL   7.0.1     IDLE
local62     LOCAL   7.0.1     IDLE
myLocalRs   LOCAL   7.0.1     IDLE
myLocalRs1  LOCAL   7.0.1     IDLE
2

Baixe e carregue os dados de amostra.

  1. Execute o seguinte comando para baixar os dados de amostra:

    curl  https://atlas-education.s3.amazonaws.com/sampledata.archive -o sampledata.archive

  2. Copie e cole o seguinte comando no seu terminal e substitua {port-number} pela porta para sua implantação:

    mongorestore --archive=sampledata.archive --port={port-number}
3

Conecte-se a uma implantação.

  1. Execute o seguinte comando para se conectar a uma implantação:

    atlas deployments connect

  2. Especifique a implantação a qual vai se conectar e pressione Enter.

  3. Defina como você deseja conectar-se à implantação e pressione Enter..

4

Pause uma implantação.

  1. Execute o seguinte comando para pausar um sistema:

    atlas deployments pause

  2. Especifique a implantação a ser pausada e pressione Enter.

5

Inicie uma implantação.

  1. Execute o seguinte comando para iniciar uma implantação:

    atlas deployments start

  2. Especifique a implantação a ser iniciada e pressione Enter.

6

Retorne os registros para a implantação.

  1. Execute o seguinte comando para retornar os registros para uma implantação:

    atlas deployments logs

  2. Especifique a implantação para a qual retornar os registros e pressione Enter.

7

Exclua uma implantação.

  1. Execute o seguinte comando para excluir uma implantação:

    atlas deployments delete

  2. Especifique a implantação a ser excluída e pressione Enter.

  3. Especifique y e pressione Enter. para confirmar.

Use o Atlas Search com uma implantação local do Atlas

Utilize o comando atlas deployments search indexes create para criar um índice do Atlas Search Atlas Search . Você pode então executar queries do Atlas Search. Para saber mais, consulte Atlas Search.

Você pode executar este comando com implantações locais e em nuvem do Atlas. Para etapas detalhadas, consulte Criar um Índice Atlas Search e Executar uma Query.

Use o Atlas Vector Search com uma implantação local do Atlas

Utilize o comando atlas deployments search indexes create para trabalhar com o Atlas Vector Search. Para saber mais, consulte Como Indexar Incorporações de Vetores para Vector Search.

Você pode executar este comando com sistemas locais e em nuvem do Atlas . Para etapas detalhadas, consulte Utilizar Atlas Vector Search com um Sistema Atlas .

Importante

Para usar o Atlas CLI com o Atlas Vector Search, você deve criar um sistema do Atlas com o MongoDB 7.0.5 ou posterior. Se você criou uma implantação local no Atlas com uma versão anterior do MongoDB, não obterá a versão mais recente do MongoDB automaticamente. Você deve excluir as imagens e implantações anteriores. Em seguida, você deverá criar uma nova implantação Atlas.

Ações suportadas

Para saber todas as ações compatíveis com atlas deployments, consulte implantações do Atlas.

Solução de problemas de erros

Para saber mais sobre como solucionar problemas de implantação local do Atlas , consulte Solucionar problemas de implantação local do Atlas .

Voltar

Sistemas locais em nuvem &

Próximo

Implante com Docker