Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
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 usar o comando atlas local para criar uma implantação local do Atlas. Este tutorial implanta 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 a MongoDB pesquisa vetorial.

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 em 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. (Optional) Install mongosh version 2.0 or later.

    brew install mongosh

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

  4. (Optional) Install Compass version 1.39.4 or later.

    brew install mongodb-compass

    For installation instructions on other operating systems, see Download and Install 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.

If you don't already have an existing Atlas account, run atlas setup in your terminal or create a new account.

Observação

Uma implantação local do Atlas usa rede local. Confirme se a porta especificada (padrão: atribuição dinâmica) está disponível em localhost (127.0.0.1). Nenhuma configuração de nuvem privada virtual (VPC), firewall ou proxy é necessária.

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

Verificar a implantação

Depois de criar sua implantação, confirme se ela está em execução e se você pode se conectar a ela.

checkpoint
Etapa de verificação

O Docker está em execução

Execute docker ps. O comando é concluído sem erros.

Implantação criada

A saída da CLI mostra Deployment created! com uma string de conexão.

A conexão é bem-sucedida

Run atlas local connect or connect with mongosh using the connection string.

Dados de amostra disponíveis (opcional)

Se você carregou dados de amostra, query um banco de dados de amostra para confirmar se os dados estão presentes.

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. Obtenha o número da porta para sua implantação executando o seguinte comando e selecionando sua implantação:

    atlas local connect --connectWith connectionString

    A string de conexão inclui o número da porta. Por exemplo, na string de conexão mongodb://localhost:27017/?directConnection=true, o número da porta é 27017.

  3. Obtenha o número da porta para a sua implantação:

    1. Copie o seguinte comando:

      atlas local connect <deployment name> --connectWith connectionString

    2. Substitua <deployment name> pelo nome da sua implantação.

    3. Execute o comando.

      A string de conexão inclui o número da porta. Por exemplo, na string de conexão mongodb://localhost:27017/?directConnection=true, o número da porta é 27017.

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

Use the atlas local search indexes create command to create an MongoDB Search search index. You can then run MongoDB Search queries. To learn more, see 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 the atlas local search indexes create command to work with MongoDB Vector Search. To learn more, see How to Index Vector Embeddings for Vector Search.

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.

Próximos passos

Depois de criar e verificar sua implantação local do Atlas, você pode:

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
Avalie esta página

Nesta página