Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Menu Docs
Página inicial do Docs
/ /
Sistemas locais em nuvem &
Página inicial do Docs
/ /
Gerir atlas
/
Sistemas locais em nuvem &
Página inicial do Docs
/
Ferramentas
/
Atlas CLI
/
Gerir atlas
/
Sistemas locais em nuvem &

Criar uma implantação local do Atlas

Importante

Os comandos atlas deployments são preteridos a partir da versão do Atlas CLI 1.52.0. Em vez disso , use comandos atlas local. Atualizamos este tutorial para usar o comando atlas local.

Este tutorial mostra como utilizar o comando atlas local para criar uma implantação local do Atlas. Neste tutorial, implantaremos um conjunto de réplicas de nó único em seu computador local. Em seguida, você pode gerenciar sua implantação e usar o MongoDB Search e o MongoDB 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.

  5. (Opcional) Instale o código do Visual Studio e o MongoDB for VS Code .

    Para saber mais, consulte Instalar o MongoDB for VS Code.

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 local 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 aprender todas as ações compatíveis com atlas local, consulte atlas-local.

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

1

Execute o comando atlas local no modo interativo.

atlas local setup

Para carregar dados de amostra do MongoDB durante a configuração:

  1. Execute o seguinte comando:

    atlas local setup --loadSampleData true

Para inicializar o sistema local do Atlas com seus próprios dados e índices:

  1. Copie o seguinte comando:

    atlas local setup --initdb {folder}

  2. Substitua o espaço reservado {folder} pelo diretório que contém os arquivos .js e .sh para executar dentro do container local em ordem alfanumérica.

  3. Execute o comando.

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 comando atlas local no modo interativo.

atlas local setup

Para carregar dados de amostra do MongoDB durante a configuração:

  1. Execute o seguinte comando:

    atlas local setup --loadSampleData true

Para inicializar o sistema local do Atlas com seus próprios dados e índices:

  1. Copie o seguinte comando:

    atlas local setup --initdb {folder}

  2. Substitua o espaço reservado {folder} pelo diretório que contém os arquivos .js e .sh para executar dentro do container local em ordem alfanumérica.

  3. Execute o comando.

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 comando atlas local com as opções.

Exemplo:

atlas local setup myLocalRs1 --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

Para inicializar o sistema local do Atlas com seus próprios dados e índices:

  1. Copie o seguinte comando:

    atlas local setup myLocalRs1 --force --initdb {folder}

  2. Substitua o espaço reservado {folder} pelo diretório que contém os arquivos .js e .sh para executar dentro do container local em ordem alfanumérica.

  3. Execute o comando.

Gerencie a implantação de um Atlas local

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

1

Listar implantações disponíveis.

Exemplo:

atlas local 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

Carregar dados de amostra.

Observação

Você também pode carregar dados de amostra durante a configuração da implantação utilizando a opção --loadSampleData true com atlas local setup. Consulte os exemplos de configuração acima.

Para carregar dados de amostra em uma implantação existente:

  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 local 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..

    Você pode recuperar a string de conexão ou conectar-se aos seguintes clientes: string de conexão:

4

Pause uma implantação.

  1. Execute o seguinte comando para pausar um sistema:

    atlas local stop

  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 local 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 local logs

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

Excluir uma implantação Atlas

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

    atlas local delete

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

  3. Especifique y e pressione Enter. para confirmar.

Mover um sistema do Atlas local para um sistema do Atlas na nuvem

Você pode usar as Database Tools Docker e MongoDB para mover um sistema local do Atlas para um sistema do Atlas na nuvem.

1

Crie um sistema do Atlas na nuvem.

atlas setup
2

Crie um sistema do Atlas local.

atlas local setup

Para inicializar o sistema local do Atlas com seus próprios dados e índices:

  1. Copie o seguinte comando:

    atlas local setup --initdb {folder}

  2. Substitua o espaço reservado {folder} pelo diretório que contém os arquivos .js e .sh para executar dentro do container local em ordem alfanumérica.

  3. Execute o comando.

3

Crie um arquivo binário dos dados.

  1. Copie o seguinte comando:

    docker exec -u root -it {local_deployment_name} sh -c "mkdir -p /data/dump && chown -R mongod:mongod /data/dump && mongodump --archive=/data/dump/dump.archive"

  2. Substitua o espaço reservado {local-deployment-name} pelo nome da sua implantação local do Atlas .

  3. Execute o comando.

4

Copie o arquivo.

  1. Copie o seguinte comando:

    docker cp <local deployment name>:/data/dump/dump.archive .

  2. Substitua o espaço reservado {local-deployment-name} pelo nome da sua implantação local do Atlas .

  3. Execute o comando.

5

Retorne a string de conexão.

atlas clusters connectionStrings describe
6

Restaure a partir do arquivo arquivado.

  1. Copie o seguinte comando:

    mongorestore --uri={connection-string} --archive=./dump.archive

  2. Substitua o placeholder {connection-string} pela string de conexão.

  3. Execute o comando.

7

(Opcional) Exclua o sistema local do Atlas .

atlas local delete

Atualizar um sistema local do Atlas

Você pode usar Docker e MongoDB Database Tools para atualizar um sistema local do Atlas para uma versão mais recente da imagem.

1

Criar um novo sistema local do Atlas .

atlas local setup

Para inicializar o sistema local do Atlas com seus próprios dados e índices:

  1. Copie o seguinte comando:

    atlas local setup --initdb {folder}

  2. Substitua o espaço reservado {folder} pelo diretório que contém os arquivos .js e .sh para executar dentro do container local em ordem alfanumérica.

  3. Execute o comando.

2

Crie um arquivo binário dos dados.

  1. Copie o seguinte comando:

    docker exec -u root -it {old-local-deployment-name} sh -c "mkdir -p /data/dump && chown -R mongod:mongod /data/dump && mongodump --archive=/data/dump/dump.archive"

  2. Substitua o espaço reservado {old-local-deployment-name} pelo nome da sua antiga implantação local do Atlas .

  3. Execute o comando.

3

Copie o arquivo.

  1. Copie o seguinte comando:

    docker cp {old-local-deployment-name}:/data/dump/dump.archive .

  2. Substitua o espaço reservado {old-local-deployment-name} pelo nome da sua antiga implantação local do Atlas .

  3. Execute o comando.

4

Devolva a nova string de conexão.

atlas local connect --connectWith connectionString
5

Restaure a partir do arquivo arquivado.

  1. Copie o seguinte comando:

    mongorestore --uri={connection-string} --archive=./dump.archive

  2. Substitua o placeholder {connection-string} pelo connection sring.

  3. Execute o comando.

6

(Opcional) Exclua o sistema local antigo do Atlas .

atlas local delete

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

Utilize o comando atlas local search indexes create para criar um índice de pesquisa do MongoDB Search. Você pode então executar queries de pesquisa do MongoDB . Para aprender mais, consulte MongoDB Search.

Para obter etapas detalhadas, consulte Criar um índice de pesquisa do MongoDB e Executar uma query.

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

Use o comando atlas local search indexes create para trabalhar com a pesquisa vetorial do MongoDB. Para aprender mais, consulte Como Indexar Embeddings para pesquisa vetorial.

Para etapas detalhadas, consulte Utilizar MongoDB Vector Search com uma implantação Atlas.

Importante

Para utilizar o Atlas CLI com MongoDB Vector Search, você deve criar uma implantação do Atlas com MongoDB 7.0.5 ou posterior. Se você criou uma implantação local do 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ê deve criar uma nova implantação do Atlas .

Ações suportadas

Para aprender todas as ações compatíveis com atlas local, consulte atlas-local.

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

Nesta página