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

Criar uma implantação local do Atlas com Docker

Nesta página

  • Criar uma implantação local do Atlas com Docker
  • Criar um Sistema do Atlas Local com o Docker Compose
  • Persistência de dados em execuções com o Docker Compose
  • Gerar uma lista de dependências
  • Verificar a assinatura da imagem
  • Execute a imagem com ações do Github
  • Converter imagem oficial em um sistema local do Atlas

Este tutorial mostra como criar um sistema local do Atlas com Docker. Neste tutorial, implantaremos um conjunto de réplicas de nó único com Docker.

Importante

Visualização pública

As implantações locais no Docker e Docker Compose 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 oFórum da comunidade de desenvolvimento local do Atlas CLI .

Criar uma implantação local do Atlas com Docker

1

Instale e inicie o Docker.

Para saber mais,consulte a documentação do Docker.

2

Puxe para baixo a mongodb/mongodb-atlas-local imagem do Docker.

Exemplo:

docker pull mongodb/mongodb-atlas-local:latest
3

Execute a imagem do Docker.

Exemplo:

docker run -p 27017:27017 mongodb/mongodb-atlas-local

Importante

Se sua máquina local executar o MacOS Sequoia 15.2 com o processador Apple Silicon M,4 adicione o seguinte parâmetroJVM do ao docker run comando para evitar que seu container falhe na inicialização. Por exemplo:

docker run -e JAVA_TOOL_OPTIONS="-XX:UseSVE=0" -p 27017:27017 mongodb/mongodb-atlas-local
docker run -e MONGODB_INITDB_ROOT_USERNAME=user -e MONGODB_INITDB_ROOT_PASSWORD=pass -p 27017:27017 mongodb/mongodb-atlas-local

Importante

Se a máquina local executar o MacOS Sequoia 15.2 com o processador Apple Silicon M,4 adicione o seguinte parâmetro JVM ao docker run comando para evitar que o container falhe na inicialização. Por exemplo:

docker run -e JAVA_TOOL_OPTIONS="-XX:UseSVE=0" -p 27017:27017 mongodb/mongodb-atlas-local

Os registros são exibidos conforme a imagem do Docker é executada.

4

Conecte-se ao sistema Atlas local.

Para se conectar à implantação local do Atlas a partir do host (não do container), copie e cole o seguinte comando em um novo terminal e substitua a variável {connection_string} por sua string de conexão.

Observação

O exemplo a seguir usa mongosh, mas você pode usar o método de conexão de sua preferência.

mongosh {connection_string}

Exemplos:

mongosh "mongodb://localhost:27017/?directConnection=true"
mongosh "mongodb://user:pass@localhost:27017/?directConnection=true"

Criar um Sistema do Atlas Local com o Docker Compose

Crie um sistema local do Atlas com Docker Compose.

Observação

Se você tiver uma implementação existente do Atlas baseada no Docker-Compose que criou com a imagem oficial do Docker do MongoDB e que gostaria de converter para usar a imagem Atlas Local Dev, consulte Converter em uma implementação local abaixo.

1

Instale e inicie o Docker.

Para saber mais,consulte a documentação do Docker.

2

Instale o Docker Compose.

Exemplo:

brew install docker-compose

Para saber mais, consulte a documentação de instalação do Docker Compose.

3

Crie um arquivo docker-compose.yaml.

Crie o arquivo docker-compose.yaml no mesmo diretório do qual você executa o Docker Compose.

Exemplo:

1services:
2  mongodb:
3    image: mongodb/mongodb-atlas-local
4    environment:
5      - MONGODB_INITDB_ROOT_USERNAME=user
6      - MONGODB_INITDB_ROOT_PASSWORD=pass
7    ports:
8      - 27018:27017
4

Execute o Docker Compose.

O comando abaixo cria um sistema Atlas local com os recursos do Atlas Search habilitados.

Exemplo:

docker-compose up
5

Conecte-se ao sistema Atlas local.

Para se conectar à implantação local do Atlas a partir do host (não do container), copie e cole o seguinte comando em um novo terminal e substitua a variável {connection_string} por sua string de conexão.

Observação

O exemplo a seguir usa mongosh, mas você pode usar o método de conexão de sua preferência.

mongosh {connection_string}

Exemplo:

mongosh "mongodb://user:pass@localhost:27018/?directConnection=true"
6

(Opcional) Pare o contêiner.

docker compose down -v

Persistência de dados em execuções com o Docker Compose

Você pode persistir dados em várias execuções com o Docker Compose. A persistência dos dados ajuda a garantir que os dados não sejam perdidos entre as execuções. Os dados permanecem disponíveis em todas as execuções do Docker Compose.

1

Instale e inicie o Docker.

Para saber mais,consulte a documentação do Docker.

2

Instale o Docker Compose.

Exemplo:

brew install docker-compose

Para saber mais, consulte a documentação de instalação do Docker Compose.

3

Crie um arquivo docker-compose.yaml.

Atualize o arquivo docker-compose.yaml para montar os diretórios de dados necessários como volumes.

Exemplo:

1services:
2  mongodb:
3    hostname: mongodb
4    image: mongodb/mongodb-atlas-local
5    environment:
6      - MONGODB_INITDB_ROOT_USERNAME=user
7      - MONGODB_INITDB_ROOT_PASSWORD=pass
8    ports:
9      - 27019:27017
10    volumes:
11      - data:/data/db
12      - config:/data/configdb
13volumes:
14  data:
15  config:
4

Execute o Docker Compose.

O comando abaixo cria um sistema Atlas local com os recursos do Atlas Search habilitados.

Exemplo:

docker-compose up

Você também pode executar o Docker Compose no modo independente.

Exemplo:

docker-compose up -d
5

Conecte-se ao sistema Atlas local.

Para se conectar à implantação local do Atlas a partir do host (não do container), copie e cole o seguinte comando em um novo terminal e substitua a variável {connection_string} por sua string de conexão.

Observação

O exemplo a seguir usa mongosh, mas você pode usar o método de conexão de sua preferência.

mongosh {connection_string}

Exemplo:

mongosh "mongodb://user:pass@localhost:27019/?directConnection=true"

Gerar uma lista de dependências

Você pode gerar uma lista das dependências para a imagem do Docker do mongodb/mongodb-atlas-local .

1

Instale o syft.

Exemplo:

brew install syft

Para saber mais, consulte o README do syft.

2

Execute o syft.

syft mongodb/mongodb-atlas-local

Verificar a assinatura da imagem

Você pode verificar a assinatura da imagem do Docker do mongodb/mongodb-atlas-local .

1

Instale o cosign.

Exemplo:

brew install cosign

Para saber mais,consulte a Instalação do cosign.

2

Execute os seguintes comandos.

Exemplo:

curl -O https://cosign.mongodb.com/mongodb-atlas-local.pem
COSIGN_REPOSITORY="docker.io/mongodb/signatures" cosign verify --private-infrastructure --key=./mongodb-atlas-local.pem "mongodb/mongodb-atlas-local";

Execute a imagem com ações do Github

Para executar a imagem do Docker do mongodb/mongodb-atlas-local com ações do Github , crie um arquivo de fluxo de trabalho. Para saber mais, consulte o Github Início rápido de ações do .

Exemplo:

Crie o seguinte arquivo mongodb.yml no diretório .github/workflows :

on:
  push:
    branches:
      - main
  pull_request:
jobs:
  run:
    runs-on: ubuntu-latest
    services:
      mongodb:
        image: mongodb/mongodb-atlas-local
        ports:
          - 27017:27017
    steps:
      - name: install mongosh
        run: |
         curl --output mongosh.deb https://downloads.mongodb.com/compass/mongodb-mongosh_2.2.1_amd64.deb
         sudo dpkg -i mongosh.deb
         mongosh --version
     - run: mongosh 'mongodb://localhost/?directConnection=true' --eval 'show dbs'

Converter imagem oficial em um sistema local do Atlas

Se você tiver uma implementação existente do Atlas em execução no Docker Compose que você criou com a imagem oficial do Docker do mongo, poderá consultar a seguinte lista de verificação para simplificar sua conversão para a imagem mongodb-atlas-local.

  1. Remova qualquer command existente do seu arquivo docker-compose.yaml. Como o command em uma definição do Docker Compose substitui o ENTRYPOINT definido na imagem mongodb-atlas-local, você deve remover qualquer command existente para que a imagem mongodb-atlas-local seja executada conforme projetado.

  2. Não há necessidade de definir uma verificação de integridade para o sistema do Atlas , pois esse recurso está integrado na imagem mongodb-atlas-local.

Exemplo de atualizações de composição do Docker

Os exemplos a seguir ilustram as prováveis alterações necessárias no arquivo YAML do Docker Compose:

services:
  self_built_atlas_implementation:
    image: mongo:8.0
    ports:
      - 27017:27017
    command: ["./entrypoint.sh"]  # You may have defined a health check for the database in the entrypoint script.
services:
  local_dev_atlas:
    image: mongodb/mongodb-atlas-local:8.0
    hostname: local_dev_atlas
    ports:
      - 27017:27017
    environment:
      - MONGODB_INITDB_ROOT_USERNAME=user
      - MONGODB_INITDB_ROOT_PASSWORD=pass
    volumes:
      - data:/data/db
      - config:/data/configdb
volumes:
  - data:
  - config:

Voltar

Crie uma implantação local.

Próximo

Use o Atlas Search