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.

Você deve usar implantações locais somente para teste e desenvolvimento.

Importante

Visualização pública

O comando atlas deployments e comandos relacionados subsequentes estão disponíveis como uma visualização pública. O recurso e a documentação correspondente podem ser alterados a qualquer momento no estágio de pré-visualização pública. Para fazer perguntas e fornecer comentários, consulte o Foro da comunidade de desenvolvimento local do Atlas CLI.

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

Observação

Windows e Ubuntu não são totalmente suportados para implantações locais do Atlas durante o estágio de Visualização Pública.

Concluir os pré-requisitos

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

Importante

Para obter informações de compatibilidade para cada produto de pré-requisito, consulte as páginas de instalação relacionadas.

  • Instale o Atlas CLI.

    Exemplo (MacOS):

    brew install mongodb-atlas-cli

    Para saber mais sobre as instruções de instalação da Atlas CLI para outros sistemas operacionais, consulte Instalar ou Atualizar a Atlas CLI.

  • Instalar o mongosh versão 2.0 ou posterior.

    Exemplo (MacOS):

    brew install mongosh

    Para saber mais sobre as instruções de instalação do mongosh para outros sistemas operacionais, consulte Instalar o mongosh.

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

    Exemplo (MacOS):

    brew install mongodb-compass

    Para saber mais sobre as instruções de instalação do Compass para outros sistemas operacionais, consulte Baixar e instalar o Compass.

  • Instale as ferramentas do banco de dados MongoDB.

    Exemplo (MacOS):

    brew tap mongodb/brew && brew install mongodb-database-tools

    Para saber mais sobre as instruções de instalação das ferramentas de MongoDB database para outros sistemas operacionais, consulte Instalando as Database Tools de dados.

  • Instalar o Podman versão 4.4 e posterior.

    Exemplo (MacOS):

    brew install podman

    Observação

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

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.

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 o sistema à qual 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.

← Sistemas locais em nuvem &
Implante com Docker →

Nesta página