Como usar o MariaDB com Docker

Para usar o Docker e o docker-compose, você precisa tê-los instalados na sua máquina. Se ainda não os tiver, siga as instruções no site do Docker para instalá-los.

Baixe a imagem Docker do MariaDB

Primeiro, precisamos baixar a imagem do MariaDB do Docker Hub. Essa imagem contém tudo o que é necessário para executar o MariaDB.

docker pull mariadb:latest

Este comando baixa a versão mais recente da imagem do MariaDB. Você pode especificar uma versão específica, se precisar:

docker pull mariadb:10.5

Crie uma rede Docker (opcional)

Criar uma rede personalizada melhora a comunicação entre os containers. Esta etapa é opcional, mas recomendada para configurações mais complexas com vários containers.

docker network create mariadb_network

Execute um container MariaDB

Agora, vamos executar um container MariaDB usando a imagem que acabamos de baixar. Vamos mapear uma porta local para a porta do container e definir algumas variáveis de ambiente para a senha do root e o nome do banco de dados.

docker run --name mariadb-container -d \
    --network mariadb_network \
    -e MYSQL_ROOT_PASSWORD=my-secret-pw \
    -e MYSQL_DATABASE=mydatabase \
    -p 3306:3306 \
    mariadb:latest

• –name mariadb-container: dá um nome ao container para facilitar a referência.
• -d: executa o container em modo detached (em segundo plano).
• –network mariadb_network: conecta o container à rede personalizada.
• -e MYSQL_ROOT_PASSWORD=my-secret-pw: define a senha do root do MariaDB.
• -e MYSQL_DATABASE=mydatabase: cria um banco de dados chamado mydatabase.
• -p 3306:3306: mapeia a porta 3306 do host para a porta 3306 do container.

Verifique se o container MariaDB está em execução

Use o comando a seguir para verificar se o container MariaDB está em execução:

docker ps

Saída esperada:

CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS         PORTS                    NAMES
abc123def456   mariadb:latest "docker-entrypoint.s…"   5 seconds ago   Up 5 seconds   0.0.0.0:3306->3306/tcp   mariadb-container

Conectando ao container MariaDB

Agora que o container MariaDB está em execução, você pode se conectar a ele usando um cliente MySQL. Se você tem o cliente MySQL instalado localmente, conecte-se com:

mysql -h 127.0.0.1 -P 3306 -u root -p

Depois de digitar a senha do root (my-secret-pw), você estará conectado à sua instância do MariaDB.

Usando o Docker Compose

O Docker Compose gerencia configurações com vários containers a partir de um arquivo de configuração simples. Veja como configurar o MariaDB usando o Docker Compose:

Crie um arquivo docker-compose.yml

Crie um arquivo docker-compose.yml no diretório raiz do seu projeto. Esse arquivo define os containers que você quer executar como parte do seu ambiente de desenvolvimento.

version: '3.1'

services:
  mariadb:
    image: mariadb:latest
    container_name: mariadb-compose
    environment:
      MYSQL_ROOT_PASSWORD: my-secret-pw
      MYSQL_DATABASE: mydatabase
    ports:
      - "3306:3306"
    networks:
      - mariadb_network

networks:
  mariadb_network:
    driver: bridge

Neste exemplo, usamos a imagem mariadb:latest e definimos várias variáveis de ambiente para configurar o banco de dados. Também expomos a porta padrão do MariaDB (3306) para podermos conectar ao banco de dados a partir da nossa aplicação.

Execute o Docker Compose para iniciar o container:

docker-compose up -d

Saída esperada:

Creating network "projectname_mariadb_network" with driver "bridge"
Creating mariadb-compose ... done

Este comando baixa as imagens necessárias e inicia os containers em segundo plano. Execute sem -d para iniciar o container em primeiro plano. Você pode usar o comando a seguir para ver o status dos containers:

docker-compose ps

Conectando ao MariaDB pelo Beekeeper Studio

Baixe o Beekeeper Studio (grátis) >

O Beekeeper Studio é um editor SQL open source com suporte ao MariaDB. Veja como conectar à sua instância MariaDB no Docker usando o Beekeeper Studio:

1. Abra o Beekeeper Studio e clique em New Connection.
2. Selecione MariaDB como tipo de conexão.
3. Informe os seguintes dados de conexão:
   • Host: 127.0.0.1
   • Porta: 3306
   • Usuário: root
   • Senha: my-secret-pw
   • Banco de dados: mydatabase (opcional)
4. Clique em Connect para estabelecer a conexão.

Você terá uma interface bonita e agradável para editar e consultar seu banco de dados MariaDB:

Gerenciando seu ambiente de desenvolvimento

Para parar o container MariaDB:

docker stop mariadb-container

Para iniciar o container novamente:

docker start mariadb-container

Para remover o container:

docker rm -f mariadb-container

Conclusão

Configurar um ambiente de desenvolvimento MariaDB com Docker oferece uma estrutura robusta, fácil de gerenciar e replicar. Usar o Docker Compose adiciona escalabilidade, tornando-o uma excelente escolha tanto para projetos pequenos quanto para equipes de desenvolvimento maiores.

Outros artigos que você pode gostar:

• Como criar um usuário no MariaDB
• Comparando PostgreSQL e MariaDB