* commit '2fd8361a783f117592b55bbca4fc7273adf1db49': (25 commits) [maven-release-plugin][skip ci] prepare for next development iteration [maven-release-plugin][skip ci] prepare release 2.5.5-A1 [trigger release] 2.5.5-A1 (#511) [trigger release] 2.5.5-A1 Bump dependency.jackson.version from 2.13.0 to 2.13.1 Bump dependency.cxf.version from 3.4.5 to 3.5.0 Revert "Bump dependency.tika.version from 2.1.0 to 2.2.1" Bump dependency.tika.version from 2.1.0 to 2.2.1 ACS-2002 Enhance T-Router debug (#507) Bump license-maven-plugin from 2.0.0 to 2.0.1.alfresco-1 (#481) Bump bcmail-jdk15on from 1.69 to 1.70 (#492) Bump bcprov-jdk15on from 1.69 to 1.70 (#491) Bump spring-boot-starter-parent from 2.6.0 to 2.6.2 (#504) ACS-2352: Added Veracode agent-based scanning integration. Bump joda-time from 2.2 to 2.10.13 ATS-969 Tika upgrade 1.x -> 2.x (#493) ATS-968 Migrate to CentOS 7 base images (#490) ACS-1983 CentOS 7 base image for the ImageMagic transformer (#489) Update travis linux dist to Focal (#478) Bump spring-boot-starter-parent from 2.5.6 to 2.6.0 ... # Conflicts: # alfresco-transform-core-aio/alfresco-transform-core-aio-boot/pom.xml # alfresco-transform-core-aio/alfresco-transform-core-aio/pom.xml # alfresco-transform-imagemagick/alfresco-transform-imagemagick-boot/pom.xml # alfresco-transform-imagemagick/alfresco-transform-imagemagick/pom.xml # alfresco-transform-libreoffice/alfresco-transform-libreoffice-boot/pom.xml # alfresco-transform-libreoffice/alfresco-transform-libreoffice/pom.xml # alfresco-transform-misc/alfresco-transform-misc-boot/pom.xml # alfresco-transform-misc/alfresco-transform-misc/pom.xml # alfresco-transform-pdf-renderer/alfresco-transform-pdf-renderer-boot/pom.xml # alfresco-transform-pdf-renderer/alfresco-transform-pdf-renderer/pom.xml # alfresco-transform-tika/alfresco-transform-tika-boot/pom.xml # alfresco-transform-tika/alfresco-transform-tika/pom.xml # alfresco-transformer-base/pom.xml # pom.xml
Alfresco Transform Core
Contains the common transformer (T-Engine) code, plus a few actual implementations.
Sub-projects
alfresco-transformer-base
- library packaged as a jar file which contains code that is common to all the transformers; see the sub-project's READMEalfresco-transform-<name>
- multiple T-Engines; each one of them builds both a SpringBoot fat jar and a Docker image
Documentation
In addition to the sub-projects (such as alfresco-transformer-base
README above) some additional documentation can be found in:
- this project's docs folder
- ACS Packaging docs folder
Note: if you're interested in the Alfresco Transform Service (ATS) that is part of the enterprise Alfresco Content Services (ACS) please see:
Building and testing
The project can be built by running the Maven command:
mvn clean install -Plocal,docker-it-setup
The
local
Maven profile builds local Docker images for each T-Engine.
Artifacts
Maven
The artifacts can be obtained by:
- downloading from Alfresco repository
- getting as Maven dependency by adding the dependency to your pom file:
<dependency>
<groupId>org.alfresco</groupId>
<artifactId>alfresco-transformer-base</artifactId>
<version>version</version>
</dependency>
and Alfresco Maven repository:
<repository>
<id>alfresco-maven-repo</id>
<url>https://artifacts.alfresco.com/nexus/content/groups/public</url>
</repository>
Docker
The core T-Engine images are available on Docker Hub.
Either as a single Core AIO (All-In-One) T-Engine:
Or as set of individual T-Engines:
- alfresco/alfresco-imagemagick
- alfresco/alfresco-pdf-renderer
- alfresco/alfresco-libreoffice
- alfresco/alfresco-tika
- alfresco/alfresco-transform-misc
You can find examples of using Core AIO in the reference ACS Deployment for Docker Compose:
You can find examples of using the indivudal T-Engines in the reference ACS Deployment for Helm / Kubernetes:
Release Process
For a complete walk-through check out the
build-and-release.MD
under the docs
folder.
Contributing guide
Please use this guide to make a contribution to the project.