Docker é ideal para o rápido uso do MariaDB. Primeiro, baixe uma imagem adequada. Em seguida, configure e inicie o container com as definições desejadas. Assim, você testa ou desenvolve de maneira independente do sistema host, em um ambiente controlado.

Vantagens dos ambientes Docker MariaDB

Docker oferece uma maneira simples de disponibilizar MariaDB em ambientes isolados. Você pode iniciar instâncias rapidamente e testar diferentes versões de forma independente. Isso economiza tempo, evita conflitos com instalações locais e cria condições reprodutíveis para desenvolvimento e testes.

Requisitos

Antes de começar, você deve se certificar de que os seguintes requisitos sejam atendidos:

  • Docker já está instalado e em execução no seu sistema
  • Acesso a um terminal (Terminal, PowerShell etc.) com direitos de administrador
  • Opcional para MariaDB: Docker Compose para configurações mais complexas

Instalação do MariaDB via Docker: passo a passo

A seguir, mostramos como instalar o MariaDB via Docker em poucos passos. Explicamos detalhadamente como configurar o Docker em nosso tutorial do Docker.

Passo 1: instalar o Docker

Caso ainda não tenha instalado o Docker, você pode configurá-lo usando o script de instalação oficial:

curl -sSL https://get.docker.com/ | sh
bash

Para Windows ou macOS, recomenda-se o Docker Desktop. Após a instalação com sucesso, verifique a funcionalidade com:

docker --version
bash

A saída deve mostrar um número de versão, por exemplo, Docker version 27.5.1, build cb74dfcd. Se for o caso, você configurou o Docker corretamente.

Passo 2: baixar a imagem MariaDB

Agora, baixe a imagem Docker MariaDB oficial do Docker Hub. Esta imagem contém uma instância completamente pré-configurada do MariaDB.

docker pull mariadb:latest
bash

Caso você prefira uma versão mais específica, você também pode especificá-la explicitamente, por exemplo:

docker pull mariadb:10.11
bash

Você pode então verificar todas as imagens armazenadas localmente com o seguinte comando:

docker images
bash

A linha com mariadb e a tag correspondente deve aparecer na lista.

Passo 3: iniciar o Mariadb Docker Container

Agora, crie o container. Para isso, use o comando:

docker run --name mariadb-container -e MYSQL_ROOT_PASSWORD=password -d -p 3306:3306 mariadb:latest
bash
  • --name mariadb-container: atribui ao container um nome específico, pelo qual ele pode ser referenciado no sistema.
  • -e MYSQL_ROOT_PASSWORD=password: define a senha root do banco de dados MariaDB. Você precisará dela posteriormente para fazer login.
  • -d: inicia o container em modo de segundo plano (Detached Mode), assim sua console permanece livre.
  • -p 3306:3306: conecta a porta padrão do banco de dados do container à mesma porta no seu sistema local, permitindo o acesso por clientes.

Após executar este comando, o Docker deve iniciar o container. Para verificar o status, digite:

docker ps
bash

Na lista de containers em execução, o mariadb-container deve aparecer com o status Up. Se o container não estiver funcionando como esperado, você pode verificar os arquivos de log com:

docker logs mariadb-container
bash

A saída dos logs ajuda você a identificar possíveis erros de configuração.

Passo 4: estabelecer acesso ao MariaDB

Assim que o container MariaDB Docker estiver em execução, você poderá acessar o banco de dados com um cliente compatível com MySQL como a ferramenta padrão do MySQL ou ferramentas gráficas como DBeaver, HeidiSQL ou Beekeeper Studio.

Use, por exemplo, o seguinte comando na linha de comando:

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

Você será solicitado a inserir a senha. Digite a senha que você definiu com MYSQL_ROOT_PASSWORD.

Se tudo funcionar, você terá acesso ao console do MariaDB. Lá, você poderá executar comandos SQL como de costume:

SHOW DATABASES;
sql

Você verá uma lista das bases de dados padrão e agora pode criar suas próprias bases de dados ou tabelas.

Cloud Compute Engine da IONOS

Empresas de médio e grande porte optam pela nuvem da Alemanha. Serviços IaaS e PaaS são para campeões.

  • Seguro
  • Confiável
  • Flexível

Passo 5: proteger dados persistentes com volumes

Por padrão, os dados no contêiner são voláteis. Para proteger seus dados em reinicializações ou trocas de contêiner, você deve usar um volume:

docker run --name mariadb-container -e MYSQL_ROOT_PASSWORD=password -d \
 -v mariadb_data:/var/lib/mysql \
 -p 3306:3306 mariadb:latest
bash

-v mariadb_data:/var/lib/mysql cria um volume Docker chamado mariadb_data e o vincula ao diretório onde o MariaDB armazena seus dados.

Você pode visualizar os volumes armazenados a qualquer momento com o seguinte comando:

docker volume ls
bash

E com este comando, inspecione o conteúdo de um volume:

docker volume inspect mariadb_data
bash

Passo 6: gerenciar MariaDB com Docker Compose

Para configurações mais complexas, você deve utilizar o Docker Compose. Para isso, crie um arquivo docker-compose.yml com o seguinte conteúdo:

version: '3.1'
services:
 mariadb:
  image: mariadb:latest
  container_name: mariadb-compose
  environment:
   MYSQL_ROOT_PASSWORD: password
   MYSQL_DATABASE: example_db
  ports:
   - "3306:3306"
  volumes:
   - mariadb_data:/var/lib/mysql
volumes:
 mariadb_data:
yaml

Inicie o ambiente com:

docker-compose up -d
bash

Em seguida, o MariaDB funciona continuamente em segundo plano, incluindo armazenamento persistente e banco de dados pré-configurado.

Passo 7: parar, iniciar e remover o container

A administração de containers é muito fácil com o Docker. Você pode parar ou reiniciar o container do mariadb docker a qualquer momento, sem perda de dados - desde que utilize volumes.

Parar container:

docker stop mariadb-container
bash

Iniciar container:

docker start mariadb-container
bash

Remover container:

docker rm mariadb-container
bash

Excluir container juntamente com volume:

docker rm -v mariadb-container
bash

Passo 8: reinício automático do container

Para garantir que seu container de MariaDB Docker reinicie automaticamente após uma reinicialização do sistema host, você pode definir a política de reinício (Restart-Policy):

docker run --name mariadb-container -e MYSQL_ROOT_PASSWORD=password \ 
 -v mariadb_data:/var/lib/mysql \ 
 -p 3306:3306 \ 
 --restart unless-stopped \ 
 -d mariadb:latest
bash

--restart unless-stopped garante que o container inicie automaticamente após uma reinicialização do sistema, a menos que você o tenha parado manualmente.

Este artigo foi útil?
Ir para o menu principal