Criar uma implantação local do Atlas com Docker

Antes de começar

necessário:

• O Docker está instalado e em execução em sua máquina local.

  • Para macOS ou Windows, instale o Docker Desktop v4.31 ou posterior.

  • Para Linux, instale o Docker mecanismo v27.0 ou posterior.

• Sua máquina tem pelo menos 2 GB de RAM livre e 2 núcleos de CPU.

• A porta que você planeja usar (padrão: 27017) está disponível em localhost.

Recomendado:

• Install mongosh version 2.0 or later to connect to and interact with the deployment.

• Para fluxos de trabalho do Docker Compose, instale Docker Compose v1.27 ou posterior.

Nenhuma configuração de nuvem privada virtual (VPC), firewall ou proxy é necessária. A implantação é executada em rede local.

Criar uma implantação local do Atlas com Docker

docker pull mongodb/mongodb-atlas-local:latest

docker run -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

mongosh {connection_string}

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 uma implantação local do Atlas com Docker Compose. Para obter um exemplo completo e detalhado, consulte Exemplo de composição do Docker.

brew install docker-compose

1
services:
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

docker-compose up

mongosh {connection_string}

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

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

brew install docker-compose

1
services:
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
13
volumes:
14
  data:
15
  config:

docker-compose up

docker-compose up -d

mongosh {connection_string}

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 .

brew install 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 .

brew install cosign

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 Início rápido de ações do Github.

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.

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:

Verificar a implantação

Depois de iniciar seu contêiner, confirme se a implantação está em execução e se você pode se conectar.

Próximos passos

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

• Conecte seu aplicativo: Use a string de conexão na configuração do aplicativo.

• Configure data persistence: Map Docker volumes to retain data across container restarts. See Create a Local Atlas Deployment with Docker for details.

• Use um fluxo de trabalho do Docker Compose: Para aplicativos de vários serviços, integre a implantação em um arquivo docker-compose.yaml. Para obter um exemplo completo, consulte Exemplo do Docker Compose.

• Usar |fts|: Criar e testar índices de pesquisa em sua implantação local. Para etapas detalhadas, consulte Criar um Índice de pesquisa do MongoDB e executar uma query.

• Use o Atlas CLI em vez disso: Para uma implantação local gerenciada por CLI, consulte Criar uma implantação local do Atlas.