lzocateli/mariadb repository overview

⁠lzocateli/mariadb

Imagem MariaDB 11.4.11 para uso em bancos de dados persistentes em ambientes locais, desenvolvimento e homelab. A imagem usa a variante oficial mariadb:11.4.11-ubi9, mantendo o contrato de runtime e o diretório de dados compatíveis com bind mounts e volumes nomeados.

⁠Referência da imagem

⁠Conteúdo e finalidade

⁠Incluído

• MariaDB 11.4.11 em imagem baseada em UBI 9.
• Variáveis de inicialização do container oficial do MariaDB.
• Suporte a persistência de dados em /var/lib/mysql.
• Porta TCP 3306 exposta para uso no host ou em redes internas.

⁠Não incluído

• Gerenciamento de backup automatizado.
• Configuração de rede pública, TLS ou auth provider externo.
• Banco já carregado com dados; o armazenamento deve ser fornecido pelo consumidor.

⁠Início rápido

docker pull lzocateli/mariadb:11.4.11-ubi9
docker run --rm --name mariadb \
  --publish 127.0.0.1:3306:3306 \
  --env MARIADB_DATABASE=appdb \
  --env MARIADB_USER=appuser \
  --env MARIADB_PASSWORD=change-me \
  --env MARIADB_ROOT_PASSWORD=change-me \
  --volume /srv/mariadb:/var/lib/mysql \
  lzocateli/mariadb:11.4.11-ubi9

⁠Docker Compose

services:
  mariadb:
    image: lzocateli/mariadb:11.4.11-ubi9
    restart: unless-stopped
    ports:
      - "127.0.0.1:3306:3306"
    environment:
      MARIADB_DATABASE: appdb
      MARIADB_USER: appuser
      MARIADB_PASSWORD: change-me
      MARIADB_ROOT_PASSWORD: change-me
    volumes:
      - /srv/mariadb:/var/lib/mysql

⁠Configuração

⁠Variáveis de ambiente

⁠Portas

⁠Persistência e mounts

Use bind mount ou volume nomeado em /var/lib/mysql para preservar dados entre recriações do contêiner. O diretório deve ser de propriedade adequada e acessível pelo processo do MariaDB, com permissões compatíveis com o usuário mysql.

⁠Secrets

Secrets e senhas não devem ser gravadas no Dockerfile, em docker-compose.yml versionado nem em arquivos de build. Use variáveis de ambiente do runtime, arquivos secret no orchestrator ou podman secret/docker secret quando disponível.

⁠Inicialização e ciclo de vida

A imagem usa o entrypoint oficial do MariaDB e executa a inicialização do banco no primeiro boot. Quando o diretório /var/lib/mysql está vazio, o contêiner cria o banco definido por MARIADB_DATABASE, cria o usuário indicado por MARIADB_USER e configura as credenciais informadas. Reinicializações subsequentes preservam o estado dos dados persistidos. O processo principal do contêiner é o mysqld e ele responde a sinais de término do PID 1 do container.

⁠Segurança

A variante Ubuntu e a variante UBI 9 mariadb:11.4.11-ubi9 publicam /usr/local/bin/gosu compilado com Go v1.24.6, que falha no gate CRITICAL corrigivel do Trivy por causa da CVE-2025-68121. O Dockerfile recompila o gosu oficial 1.19 com Go 1.25.7 e o copia para a imagem final, mantendo o entrypoint MariaDB oficial.

Quando uma imagem oficial MariaDB futura trouxer o gosu compilado com uma versao corrigida da stdlib, testar a remocao do estagio gosu-builder e do COPY --from nas variantes Ubuntu e UBI 9. A imagem oficial deve ser preferida novamente se o resultado permanecer verde e o smoke test confirmar o mesmo contrato.

• O contêiner deve ser executado com uma senha para root ou com política controlada de senha aleatória.
• O uso de MARIADB_ALLOW_EMPTY_ROOT_PASSWORD=1 deve ser evitado em produção.
• Preserve o diretório /var/lib/mysql em um volume persistente e restrinja acesso de rede ao banco.
• Atualize a imagem base regularmente e acompanhe vulnerabilidades do MariaDB e do sistema base.
• Evite expor a porta 3306 para a Internet; prefira 127.0.0.1 ou redes internas.

⁠Build local

docker build \
  --pull \
  --tag lzocateli/mariadb:11.4.11-ubi9 \
  .

Para múltiplas plataformas:

docker buildx build \
  --platform linux/amd64,linux/arm64 \
  --tag lzocateli/mariadb:11.4.11-ubi9 \
  .

⁠Tags e compatibilidade

A política de release desta imagem é manter tags imutáveis e documentadas. Alterações de configuração do runtime ou necessidade de compatibilidade exigem revisão do README e do contrato da imagem.

⁠Validação

Antes da publicação, confirme:

• .gitignore e .dockerignore presentes e adaptados à imagem;
• .env, secrets, dados persistentes e backups fora do Git e do contexto Docker;
• .git excluído do contexto Docker;
• análise do Dockerfile com BuildKit;
• build sem cache quando necessário;
• smoke test do processo principal;
• health check;
• execução sem root, quando suportada;
• persistência após recriação;
• plataformas declaradas;
• inspeção de vulnerabilidades;
• geração de SBOM e proveniência;
• labels OCI e tag final.

⁠Publicação

Use Actions > Publicar imagem de container > Run workflow e informe:

• context_path: mariadb;
• image_name: mariadb;
  • image_tag: 11.4.11-ubi9;
• dockerfile: Dockerfile;
• platforms: linux/amd64,linux/arm64.

O workflow publica no Docker Hub e pode sincronizar este README como descrição completa.

⁠Operação

• Monte /var/lib/mysql em volume persistente ou bind mount.
• Acesse o banco localmente em 127.0.0.1:3306 ou via rede interna do host.
• Para backups, faça dump do banco com mysqldump ou snapshot do volume persistente.
• Verifique logs do contêiner ao iniciar ou reiniciar para confirmar que o processo mysqld iniciou sem erros.

⁠Troubleshooting

⁠Limitações conhecidas

• A imagem não inclui painel de gerenciamento, backup automático nem autenticação externa.
• O volume persistente deve ser gerenciado por quem opera a instância.

⁠Licenças e fontes

O badge MIT descreve somente o conteúdo original deste repositório. A imagem inclui componentes de terceiros que permanecem sujeitos aos termos e avisos de suas fontes. Consulte a política de licenciamento⁠, preserve as atribuições upstream e verifique também os avisos distribuídos dentro da imagem.

⁠Histórico de alterações

• 2026-08-19: migração para a variante oficial MariaDB UBI 9 após a falha da variante Ubuntu no gate CRITICAL do Trivy; mantido o plano de reavaliar a variante Ubuntu quando o gosu upstream for atualizado.