Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
A imagem oficial do MySQL para Docker permite executar um servidor MySQL totalmente configurado em um contêiner. Ela cuida da inicialização, da criação de usuários e da configuração do diretório de dados automaticamente por meio de variáveis de ambiente.

Início Rápido

Conecte-se a partir da máquina host:
Ou conecte-se dentro do contêiner:

Variáveis de Ambiente

MYSQL_USER e MYSQL_PASSWORD precisam ser definidos juntos. O usuário criado recebe acesso total a MYSQL_DATABASE.

Dados Persistentes com Volumes

Sem um volume, todos os dados são perdidos quando o contêiner é removido. Monte um volume para persistir o diretório de dados:
O volume nomeado (mysql-data) persiste entre reinicializações e remoções do contêiner. Para usar um diretório do host em vez disso:
O diretório de dados é dono dos dados e dos logs do MySQL. Nunca compartilhe um volume entre dois contêineres MySQL em execução.

Escolhendo uma Imagem e uma Estratégia de Volume

Para a maioria das cargas de trabalho, os volumes nomeados são o padrão certo. Os bind mounts são úteis quando você precisa inspecionar ou editar o diretório de dados diretamente a partir do host, mas o custo de desempenho importa no macOS e no Windows.

Docker Compose

Para ambientes de desenvolvimento com vários serviços, o Docker Compose é a abordagem padrão:
O healthcheck com depends_on: condition: service_healthy garante que o contêiner da aplicação não inicie até que o MySQL esteja pronto para aceitar conexões — e não apenas iniciado.

Configuração Personalizada

Passe um my.cnf personalizado montando-o:
Ou defina as opções diretamente por argumentos de comando:

Scripts de Inicialização

O contêiner executa qualquer arquivo .sql ou .sh colocado em /docker-entrypoint-initdb.d/ na primeira inicialização (quando o diretório de dados está vazio):
Os arquivos SQL são executados como root. Os scripts de shell rodam no ambiente do contêiner. Esses scripts só rodam na primeira inicialização — e não nas inicializações seguintes do contêiner.

Conectando a partir de Aplicações

Dentro de uma rede do Docker Compose, os contêineres se conectam ao MySQL pelo nome do serviço:
A partir da máquina host, conecte-se por 127.0.0.1 (e não localhost — o socket do MySQL não está disponível no host):

Quando Executar o MySQL no Docker

Considerações para Produção

O Docker funciona bem para o MySQL em produção, com algumas ressalvas:
  • Persistência de dados: Use volumes nomeados ou bind mounts. Nunca deixe os dados do MySQL na camada do contêiner.
  • Limites de memória: Defina --memory no Docker para impedir que o MySQL esgote a memória do host, e ajuste innodb_buffer_pool_size para corresponder.
  • Backups: mysqldump funciona dentro do contêiner: docker exec mysql-dev mysqldump -u root -p myapp > backup.sql
  • Logs: Os logs do MySQL vão para stdout/stderr no Docker. Use docker logs mysql-dev ou configure o seu driver de logs.
  • Atualizações: Baixe a nova tag da imagem, pare o contêiner antigo e inicie o novo com o mesmo volume. O processo de atualização do MySQL roda automaticamente na primeira inicialização com uma versão mais nova.

Perguntas Frequentes

Por que não consigo me conectar com mysql -h localhost a partir do host?

No Linux e no macOS, localhost faz o cliente MySQL tentar se conectar pelo socket Unix, que não está disponível no host. Use 127.0.0.1 explicitamente: mysql -h 127.0.0.1 -P 3306.

Como faço os dados do MySQL persistirem no Docker?

Monte um volume nomeado em /var/lib/mysql ao iniciar o contêiner: -v mysql-data:/var/lib/mysql. Sem isso, todos os dados são armazenados na camada gravável do contêiner e perdidos quando você executa docker rm. Os volumes nomeados sobrevivem à remoção do contêiner e são gerenciados pelo Docker — use docker volume ls para listá-los e docker volume inspect mysql-data para encontrar o local de armazenamento. No Docker Compose, declare o volume sob a chave volumes: de nível superior e referencie-o na lista volumes: do serviço (o exemplo na seção Docker Compose acima mostra esse padrão).

Como os contêineres no Docker Compose se conectam ao MySQL?

Os contêineres no mesmo projeto Compose compartilham uma rede padrão. O contêiner da sua aplicação se conecta ao MySQL usando o nome do serviço como hostname — se o seu serviço de banco de dados se chama db, a string de conexão é host=db port=3306. Você não precisa expor portas entre os contêineres; o mapeamento de portas (-p 3306:3306) só é necessário para conexões a partir da máquina host. Use depends_on: condition: service_healthy com um healthcheck no serviço do MySQL para impedir que a aplicação inicie antes que o MySQL esteja pronto.

Como executo um arquivo SQL em um contêiner em execução?

Solução de Problemas

Tudo nesta página também funciona com a imagem villagesql/server. O VillageSQL é um substituto direto para o MySQL com extensões, então os arquivos compose, os volumes e as verificações de integridade acima se transferem com uma única mudança de nome de imagem. Experimente no Docker.

Veja também