Alfresco Transform Core

Contains the common transformer (T-Engine) code, plus a few implementations.

Sub-projects

• model - library packaged as a jar file which contains the data model of json configuration files and messages sent between clients, T-Engines and T-Router. Also contains code to to combine and then work out which transform to use for a combination of source and target mimetypes and transform options.
• engines/base - contains code common to t-engines, packaged as a jar. README
• engines/<name> - multiple T-Engines, which extend the engines/base; each one builds a SpringBoot jar and a Docker image
• deprecated/alfresco-base-t-engine - The original t-engine base, which may still be used, but has been replaced by the simpler engines/base README

Documentation

• docs - provides additional documentation.
• ACS Packaging docs folder
• If you're interested in the Alfresco Transform Service (ATS) see https://docs.alfresco.com/transform/concepts/transformservice-overview.html

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-transform-model</artifactId>
    <version>version</version>
</dependency>

<dependency>
    <groupId>org.alfresco</groupId>
    <artifactId>alfresco-base-t-engine</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:

• alfresco/alfresco-transform-core-aio

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:

• ACS Community
• ACS Enterprise

You can find examples of using the individual T-Engines in the reference ACS Deployment for Helm / Kubernetes:

• ACS Community
• ACS Enterprise

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.