Instalar MariaDB via Docker: veja como funciona

Docker é ideal para o rápido uso do MariaDB. Primeiro, baixe uma imagem adequada. Em seguida, configure e inicie o container com as de­fi­ni­ções desejadas. Assim, você testa ou de­sen­volve de maneira in­de­pen­dente do sistema host, em um ambiente con­tro­lado.

Vantagens dos ambientes Docker MariaDB

Docker oferece uma maneira simples de dis­po­ni­bi­li­zar MariaDB em ambientes isolados. Você pode iniciar ins­tân­cias ra­pi­da­mente e testar di­fe­ren­tes versões de forma in­de­pen­dente. Isso economiza tempo, evita conflitos com ins­ta­la­ções locais e cria condições re­pro­du­tí­veis para de­sen­vol­vi­mento e testes.

Re­qui­si­tos

Antes de começar, você deve se cer­ti­fi­car de que os seguintes re­qui­si­tos sejam atendidos:

• Docker já está instalado e em execução no seu sistema
• Acesso a um terminal (Terminal, PowerShell etc.) com direitos de ad­mi­nis­tra­dor
• Opcional para MariaDB: Docker Compose para con­fi­gu­ra­ções mais complexas

Ins­ta­la­ção do MariaDB via Docker: passo a passo

A seguir, mostramos como instalar o MariaDB via Docker em poucos passos. Ex­pli­ca­mos de­ta­lha­da­mente como con­fi­gu­rar 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 ins­ta­la­ção oficial:

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

Para Windows ou macOS, recomenda-se o Docker Desktop. Após a ins­ta­la­ção com sucesso, verifique a fun­ci­o­na­li­dade com:

docker --version

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ê con­fi­gu­rou o Docker cor­re­ta­mente.

Passo 2: baixar a imagem MariaDB

Agora, baixe a imagem Docker MariaDB oficial do Docker Hub. Esta imagem contém uma instância com­ple­ta­mente pré-con­fi­gu­rada do MariaDB.

docker pull mariadb:latest

Caso você prefira uma versão mais es­pe­cí­fica, você também pode es­pe­ci­ficá-la ex­pli­ci­ta­mente, por exemplo:

docker pull mariadb:10.11

Você pode então verificar todas as imagens ar­ma­ze­na­das lo­cal­mente com o seguinte comando:

docker images

A linha com mariadb e a tag cor­res­pon­dente 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

• --name mariadb-container: atribui ao container um nome es­pe­cí­fico, pelo qual ele pode ser re­fe­ren­ci­ado no sistema.
• -e MYSQL_ROOT_PASSWORD=password: define a senha root do banco de dados MariaDB. Você precisará dela pos­te­ri­or­mente 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, per­mi­tindo o acesso por clientes.

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

docker ps

Na lista de con­tai­ners em execução, o mariadb-container deve aparecer com o status Up. Se o container não estiver fun­ci­o­nando como esperado, você pode verificar os arquivos de log com:

docker logs mariadb-container

A saída dos logs ajuda você a iden­ti­fi­car possíveis erros de con­fi­gu­ra­ção.

Passo 4: es­ta­be­le­cer acesso ao MariaDB

Assim que o container MariaDB Docker estiver em execução, você poderá acessar o banco de dados com um cliente com­pa­tí­vel com MySQL como a fer­ra­menta padrão do MySQL ou fer­ra­men­tas 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

Você será so­li­ci­tado 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;

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

Passo 5: proteger dados per­sis­ten­tes com volumes

Por padrão, os dados no contêiner são voláteis. Para proteger seus dados em rei­ni­ci­a­li­za­çõ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

-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 vi­su­a­li­zar os volumes ar­ma­ze­na­dos a qualquer momento com o seguinte comando:

docker volume ls

E com este comando, ins­pe­ci­one o conteúdo de um volume:

docker volume inspect mariadb_data

Passo 6: gerenciar MariaDB com Docker Compose

Para con­fi­gu­ra­çõ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:

Inicie o ambiente com:

docker-compose up -d

Em seguida, o MariaDB funciona con­ti­nu­a­mente em segundo plano, incluindo ar­ma­ze­na­mento per­sis­tente e banco de dados pré-con­fi­gu­rado.

Passo 7: parar, iniciar e remover o container

A ad­mi­nis­tra­ção de con­tai­ners é 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

Iniciar container:

docker start mariadb-container

Remover container:

docker rm mariadb-container

Excluir container jun­ta­mente com volume:

docker rm -v mariadb-container

Passo 8: reinício au­to­má­tico do container

Para garantir que seu container de MariaDB Docker reinicie au­to­ma­ti­ca­mente após uma rei­ni­ci­a­li­za­çã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

--restart unless-stopped garante que o container inicie au­to­ma­ti­ca­mente após uma rei­ni­ci­a­li­za­ção do sistema, a menos que você o tenha parado ma­nu­al­mente.