VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
Início Rápido
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:mysql-data) persiste entre reinicializações e remoções do contêiner. Para usar um diretório do host em vez disso:
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: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 ummy.cnf personalizado montando-o:
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):
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: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
--memoryno Docker para impedir que o MySQL esgote a memória do host, e ajusteinnodb_buffer_pool_sizepara corresponder. - Backups:
mysqldumpfunciona 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-devou 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 chamadb, 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
- Fundamentos de Replicação no MySQL — executando pares origem/réplica no Docker Compose
- Estratégias de Backup no MySQL — fazendo backup dos volumes de dados em um MySQL em contêiner
- Atualizando a partir do MySQL — movendo um contêiner do MySQL para o VillageSQL
- Executando o MySQL no Kubernetes — o próximo passo na orquestração de contêineres
- Instale um servidor para o tutorial de MySQL — preparando um servidor para aprender SQL