CHANGELOG.md

Changes

This document main purpose is to list changes which might affect backwards compatibility. It will not list all releases as fabric8-maven-plugin is build in a continous delivery fashion.

We use semantic versioning in some slight variation until our feature set has stabilized and the missing pieces has been filled in:

• The MAJOR_VERSION is kept to 3
• The MINOR_VERSION changes when there is an API or configuration change which is not fully backward compatible.
• The PATCH_LEVEL is used for regular CD releases which add new features and bug fixes.

After this we will switch probably to real Semantic Versioning 2.0.0

Extracting changelog portions

We provide a script to extract changelog portions and automatic link building to send notifications (i.e. e-mail) about new releases (scripts/extract-changelog-for-version.sh)

Usage:

# ./scripts/extract-changelog-for-version.sh semanticVersionNumber [linkLabelStartNumber]
./scripts/extract-changelog-for-version.sh 1.3.37 5

4.5-SNAPSHOT

• Fix NullPointerException in ConfigMapEnricher
• Update Fabric8 Images to latest versions

4.4.2 (2022-07-21)

• Fix #1806: PushMojo should have docker access disabled only when JIB=true
• Fix #1833: Add Fabric8 Maven Plugin deprecation log message before & after goal executions

4.4.1 (2020-03-18)

• Fix: JIB Assembly config doesn't work with any Archive mode
• Fix: Jib push fails to push configured tag
• Fix: Jib Push fails when docker daemon is disabled
• Refactor #1766: Jib Refactor
• Revert #1737 : Reverted "Wrong Jib output directory in Maven multi-module build"
• Revert #1738 : Reverted "JibBuildConfiguration ignores BuildImageConfiguration.registry"
• Fix #1789: script to extract changelog information for notifications
• Fix #1770: Fixed my mistake, remove constructors from OpenshiftBuildConfig which were causing PluginConfigurationException
• Fix #1791: Fix NullPointerException in FileDataSecretEnricher (due to recent change in Kubernetes Client Builder null to LinkedHashMap conversion)
• Fix: ImageChangeTags not being applied in DeploymentConfig generated by plugin in case of resource fragments. (Issue found in this StackOverflow post.)
• Fix #1798: Jib logs display correctly, and support ansi
• Fix #1793: Labels missing for some objects
• Update Fabric8 Kubernetes Client to v4.9.0

4.4.0 (2020-02-13)

• Fix #1572: Support maven --batch-mode option
• Feature #1748: Quarkus generator: Extract base image from configuration.
• Fix #1695: IllegalArgumentException when Spring Boot application.yaml contains integer keys
• Fix #797: spring-boot generator can not handle multi-profile configuration
• Fix #1751: Build Names are suffixed with -s2i regardless of build strategy
• Fix #1770: Support for setting BuildConfig memory/cpu request and limits
• Fix #1755: Spring boot enricher does not produce a proper heath check and liveness check path when "/" is used.
• Feature: Check maven.compiler.target property for base image detection.
• Fix: Enrichers should resolve relative paths against project directory, not working directory
• Feature #1483: Dekorate integration
• Fix #1769: Display root cause of failure if available
• Fix #1776: fat jar wrongly detected on simple jar

4.3.1 (18-10-2019)

• Updated Kubernetes client to 4.6.1
• Fix #1725: Update jackson to 2.10.0
• Fix #1710: Docker build args not working
• Fix #1728: Ingress enricher is using Ingress kind
• Fix #1732: Correctly replacing template placeholders in helm chart
• Fix #1734: Add logging during jib builds
• Fix #1696: Fix put operations for ImageStreams in ApplyService
• Fix #1738: JibBuildConfiguration ignores BuildImageConfiguration.registry
• Fix #1737: Wrong Jib output directory in Maven multi-module build

4.3.0 (04-10-2019)

• Updated custom-enricher sample
• Fixed image config in thorntail sample
• Fix Autotls enricher in order to add service serving certificate secrets annotations
• Fix #1697: NullpointerException when trying to apply custom resources
• Fix #1720: Should be able to add custom route, even if fabric8.openshift.generateRoute=false
• Fix #1696: fmp not setting imagestreams resourceVersion properly.
• Fix #1689: HELM mode does not support parameters without value
• Fix #1676: Support for latest kubernetes client
• Fix #1699: Ability to specify object namespace in fragments
• Feature #1536: Java Image Builder Support
• Fix #1704: fabric8-build failing on openshift
• Feature #1706: Prometheus Enricher; Configuration support for Prometheus path
• Fix #1715: ApplyService#applyProjectRequest should be (truly) idempotent
• Added generator support for Open Liberty
• Fix #1718: Support for binary files in fmp-configmap-file

4.2.0 (01-08-2019)

• Fix #1638: Remove enrichAll parameter from ImageChangeTriggerEnricher
• Update Docker Maven Plugin to 0.29.0
• Chore: Refactor BaseEnricher to get rid of duplicated properties
• Fix #872: Using spring.application.name as service name
• Fix #1632: imagePullPolicy configuration fixed as per documentation
• Fix #1591: Add support for custom resources creation via resource fragments
• Fix #1628: Adding back support for templates in kubernetes mode to HelmMojo; Fix for NPE in UndeployMojo
• Fix #1591: Add support for custom resources creation via resource fragments
• Fix #1636: Added support to choose configMap name
• Fix #1630: Fix CronJob Version
• Upgrade Fabric8 kubernetes client to v4.3.0
• Fix #1591: Add support for custom resources creation via resource fragments
• Update docker maven plugin to 0.30.0
• Fix #1648: Job creation fails during fabric8:apply with error: forbidden
• Fix #1656: Openshift serviceaccount requires OAuth token authentication
• Fix #1622: Additions to minimal profile
• Feature #1661: Added Resource Versioning Support for RBAC
• Fix 73: Added Service Port normalization
• Bumped version to 4.2-SNAPSHOT
• Fix 1678: Fix breaking xml-config sample build
• Fix 1666: switchToDeployment does not work
• removed redundant profiles java11 and java9-plus
• Upgrade Fabric8 kubernetes client to v4.3.1
• Feature #1647: Added Base Image support for Java 11
• Fix #1680: DockerBuildServiceTest Refactored

4.1.0 (16-02-2019)

• Fix 1578: Fmp is generating ImageChange triggers in the DeploymentConfig
• Fix 1582: Refactor EnricherManager logic
• Fix 1409: Update readme for reworked 4.0 version
• Fix 1038: Do not add ImageChange change triggers for Docker images
• Fix NullPointerException in ClusterConfiguration when reading from properties
• Fix 1586: Redundant 'abstract' qualifier in BaseEnricher class removed
• Fix 1600: Replicas fragment not set
• Fix 1579: Added documentation for clearing doubts related to sidecars
• Fix 1587: HandlerHub refactored
• Update Kubernetes client to 4.2.1
• Fix 1579: Add ImageChange triggers to application container when resource fragments are used
• Fix 1607: Fix YAML aggregation for OpenShift
• Refactor 1592: Removed Deprecated/Unused Osio specific enrichers.
• Fix 1608: Added Enricher for namespace to project conversion.
• Feature 1611: Allow creating namespaces from xml configuration
• Fix 1616: Goals failing with Access Configuration

4.0.0 (14-03-2019)

• Refactor 678: Enricher Workflow to allow direct generation of OpenShift objects.
• Refactor 802: Remove resource object post processing.
• Feature 729: Select custom resources depending on environment.
• Feature 968: Improved support for sidecar containers with sidecar auto-detection and targeted health checks
• Feature 601: Adds healthcheck for webapp
• Fix 1460: Upgraded kubernetes client to 4.1.1
• Fix 690: Removes deprecated legacyPortMapping property.
• Fix 1458: Support for from Image configuration in openshift docker build strategy
• Fix 931: Add ServiceAccount enricher and configuration
• Fix 732: Added 'skip' options to goals.
• Refactor 1520: Move XML configuration code from Mojo to enrichers
• Fix 1486: Remove Kompose Support
• Fix 1467: Wait timeout for build pod is too small
• Fix 1466: Allow to configure noCache option for openshift docker build strategy
• Fix 255: Add option to forcefully reload a s2i builder image.
• Fix 925: Unable to configure replicas count via property
• Feature 804: Allow set fragments as external references (URL)
• Fix 788: Added Git URL to GitEnricher.
• Feature 718: Detect port number from configuration file for health check in Thorntail
• Refactor 828: Moved Metedata specific code into DefaultMetadataEnricher
• Feature 718: Detect port number from configuration file for health check in Thorntail
• Fix NullPointerException in ClusterConfiguration during fabric8:watch
• Feature 1498: Allow users to define secrets from annotations
• Feature 1498: Allow users to define secrets from annotations
• Fix 1522: Remove need to initialize DockerAccess when on Openshift
• Fix 1570: Failure in applying Deployments using fabric8-maven-plugin
• Fix 1517: update vmp groupid and vert.x version
• Fix 1444: Option to Disable Liveness/readiness checks
• Feature 456: Add labels from label-schema.org to the generator images.

4.0.0-M2 (2018-12-14)

• Fix 10: Make VolumeConfiguration more flexible
• Fix 1326: Fixes overridding of Selector Label by the project enrichers entries.
• Fix 839: Sets Spring Boot generator color config property as String
• Fix 401: Refactor DefaultControllerEnricher
• Fix 1412: mvn deploy fails when using a Dockerfile during S2I build
• Fix 1386: Allow @sha256 digest for tags in FROM
• Fix 796: Remove workaround to produce both .yaml and .json files
• Fix 1425: Added metadata visitors for imagestreams, build and buildconfig.
• Fix 1373: Allow the configuration of failureThreshold and successThreshold on readiness and liveness probes
• Fix 712: Add possibility to configure cluster access fexibly.
• Chore 1452: Upgraded Jgit to 5.2.0.201812061821-r
• Fix 222: The SeviceEnricher could check the Docker image configuration for specific labels
• Fix 1019: Custom liveness/readiness probes are not being created

3.5-SNAPSHOT

• Fix 1390: Provides better exception message in case of invalid application.yml in Spring Boot
• Fix 1382: Allow to provide additional fragment filename mappings
• Fix 918: Sanitize Maven project names when artifactId starts with a number

4.0.0-M1 (2018-11-09)

• Feature: Move to Java 1.8 as minimal requirement
• Refactor 1344: Removed unused Maven goals. Please contact us if something's missing for you.
• Refactor 949: Remove dependency from fabric8/fabric8
• Feature 1214: Don't use a default for skipBuildPom. This might break backwards compatibility, so please specify the desired value in case
• Fix 1093: Default tag for snapshot release is "latest", not the timestamp anymore
• Fix 1155 : Decouple regression test module from Fabric8 Maven Plugin
• Updated sample project versions to 4.0-SNAPSHOT
• Refactor 1370: Removed Jenkinsshift support
• Feature 1363: Added a Thorntail V2 sample for checking Jolokia/Prometheus issues
• Fix 894: Keep Service parameters stable after redeployment
• Fix 1330: Disable enrichers specific to the fabric8 platform by default
• Fix 1372: Filename to type mappings should be more flexible than a string array
• Fix 1327: Update docker maven plugin version
• Fix 1365: Generated image reference in deployment.yml contains duplicate registry name
• Fix 662: Add additional files when not a fat-jar
• Removed support for loading env variable from schema.json
• Removed MergeEnricher as it is broken and not used anyway
• Fix 1069: Fix broken fabric8:watch
• Fix 977: Allows user to define ConfigMap from XML and annotation
• Fix 314: Do not execute GitEnricher if not Git repo
• Fix 714: Merges the functionality of IANAServicePortNameEnricher and PortNameEnricher.
• Fix 963: add support for Pod resource type in yaml config.

###3.5.42 (2018-10-18)

• Fix 1346: karaf-maven-plugin is detected under any groupId
• Fix 1021: Avoids empty deployment selector value in generated yaml resource
• Fix 1383: Check if instanceof Openshift before casting and handle failures.
• Feature ENTESB-9252: Add Service Annotations to facilitate automated service discovery by 3scale.
• Fix 1365: Generated image reference in deployment.yml contains duplicate registry name

3.5.41 (2018-08-01)

• Feature 1032: Improvements of the Vert.x Generator and enrichers
• Fix 1313: Removed unused Maven goals. Please contact us if something's missing for you.
• Fix 1299: autotls feature doesn't work with OpenShift 3.9 (Kubernetes 1.8+) due to InitContainer annotation deprecation
• Fix 1276: Proper inclusion of webapp's war regardless of the final name
• Feature: New 'path' config option for the webapp generator to set the context path
• Fix 1334: support for docker.pull.registry
• Fix 1268: Java console for OpenShift builds reachable again.
• Fix 1312: Container name should not be generated from maven group id
• Feature 917: Add timeoutSeconds configuration option for SpringBootHealthCheck enricher
• Fix 1073: Preserve file extension when copying file to helm chart folder
• Fix 1340: spring-boot-maven-plugin is detected under any groupId
• Fix 1346: karaf-maven-plugin is detected under any groupId

3.5.40

• Feature 1264: Added osio profile, with enricher to apply OpenShift.io space labels to resources
• Feature 1291: Added ImageStream triggers for StatefulSets, ReplicaSets and DaemonSets
• Feature 1293: Added support to create pullSecret in buildConfig when pulling from private registry in Openshift.
• Fix 1265: WildFly Swarm health check enricher now supports detecting MicroProfile Health
• Fix 1298: WildFly Swarm was renamed to Thorntail
• Fix 1284: Handle intermittent SocketTimeoutException while s2i build
• Fix Unzip Issue - #1303
• Bring Wildfly swarm documentation uptodate - #1297
• Upgraded Kubernetes Client to 3.2.0 - #1304
• Upgraded Fabric8 to 3.0.12 - #1307

3.5.39

• Feature 1206: Added support for spring-boot 2 health endpoint
• Feature 1171: Added configuration options for delay and period on spring-boot health check probes
• Fix 1173: disable the Prometheus agent for WildFly Swarm applications, because it uses Java logging too early; also reenable the Jolokia agent, which was disabled due to the same problem but was fixed a long time ago
• Fix 1231: make helm artifact extension configurable with default value "tar.gz"
• Fix 1247: do not try to install non-existent imagestream yml file
• Fix 1185: K8s: resource fragment containing compute resources for containers triggers a WARNING.
• Fix 1237: When trimImageInContainerSpec is enabled, the generated yaml is incorrect
• Fix 1245: Use released version of Booster in place of master always in regression test
• Fix 1263: Display a warning in case of premature close of the build watcher by kubernetes client
• Fix 886: Introduce extends for profiles

3.5.38

• Feature 1209: Added flag fabric8.openshift.generateRoute which if set to false will not generate route.yml and also will not add Route resource in openshift.yml. If set to true or not set, it will generate rou te.yml and also add Route resource in openshift.yml. By default its value is true.
• Fix 1177: Added flag fabric8.openshift.enableAutomaticTrigger which would be able to enable/disable automatic deployments whenever there is new image generated.
• Fix 1184: MultiModule projects were not getting deployed using FMP 3.5.34 onwards. This was working after adding an extra flag which was breaking the previous behaviour in patch release. We will make these change again in minor release and will add the notes regarding that. For the time being, we have reverted the change.
• Fix #1226: Plugin fails to deploy changes to an application with S2I build. It used to pick first image verion always. This fix pick the right image tag by comaring created attribute of image tag

3.5.35

• Fix 1130: Added flag fabric8.openshift.trimImageInContainerSpec which would set the container image reference to "", this is done to handle weird behavior of Openshift 3.7 in which subsequent rollouts lead to ImagePullErr.
• Feature 1174: ImageStreams use local lookup policy by default to simplify usage of Deployment or StatefulSet resources on Openshift

3.5.34

• Feature 1003: Added suspend option to remote debugging
• Remove duplicate tenant repos from downstream version updates and add in tjenkins platform
• Fix 1051: resource validation was slow due to online hosted schema. The fix uses the JSON schema from kubernetes-model project
• Fix 1062: Add a filter to avoid duplicates while generating kubernetes template(picking the local generated resource ahead of any dependency). Added a resources/ folder in enricher/standard/src/test/ directory to add some sample yaml and jar resource files for DependencyEnricherTest.
• Fix 1042: Added a fabric8.build.switchToDeployment option to switch to Deployments rather than DeploymentConfig provided ImageStreams are not used on OpenShift. If value is set to true then fabric8-maven-plugin would switch to deployments, default value is false.

3.3.0

• The base image for Docker based builds (fabric8.mode == Kubernetes) has changed from fabric8/java-alpine-opendjdk8-jdk to fabric8/java-jboss-openjdk8-jdk which is CentOS based. Reason for this were issues with DNS lookups on Alpine. As before you always can change the base image with -Dfabric8.from.

3.2.1 (2016-11-17)

• Changed the base generator configuration <enabled> to <add> as it means to add this generator's image when it applies in contrast to only run when there is no other image configuration yet.
• Changed the default directories which are picked up the java-exec generator to src/main/fabric8-includes for extra file to be added to a Docker image.
• In the karaf and java-exec generator configuration baseDir changed to targetDir for specifying the target directory within the image where to put things into. This is in alignment with the docker-maven-plugin.
• In the webapp-generator configuration deploymentDir changed to targetDir for consistencies sake.