Como Subir um Banco de Dados Neo4j no Docker: Um Guia Passo a Passo

Por Gaspar Barancelli Junior em 20 de abril de 2024

Bancos de dados NoSQL estão se tornando cada vez mais populares devido à sua flexibilidade e escalabilidade. O Neo4j, um banco de dados de grafo altamente escalável, é uma excelente opção para lidar com dados altamente conectados. Neste guia, vou mostrar como você pode facilmente configurar um banco de dados Neo4j no Docker em apenas alguns passos simples.

Passo 1: Instalação do Docker

Se você ainda não tem o Docker instalado, este é o primeiro passo. Você pode instalá-lo seguindo as instruções oficiais em https://docs.docker.com/get-docker/.

Passo 2: Inicie o Contêiner Neo4j

Usando Docker Run

Para iniciar o contêiner Neo4j, abra seu terminal e execute o seguinte comando:

docker run --name meu-neo4j -p 7474:7474 -p 7687:7687 -d neo4j

Este comando baixará a imagem do Neo4j do Docker Hub e iniciará um contêiner com o nome "meu-neo4j". Os parâmetros -p 7474:7474 e -p 7687:7687 mapeiam as portas 7474 (HTTP) e 7687 (BOLT) do contêiner para as mesmas portas no host.

Usando Docker Compose

Você também pode configurar o Neo4j para ser executado com o Docker Compose. Crie um arquivo docker-compose.yml no seu diretório de trabalho e adicione o seguinte conteúdo:

version: '3'
services:
  neo4j:
    image: neo4j
    container_name: meu-neo4j
    ports:
      - "7474:7474"
      - "7687:7687"

Para iniciar o contêiner Neo4j, execute o seguinte comando:

docker-compose up -d

Passo 3: Acessando o Neo4j

Agora que o contêiner Neo4j está em execução, você pode acessar o Neo4j Browser em seu navegador da web, no endereço http://localhost:7474.

Quando solicitado, insira as credenciais padrão:

Usuário: neo4j
Senha: neo4j

Figure 1. Print da tela inicial do Neo4j Browser

Você será solicitado a definir uma nova senha. Após fazer isso, você terá acesso ao console do Neo4j.

Figure 2. Print da tela de mudança de senha do Neo4J

Passo 4: Conectando-se ao Neo4j via Cliente

Você também pode se conectar ao seu banco de dados Neo4j usando um cliente. Para isso, você poderá conectar por localhost ou pelo IP do contêiner. Execute o seguinte comando para obtê-lo:

docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' meu-neo4j

Use o IP obtido com a porta 7687 para se conectar ao seu banco de dados Neo4j.

Passo 5: Parando e Removendo o Contêiner

Quando você terminar de usar o banco de dados Neo4j, você pode parar e remover o contêiner executando os seguintes comandos:

docker stop meu-neo4j
docker rm meu-neo4j

Usando Docker Compose:

docker-compose down

Conclusão

Configurar um banco de dados Neo4j no Docker é uma maneira rápida e conveniente de começar a trabalhar com dados de grafo. Com apenas alguns comandos simples, você pode ter um ambiente de desenvolvimento totalmente funcional em execução em seu próprio computador. O uso do Docker facilita ainda mais a configuração, elimina conflitos de dependência e torna a distribuição do ambiente de desenvolvimento uma tarefa simples. Com este guia, espero ter facilitado a jornada de começar a trabalhar com o Neo4j em seu ambiente de desenvolvimento local.