Publicado em
- 4 min read
Tutorial Docker MySQL: Do zero à conexão no DBeaver
Introdução
Olá! O objetivo desse artigo é mostrar de forma prática o passo a passo para você conseguir instalar e utilizar um banco de dados MySQL em um container docker.
Instalação do Docker
Previamente será necessário que você tenha instalado o docker em seu computador. Caso você não tenha, poderá utilizar o link da documentação oficial: https://docs.docker.com/engine/install/.
Criando o container
Aqui é onde a mágica acontece! Execute o comando abaixo para iniciar o processo de criação do container, o docker cuidará de tudo para você! Em seguida vamos entender o comando em detalhes:
docker run --name nome-para-seu-container -p3306:3306 -v data:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=senha-que-sera-utilizada -d mysql:8.3

Ao executar o comando, o Docker verifica se a imagem informada (MySQL versão 8.3) já está disponível localmente. Caso não esteja, ele fará o download (pull) do Docker Hub, criará o container e o iniciará automaticamente.
Detalhando o comando
docker run: Comando para criar e executar o container a partir de uma imagem.
—name nome-para-seu-container: Nome que você quer dar para o seu container (Substitua o nome-para-seu-container com o nome que você escolheu).
-p3306:3306: Mapeia a porta interna do container para a porta do host (seu computador). A porta padrão do MySQL é 3306.
-v data:/var/lib/mysql: Monta um volume nomeado chamado data no caminho de dados do MySQL (diretório informado após os dois pontos). Esse diretório é interno no container e guarda os arquivos do banco de dados.
-e MYSQL_ROOT_PASSWORD=senha-que-será-utilizada: Define uma variável de ambiente dentro do container com a senha do usuário que você informar (A senha é obrigatória).
-d: Executa o container em modo “detached”, ou seja, em segundo plano. Sem isso o terminal ficaria “preso” ao processo do MySQL.
mysql:8.3: É a imagem com a versão utilizada para criar o container. Se você informar apenas o nome da imagem, sem a versão, o Docker utilizará a versão latest (última estável).
Gerenciando o container
Abaixo temos os comandos úteis para gerenciamento de containers no Docker:
| Comando | Explicação |
|---|---|
| docker container ps | Lista apenas os containers em execução. |
| docker container ps -a | Lista todos os containers, inclusive os parados. |
| docker start nome-ou-id-do-container | Inicia um container que está parado. |
| docker stop nome-ou-id-do-container | Para um container em execução de forma segura. |
| docker restart nome-ou-id-do-container | Reinicia um container (para e inicia novamente). |
| docker rm nome-ou-id-do-container | Remove um container que está parado. |
Acessando o banco de dados
Agora que o container está em execução com nosso banco de dados, vamos nos conectar ao mesmo utilizando o Dbeaver que é uma ferramenta para gerenciamento de banco de dados visual, poderosa e de fácil utilização. Caso não tenha instalada em seu computador, segue o link para download do site oficial: https://dbeaver.io/download/
Passo 1
Após abrir o DBeaver, clique no ícone de “plug” para adicionar uma nova conexão com um banco de dados.

Passo 2
Selecione o banco de dados MySQL entre as opções disponíveis.

Passo 3
Preencha os campos de configuração do banco de dados conforme a tabela abaixo:
| Item | Campo | Valor a preencher | Observações |
|---|---|---|---|
| 1 | Host | localhost | Sua máquina local |
| 2 | Port | 3306 | Porta padrão do MySQL |
| 3 | Username | root | Usuário root do MySQL |
| 4 | Password | 123456 | Senha definida na criação do container |

Passo 4
Conclua verificando se ao lado esquerdo do menu a sua conexão está disponível.

Conclusão
Com esse passo a passo, você aprendeu como subir rapidamente um banco de dados MySQL utilizando o Docker, sem complicações e com total controle sobre o ambiente. Essa abordagem é extremamente útil para quem está começando no mundo do desenvolvimento ou para profissionais que precisam de ambientes isolados e reproduzíveis para testes, desenvolvimento local ou até mesmo para ambientes de homologação.
Além disso, ao utilizar o DBeaver, conseguimos uma visualização clara e intuitiva dos dados, facilitando a administração do banco e o acesso às informações. A combinação de Docker e ferramentas como o DBeaver torna o trabalho com bancos de dados mais ágil, moderno e eficiente.
Agora que você já tem tudo funcionando, sinta-se à vontade para explorar mais comandos do Docker, criar múltiplos containers ou até automatizar esse processo em seus projetos.
Bons estudos — e até o próximo artigo!