Instalando o Driver do MySQL e MariaDB no Container Docker do Alfresco

Sexta, 16 Mai 2025
Escrito por Marcio Junior Vieira
Publicado em Tutoriais Alfresco ECM e BPM
Hits: 176

Algumas empresas que usam Alfresco com Docker tem restrições acesso a internet devido a regulamentos de segurança, para evitar este download a cada vez que o container é criado podemos deixar previamente instalado o driver na imagem na hora do build. Neste tutorial mostramos como fazer isso com o driver do MySQL mais o mesmo pode ser adaptado a mariaDB, PostgreSQL e demais databasesc suportados pelo Alfresco.

Vantagens desta abordagem:

Permite embutir o driver JDBC diretamente na imagem do Alfresco, garantindo funcionamento offline, evitando downloads em tempo de execução e reduzindo falhas em ambientes controlados ou sem acesso à internet.

Pré-requisitos deste tutorial.

Ter um Alfresco instalado com Alfresco Installer.
Conhecimento Básico de Alfresco, Docker e docker-compose.

Versões.

Este artigo foi desenvolvido com a versão Alfresco 23, e deve funcionar em suar versões superiores.

Personalização na imagem Docker.

Crie um diretório para armazenamento dos drivers, neste artifo consideraremos que seu Alfresco esta em /opt/alfresco
```
cd /opt/alfresco
mkdir alfresco/drivers
```

Realize o download do driver na pasta

cd alfresco/drivers
wget https://repo1.maven.org/maven2/mysql/mysql-connector-java/8.0.30/mysql-connector-java-8.0.30.jar

Altere o DockerFile do Alfresco, adicionar após os demais comandos COPY
```
...
COPY drivers $TOMCAT_DIR/lib
...
```
Comente todas as linhas do if que realizam o download do MySQL/MariaDB no Dockerfile, inicia em if e termina em fi conforme abaixo.
** Atenção no exemplo abaixo o restante do arquivo foi suprimido (...)
```
...
#RUN if [ "$DB" == "mariadb" ...
#...

#...
...
```
Agora basta parar o Alfresco e executar o start do Alfresco com a opção --build do docker.
```
docker-compose down
docker-compose up -d --build
```
Pronto o Alfresco não precisa mais do download do Driver do banco de dados..

Sobre o Alfresco ECM.

O Alfresco é uma plataforma de software para gestão de conteúdo (ECM) integrado com softwares de gestão de processo (BPMs), com licença open Source (Apache 2.0) e mantido pela Hyland.

Sobre a Edtech Ambiente Livre.

É uma Spinoff que está em Beta na Ambiente Livre e já tem um treinamento lançado em EAD sob demanda sobre Alfresco:

Conheça o treinamento On demand de Alfresco em : https://www.ambientelivre.com.br/treinamento/alfresco/fundamental.html

A plataforma e 100% Open Source!

Sobre a Ambiente Livre

A Ambiente Livre é especialista em Open Source e Free Software e tem uma divisão especialista em ECM e BPM. Fornece implantação, integração, suporte, consultoria e treinamento em ECM e BPM com as plataformas Alfresco, Activiti, Flowable, Camunda e Operaton.

Já capacitou centenas de empresas para trabalhar com Business Intelligence, ECM, BPM, CRM e Big Data e usa uma metodologia própria de ensino.

Conheça também as divisões de Business Intelligence, CRM e CMS e Big Data e Data Science.

Referências.

Alfresco Transformer from PDF to OCRd PDF - https://github.com/aborroy/alf-tengine-ocr
Tesseract https://github.com/tesseract-ocr/tesseract
Alfresco Installer - https://github.com/aborroy/alfresco-installer

Autor

Marcio Junior Vieira

22 anos de experiência em informática, vivência em desenvolvimento e análise de sistemas de gestão empresarial e ciência de dados.
CEO da Ambiente Livre atuando como Cientista de Dados, Engenheiro de Dados e Arquiteto de Software.
Professor dos MBAs em Big Data & Data Science, Inteligência Artificial e Business Intelligence da Universidade Positivo.
Professor de BPM no MBA de Business Intelligence da Universidade Positivo.
Professor do MBA Artificial Intelligence e Machine Learning da FIAP.
Pesquisador pela Universidade de Brasília no Laboratório de Tecnologias da Tomada de Decisão - UnB/LATITUDE.
Graduado em Tecnologia em Informática(2004) e pós-graduado em Software Livre(2005) ambos pela UFPR.
Palestrante FLOSS em: FISL, The Developes Conference, Latinoware, Campus Party, Pentaho Day, Ticnova, PgDay e FTSL.
Organizador Geral: Pentaho Day 2017, 2015, 2019 e apoio nas ed. 2013 e 2014.
Data Scientist, instrutor e consultor de Big Data e Data Science com tecnologias abertas.
Ajudou a capacitar equipes de Big Data na IBM, Accenture, Tivit, Sonda, Serpro, Dataprev, Natura, MP, Netshoes, Embraer entre outras.
Especialista em implantação e customização de Big Data com Hadoop, Spark, Pentaho, Cassandra e MongoDB.
Contribuidor de projetos open sources ou free software internacionais, tais como Pentaho, Apache Hop, LimeSurvey, SuiteCRM e Camunda.
Especialista em implantação e customização de ECM com Alfresco e BPM com Activiti, Flowable e Camunda.
Certificado (Certified Pentaho Solutions) pela Hitachi Vantara (Pentaho inc).
Ganhou o prêmio Camunda Champion em 2022 em reconhecimento a suas contribuições com o projeto Open Source Camunda.
Membro da The Order Of de Bee (Comunidade Alfresco trabalhando para desenvolver o ecossistema Alfresco independente)

Tutoriais Alfresco