Chapter 7. Configuring custom Maven mirrors

Procedure

1. Edit the SonataFlowPlatform CR to configure a Maven mirror for all workflow builds in a namespace, as shown in the following example:

   Example of Maven mirror configuration in a SonataFlowPlatform CR

   apiVersion: sonataflow.org/v1alpha08
   kind: SonataFlowPlatform
   metadata:
     name: my-platform
   spec:
     build:
       template:
         envs:
           - name: MAVEN_MIRROR_URL
             value: http://my.company.registry.local

   Copy to Clipboard Toggle word wrap

   This configuration applies to all workflow builds in the same namespace that use the preview profile. When a workflow builder instance runs, it updates the internal Maven settings file to use the specified mirror as the default for external locations such as Maven Central.

2. Optional: If you need a specific configuration for a single workflow build, create the SonataFlowBuild CR before creating the corresponding SonataFlow CR. The SonataFlowBuild and SonataFlow CRs must have the same name.

   Example of Maven mirror configuration in a SonataFlowBuild CR

   apiVersion: sonataflow.org/v1alpha08
   kind: SonataFlowBuild
   metadata:
     name: my-workflow 

   1

   
     annotations:
       sonataflow.org/restartBuild: "true" 

   2

   
   spec:
     # suppressed for brevity
     envs:
       - name: MAVEN_MIRROR_URL 

   3

   
         value: http://my.company.registry.local

   Copy to Clipboard Toggle word wrap

   1

   The SonataFlowBuild CR must have the same name as the corresponding SonataFlow CR.

   2

   The sonataflow.org/restartBuild: "true" annotation forces the existing build to restart with the new configuration.

   3

   The MAVEN_MIRROR_URL environment variable specifies the custom Maven mirror.

   Note

   You can use the SonataFlowBuild CR configuration only when you require workflow-specific behavior, for example, debugging. For general use, configure the SonataFlowPlatform CR instead.

Procedure

1. Set the Maven mirror as an environment variable in the Dockerfile as shown in the following example:

   Example of custom container file with Maven mirror set as an environment variable

   FROM docker.io/apache/incubator-kie-sonataflow-builder:main AS builder
   
   # Content suppressed for brevity
   
   # The Maven mirror URL set as an env var during the build process
   ENV MAVEN_MIRROR_URL=http://my.company.registry.local

   Copy to Clipboard Toggle word wrap

   The ENV directive ensures that all builds with this Dockerfile automatically use the specified Maven mirror.

2. Set the Maven mirror as a build-time argument in the Dockerfile as shown in the following example:

   Example of custom container file with Maven mirror set as an argument

   FROM docker.io/apache/incubator-kie-sonataflow-builder:main AS builder
   
   # Content suppressed for brevity
   
   # The Maven mirror URL passed as a build argument during the build process
   ARG MAVEN_MIRROR_URL

   Copy to Clipboard Toggle word wrap

   The ARG directive allows you to pass the Maven mirror value dynamically at build time.