Red Hat OpenShift Application Runtimes Release Notes

Red Hat OpenShift Application Runtimes 1

For use with Red Hat OpenShift Application Runtimes

Red Hat Customer Content Services

Abstract

This Release Note contains important information related to Red Hat OpenShift Application Runtimes

Chapter 1. About Red Hat OpenShift Application Runtimes

Red Hat OpenShift Application Runtimes (RHOAR) provides a highly productive and prescriptive developer experience for creating new cloud-native and cloud-enabled existing applications using microservices and containerization. RHOAR runtimes are designed to take advantage of cloud computing models, DevOps practices, OpenShift, and JBoss Middleware to increase the ability to deliver applications and services quickly and frequently.

RHOAR offer developers flexibility and choices to build the right applications with the right technologies.

For a quick introduction to RHOAR, follow the Getting Started Guide.

Chapter 2. Supportability of Third-Party Runtime Components

Red Hat provides varying degrees of support for selected third-party runtime components included in this release of Red Hat OpenShift Application Runtimes. For details on the available supportability tiers for Spring Boot runtime components and for third-party frameworks used with RHOAR see the link:[RHOAR Supported Configurations] document.

Chapter 3. Technology Preview

Red Hat does not provide support for Technology Preview components provided with this release of Red Hat OpenShift Application Runtimes. Items designated as Technology Preview in the sections below have limited supportability, as defined by the Technology Preview Features Support Scope.

Technology preview components provided with this release include:

Chapter 4. RHOAR Deployment Platforms

Container Development Kit

RHOAR runtimes have been tested on Red Hat Container Development Kit (CDK). CDK configures a pre-built Single-node OpenShift Cluster cluster on a local machine. CDK includes Minishift and the oc CLI tool. CDK provides users with a means of deploying Booster applications locally. CDK is available for download from the Red Hat Developer Portal. A free Red Hat developer account is required to access the download.

OpenShift Online Pro

RHOAR runtimes have been tested with OpenShift Online Pro.

OpenShift Online Starter

It is possible to use RHOAR on the zero-cost OpenShift Online Starter cluster, although issues may arise due to resource quotas for some boosters and for executing advanced commands (scale up, rolling upgrade, etc).

OpenShift Container Platform

RHOAR runtimes have not yet been fully tested on the OpenShift Container Platform, although feedback is welcome.

Chapter 5. Required Infrastructure Component Versions

The following versions of infrastructure components are required for all runtimes distributed as part of a RHOAR release.

Component nameVersion

Fabric8 Maven Plugin

3.5.30

Maven

3.3.1 or later

OpenShift Container Platform (OCP)

3.6 or later

Minishift

1.8.0

CDK

3.2.0

JDK[a]

1.8.0[b]

git

2.0 or later

oc command line tool

3.6 or later[c]

[a] A full JDK installation is required, as JRE does not provide tools for compiling Java applications from source.
[b] All later versions of Java 8 are supported. Runtimes provided with this release do not support Java 9.
[c] The version of the oc CLI tool should correspond to the version of OCP that you are using.

Chapter 6. Runtime Components

This section specifies the runtime components available as part of the RHOAR release. Artifacts listed below are available in the Red Hat General Availability Maven Repository.

6.1. Eclipse Vert.x

The Eclipse Vert.x runtime artifacts provided with this release of RHOAR are all based on upstream version 3.4.2.

6.1.1. Supported Maven Artifacts Provided with Eclipse Vert.x

GroupIDArtifactIDVersion

io.vertx

vertx-codegen

3.4.2.redhat-006

io.vertx

vertx-docgen

3.4.2.redhat-006

io.vertx

vertx-core

3.4.2.redhat-006

io.vertx

vertx-codetrans

3.4.2.redhat-006

io.vertx

vertx-core

3.4.2.redhat-006

io.vertx

vertx-unit

3.4.2.redhat-006

io.vertx

vertx-sql-common

3.4.2.redhat-006

io.vertx

vertx-jdbc-client

3.4.2.redhat-006

io.vertx

vertx-service-proxy

3.4.2.redhat-006

io.vertx

vertx-service-proxy

3.4.2.redhat-006

io.vertx

vertx-hawkular-metrics

3.4.2.redhat-006

io.vertx

vertx-health-check

3.4.2.redhat-006

io.vertx

vertx-auth

3.4.2.redhat-006

io.vertx

vertx-auth-common

3.4.2.redhat-006

io.vertx

vertx-jwt

3.4.2.redhat-006

io.vertx

vertx-auth-htdigest

3.4.2.redhat-006

io.vertx

vertx-auth-oauth2

3.4.2.redhat-006

io.vertx

vertx-auth-jwt

3.4.2.redhat-006

io.vertx

vertx-web-parent

3.4.2.redhat-006

io.vertx

vertx-web

3.4.2.redhat-006

io.vertx

vertx-web-common

3.4.2.redhat-006

io.vertx

vertx-web-client

3.4.2.redhat-006

io.vertx

vertx-web-templ-handlebars

3.4.2.redhat-006

io.vertx

vertx-web-templ-freemarker

3.4.2.redhat-006

io.vertx

vertx-bridge-common

3.4.2.redhat-006

io.vertx

vertx-circuit-breaker

3.4.2.redhat-006

io.vertx

vertx-service-discovery

3.4.2.redhat-006

io.vertx

vertx-service-discovery-parent

3.4.2.redhat-006

io.vertx

vertx-service-discovery-bridge-kubernetes

3.4.2.redhat-006

io.vertx

vertx-config-parent

3.4.2.redhat-006

io.vertx

vertx-config

3.4.2.redhat-006

io.vertx

vertx-config-kubernetes-configmap

3.4.2.redhat-006

io.vertx

vertx-config-spring-config-server

3.4.2.redhat-006

io.vertx

vertx-config-yaml

3.4.2.redhat-006

6.1.2. Technology Preview Maven Artifacts Provided with Eclipse Vert.x

Red Hat provides limited support for Eclipse Vert.x artifacts designated as Technology Preview:

Group IDArtifact IDVersion

io.vertx

vertx-mongo

3.4.2.redhat-006

io.vertx

vertx-mongo-service

3.4.2.redhat-006

io.vertx

vertx-mongo-client

3.4.2.redhat-006

io.vertx

vertx-rx

3.4.2.redhat-006

io.vertx

vertx-rx-java

3.4.2.redhat-006

io.vertx

vertx-sockjs-service-proxy

3.4.2.redhat-006

io.vertx

vertx-redis-client

3.4.2.redhat-006

io.vertx

vertx-infinispan

3.4.2.redhat-006

io.vertx

vertx-proton

3.4.2.redhat-006

io.vertx

vertx-grpc

3.4.2.redhat-006

io.vertx

vertx-mqtt-server

3.4.2.redhat-006

6.2. WildFly Swarm

6.2.1. Supported Maven Artifacts Provided with WildFly Swarm

Group IDArtifact IDVersion

org.wildfly.swarm

spi

7.0.0.redhat-8

org.wildfly.swarm

web

7.0.0.redhat-8

org.wildfly.swarm

undertow

7.0.0.redhat-8

org.wildfly.swarm

jaxrs-cdi

7.0.0.redhat-8

org.wildfly.swarm

cdi

7.0.0.redhat-8

org.wildfly.swarm

microprofile

7.0.0.redhat-8

org.wildfly.swarm

connector

7.0.0.redhat-8

org.wildfly.swarm

ejb

7.0.0.redhat-8

org.wildfly.swarm

transactions

7.0.0.redhat-8

org.wildfly.swarm

jaxrs-jsonp

7.0.0.redhat-8

org.wildfly.swarm

management

7.0.0.redhat-8

org.wildfly.swarm

cdi-config

7.0.0.redhat-8

org.wildfly.swarm

datasources

7.0.0.redhat-8

org.wildfly.swarm

jpa

7.0.0.redhat-8

org.wildfly.swarm

jsf

7.0.0.redhat-8

org.wildfly.swarm

jaxrs

7.0.0.redhat-8

org.wildfly.swarm

jmx

7.0.0.redhat-8

org.wildfly.swarm

topology-webapp

7.0.0.redhat-8

org.wildfly.swarm

jca

7.0.0.redhat-8

org.wildfly.swarm

keycloak

7.0.0.redhat-8

org.wildfly.swarm

bean-validation

7.0.0.redhat-8

org.wildfly.swarm

topology-openshift

7.0.0.redhat-8

org.wildfly.swarm

jaxrs-jaxb

7.0.0.redhat-8

org.wildfly.swarm

remoting

7.0.0.redhat-8

org.wildfly.swarm

hibernate-validator

7.0.0.redhat-8

org.wildfly.swarm

container

7.0.0.redhat-8

org.wildfly.swarm

logging

7.0.0.redhat-8

org.wildfly.swarm

request-controller

7.0.0.redhat-8

org.wildfly.swarm

jsonp

7.0.0.redhat-8

org.wildfly.swarm

naming

7.0.0.redhat-8

org.wildfly.swarm

security

7.0.0.redhat-8

org.wildfly.swarm

ee

7.0.0.redhat-8

org.wildfly.swarm

jaxrs-multipart

7.0.0.redhat-8

org.wildfly.swarm

monitor

7.0.0.redhat-8

org.wildfly.swarm

topology

7.0.0.redhat-8

org.wildfly.swarm

msc

7.0.0.redhat-8

org.wildfly.swarm

jaxrs-validator

7.0.0.redhat-8

org.wildfly.swarm

io

7.0.0.redhat-8

6.2.2. Tested Maven Artifacts Provided with WildFly Swarm

Group IDArtifact IDVersion

org.wildfly.swarm

hystrix

2017.10.1

org.wildfly.swarm

ribbon

2017.10.1

org.wildfly.swarm

ribbon-secured

2 017.10.1

6.2.3. Technology Preview Maven Artifacts Provided with WildFly Swarm

Red Hat provides limited support for WildFly Swarm artifacts designated as Technology Preview:

Group IDArtifact IDVersion

org.keycloak

keycloak-authz-client

2.5.14.Final-redhat-1

6.3. Spring Boot

6.3.2. Supportability of Tested And Verfified Spring Boot Artifacts

Red Hat has tested and verified for use with OpenShift a set of Spring community artifacts available on start.spring.io. Red Hat does not provide support for Tested and Verified Maven artifacts distributed with this release of RHOAR. The Tested and Verified Spring Boot Artifacts are available in the Maven Central Repository. Red Hat provides varying degrees of support for selected artifacts used in Spring Boot RHOAR applications available in the Red Hat General Availability Maven Repository.

6.3.3. Deploying Spring Boot Applications From WAR Files

RHOAR allows you to repackage your Spring Boot application as an executable WAR file. This feature is currently provided as a Technology Preview. RHOAR does not support deploying Spring Boot applications to OpenShift using executable WAR files in this release.

6.3.4. Tested and Verified Maven Artifacts Provided with Spring Boot

Group IDArtifact IDVersion

io.fabric8

kubernetes-client

2.4.1

io.fabric8

openshift-client

2.4.1

org.projectlombok

lombok

1.1.16

org.springframework.boot

spring-boot

1.5.8.RELEASE

org.springframework.boot

spring-boot-test

1.5.8.RELEASE

org.springframework.boot

spring-boot-test-autoconfigure

1.5.8.RELEASE

org.springframework.boot

spring-boot-actuator

1.5.8.RELEASE

org.springframework.boot

spring-boot-actuator-docs

1.5.8.RELEASE

org.springframework.boot

spring-boot-autoconfigure

1.5.8.RELEASE

org.springframework.boot

spring-boot-configuration-metadata

1.5.8.RELEASE

org.springframework.boot

spring-boot-configuration-processor

1.5.8.RELEASE

org.springframework.boot

spring-boot-devtools

1.5.8.RELEASE

org.springframework.boot

spring-boot-loader

1.5.8.RELEASE

org.springframework.boot

spring-boot-loader-tools

1.5.8.RELEASE

org.springframework.boot

spring-boot-starter

1.5.8.RELEASE

org.springframework.boot

spring-boot-starter-actuator

1.5.8.RELEASE

org.springframework.boot

spring-boot-starter-data-jpa

1.5.8.RELEASE

org.springframework.boot

spring-boot-starter-data-mongodb

1.5.8.RELEASE

org.springframework.boot

spring-boot-starter-data-rest

1.5.8.RELEASE

org.springframework.cloud

spring-cloud-starter-feign

1.3.4.RELEASE

org.springframework.boot

spring-boot-starter-jdbc

1.5.8.RELEASE

org.springframework.boot

spring-boot-starter-test

1.5.8.RELEASE

org.springframework.boot

spring-boot-starter-logging

1.5.8.RELEASE

org.springframework.boot

spring-boot-starter-web

1.5.8.RELEASE

org.springframework.boot

spring-boot-starter-tomcat

1.5.8.RELEASE

org.springframework.boot

spring-boot-starter-websocket

1.5.8.RELEASE

org.aspectj

aspectjrt

1.8.11

org.aspectj

aspectjtools

1.8.11

org.aspectj

aspectjweaver

1.8.11

org.springframework

spring-aspects

4.3.12.RELEASE

org.springframework

spring-beans

4.3.12.RELEASE

org.springframework

spring-context

4.3.12.RELEASE

org.springframework

spring-core

4.3.12.RELEASE

org.springframework

spring-jdbc

4.3.12.RELEASE

org.springframework

spring-orm

4.3.12.RELEASE

org.springframework

spring-tx

4.3.12.RELEASE

org.springframework

spring-web

4.3.12.RELEASE

org.springframework

spring-webmvc

4.3.12.RELEASE

org.springframework.security

spring-security-crypto

4.2.3.RELEASE

org.springframework.amqp

spring-amqp

1.7.4.RELEASE

org.spockframework

spock-core

1.0-groovy-2.4

org.spockframework

spock-spring

1.0-groovy-2.4

com.fasterxml

classmate

1.3.4

com.fasterxml.jackson.core

jackson-annotations

2.8.10

com.fasterxml.jackson.core

jackson-core

2.8.10

com.fasterxml.jackson.core

jackson-databind

2.8.10

com.fasterxml.jackson.dataformat

jackson-dataformat-yaml

2.8.10

com.fasterxml.jackson.jaxrs

jackson-jaxrs-json-provider

2.8.10

com.fasterxml.jackson.module

jackson-module-jaxb-annotations

2.8.10

commons-codec

commons-codec

1.10.0.redhat-5

com.h2database

h2

1.4.196

javax.servlet

jstl

1.2

org.apache.cxf

cxf-spring-boot-starter-jaxrs

3.1.12

ch.qos.logback

logback-core

1.1.11

ch.qos.logback

logback-classic

1.1.11

ch.qos.logback

logback-access

1.1.11

org.apache.httpcomponents

httpclient

4.5.3

org.apache.httpcomponents

httpcore

4.4.8

org.apache.httpcomponents

httpmime

4.5.3

org.codehaus.groovy

groovy

2.4.12

org.assertj

assertj-core

2.6.0

org.codehaus.groovy

groovy-json

2.4.12

org.codehaus.groovy

groovy-xml

2.4.12

org.hibernate

hibernate-validator

5.2.4

org.hibernate

hibernate-core

5.2.11.Final

org.hibernate

hibernate-entitymanager

5.2.11.Final

net.bytebuddy

byte-buddy

1.6.14

org.hibernate.javax.persistence

hibernate-jpa-2.1-api

1.0.0.Final

antlr

antlr

2.7.7

org.jboss

jandex

2.0.0.Final

dom4j

dom4j

1.6.1

org.hibernate.common

hibernate-commons-annotations

5.0.1.Final

javax.enterprise

cdi-api

1.1

javax.el

el-api

2.2

javax.transaction

javax.transaction-api

1.2

javax.annotation

jsr250-api

1.0

javax.inject

javax.inject

1

org.javassist

javassist

3.21.0-GA

org.jboss.logging

jboss-logging

3.3.1.Final-redhat-1

org.json

json

20140107

org.slf4j

jul-to-slf4j

1.7.25

org.slf4j

slf4j-api

1.7.25

org.yaml

snakeyaml

1.17

xml-apis

xml-apis

1.4.01

io.dropwizard.metrics

metrics-core

3.1.5

io.dropwizard.metrics

metrics-ganglia

3.1.5

io.dropwizard.metrics

metrics-graphite

3.1.5

io.dropwizard.metrics

metrics-servlets

3.1.5

org.hsqldb

hsqldb

2.3.5

com.google.guava

guava

23.0

org.springframework.cloud

spring-cloud-sleuth-zipkin

1.2.2.RELEASE

org.springframework.cloud

spring-cloud-sleuth-zipkin-stream

1.2.2.RELEASE

org.springframework.cloud

spring-cloud-sleuth-stream

1.2.2.RELEASE

org.springframework.cloud

spring-cloud-starter-config

1.3.2.RELEASE

org.springframework.cloud

spring-cloud-starter-hystrix

1.3.2.RELEASE

org.springframework.cloud

spring-cloud-starter-ribbon

1.3.2.RELEASE

org.springframework.cloud

spring-cloud-starter-sleuth

1.2.2.RELEASE

org.springframework.cloud

spring-cloud-starter-stream-rabbit

1.2.1.RELEASE

org.springframework.cloud

spring-cloud-starter-zuul

1.3.4.RELEASE

org.springframework.cloud

spring-cloud-kubernetes-core

0.2.0.RELEASE

org.springframework.cloud

spring-cloud-kubernetes-config

0.2.0.RELEASE

org.springframework.cloud

spring-cloud-kubernetes-discovery

0.2.0.RELEASE

org.springframework.cloud

spring-cloud-kubernetes-archaius

0.2.0.RELEASE

org.springframework.cloud

spring-cloud-kubernetes-ribbon

0.2.0.RELEASE

org.springframework.cloud

spring-cloud-kubernetes-hystrix

0.2.0.RELEASE

org.springframework.cloud

spring-cloud-kubernetes-zipkin

0.2.0.RELEASE

org.springframework.cloud

spring-cloud-starter-kubernetes-all

0.2.0.RELEASE

org.springframework.cloud

spring-cloud-starter-kubernetes

0.2.0.RELEASE

org.springframework.cloud

spring-cloud-starter-kubernetes-config

0.2.0.RELEASE

org.springframework.cloud

spring-cloud-starter-kubernetes-netflix

0.2.0.RELEASE

org.springframework.cloud

spring-cloud-starter-kubernetes-zipkin

0.2.0.RELEASE

io.opentracing

opentracing-api

0.30.0

io.opentracing

opentracing-noop

0.30.0

io.opentracing

opentracing-mock

0.30.0

io.opentracing

opentracing-util

0.30.0

io.opentracing.contrib

opentracing-spring-cloud

0.0.4

io.opentracing.contrib

opentracing-spring-cloud-starter

0.0.4

io.opentracing.contrib

opentracing-spring-web

0.0.10

io.opentracing.contrib

opentracing-spring-web-autoconfigure

0.0.10

io.opentracing.contrib

opentracing-jms-spring

0.0.3

io.opentracing.contrib

opentracing-jms-common

0.0.3

io.opentracing.contrib

opentracing-jms-1

0.0.3

io.opentracing.contrib

opentracing-concurrent

0.0.2

org.apache.tomcat.embed

tomcat-embed-core

8.5.23

org.apache.tomcat.embed

tomcat-embed-el

8.5.23

org.apache.tomcat.embed

tomcat-embed-jasper

8.5.23

org.apache.tomcat.embed

tomcat-embed-websocket

8.5.23

org.apache.tomcat

tomcat-jdbc

8.5.23

org.keycloak

keycloak-adapter-spi

2.5.5.Final

org.keycloak

keycloak-tomcat8-adapter

2.5.5.Final

org.keycloak

keycloak-spring-boot-adapter

2.5.5.Final

org.eclipse

jdt

4.4.2.redhat-1

6.3.5. Technology Preview Maven Artifacts Provided with Spring Boot

Red Hat provides limited support for Spring Boot artifacts designated as Technology Preview:

Group IDArtifact IDVersion

org.keycloak

keycloak-authz-client

2.5.14.Final-redhat-1

Chapter 7. Known Issues

7.1. Known Eclipse Vert.x Issues

7.1.1. False Connection reset by peer error messages when calling application endpoint

Description:

Making an HTTP request on an endpoint of a Vert.x application using either curl or a Java HTTP client, produces the following error in the logs after each request:

io.vertx.core.net.impl.ConnectionBase
SEVERE: java.io.IOException: Connection reset by peer

This behavior is caused by the interaction of the Netty application framework and the HAProxy load-balancer used by OpenShift. The error occurs due to existing HTTP connections being re-used by HAProxy without closing. Even though the error message is logged, no error condition occurs. HTTP requests are handled correctly and the application responds as expected.

7.2. Known WildFly Swarm Issues

7.2.1. The Ribbon Secured fraction does not work

Description:

When using the secured Ribbon client in a Swarm application (SecuredRibbon.from()), it throws a ClassNotFoundException.

7.2.2. Cannot use Apache HTTP Client or JAX-RS Client in a test without manually specifying commons-logging version

Description:

The WildFly Swarm productized rutime artifact BOM imports the EAP runtime artifacts BOM (org.jboss.bom:eap-runtime-artifacts). This BOM excludes the commons-logging artifact from the org.apache.httpcomponents:httpclient and org.apache.james:apache-mime4j artifacts. As a result, when running tests in a Maven project that imports the WildFly Swarm productized rutime artifact BOM, neither the Apache HTTP Client nor any other artifact that depends on it (for example, the JAX-RS Client) work.

Workaround:

You must import the commons-logging artifact manually for the tests to work.

7.2.3. Swarm Arquillian adapter ignores mvn -s settings.xml

Issue Key:

SWARM-1546

NOTE: You do not have to log into JIRA to view this issue.

7.3. Known Spring Boot Issues

7.3.1. Spring Boot does not accept proxy settings when passed in as command line parameters

Issue Key:

SB-168

NOTE: You do not have to log into JIRA to view this issue.

Legal Notice

Copyright © 2017 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.