MicroProfile Platform 7.1

In  microprofile
Tracked by https://github.com/wildfly/wildfly-proposals/issues/735

Overview

This RFE is about updating WildFly to support MicroProfile Platform 7.1. We currently support MicroProfile Platform 7.0.

The major.minor versions of the individual specs are shown below. Micro updates are strictly for TCK fixes, and we should use the latest for the TCKs as these versions become available.

Spec

MP 7.0 Spec Version

Current Spec WildFly Version

MP 7.1 Spec Version

Updated Functionality (y/n)

Config

3.1

3.1

3.1

n

Fault Tolerance

4.1

4.1

4.1

n

Health

4.0

4.0

4.0

n

JWT

2.1

2.1

2.1

n

OpenAPI

4.0

4.0

4.1

y - WFLY-20686

Rest Client

4.0

4.0

4.0

n

Telemetry

2.0

2.0

2.1

y - WFLY-20685

There are only two trivial spec updates for this platform upgrade, so the analysis for both updates will be handled in this document.

User Stories

A user can use WildFly knowing that the specs making up the MicroProfile Platform have the versions in MicroProfile Platform 7.1.

Issue Metadata

The main work is in these individual spec updates:

Affected Projects or Components

WildFly will be updated to pull in the corresponding versions of the Eclipse Microprofile specification jars, as well as the SmallRye jars and dependencies needed to implement each version.

Other Interested Projects

Relevant Installation Types

  • Traditional standalone server (unzipped or provisioned by Galleon)

  • Managed domain

  • OpenShift Source-to-Image (S2I)

  • Bootable jar

Requirements

Hard Requirements

  • All components will be upgraded to the version streams of the Eclipse Microprofile specification jars and TCK, as well as the SmallRye jars and dependencies needed to implement each version, as indicated in the table in the Overview. Note that although we’ve just given the minor versions of the specification jars, there may be some micro upgrades. Those are generally just TCK fixes.

    • Upgrading the components will provide the latest TCKs

Changed requirements

N/A

Non-Requirements

N/A

Future Work

When the next MicroProfile Platform version comes along, we are likely to support that (depending on how this lines up with WildFly releases).

Backwards Compatibility

  • MicroProfile Telemetry 2.1

    • There are no backwards compatibility issues for this component

  • MicroProfile OpenAPI 4.1

    • There are no backwards compatibility issues for this component

Default Configuration

  • MicroProfile Telemetry 2.1

    • There will be no changes to the default configuration.

  • MicroProfile OpenAPI 4.1

    • There will be no changes to the default configuration.

Importing Existing Configuration

  • MicroProfile Telemetry 2.1

    • There will be no impact to the existing configurations.

  • MicroProfile OpenAPI 4.1

    • There will be no impact to the existing configurations.

Deployments

  • MicroProfile Telemetry 2.1

    • There will be no change in behavior for deployments

  • MicroProfile OpenAPI 4.1

    • There will be no change in behavior for deployments

Interoperability

  • MicroProfile Telemetry 2.1

    • There are no interop issues with this update

  • MicroProfile OpenAPI 4.1

    • There are no interop issues with this update

Implementation Plan

We will merge the individual spec upgrades to this feature branch as they become available and have undergone peer review.

Once we have all the spec upgrades in this branch, and each individual RFE has satisfied all the requirements, we will merge this branch into the main WildFly branch.

Admin Clients

  • MicroProfile Telemetry 2.1

    • N/A

  • MicroProfile OpenAPI 4.1

    • N/A

Security Considerations

  • MicroProfile Telemetry 2.1

    • Nothing to consider

  • MicroProfile OpenAPI 4.1

    • Nothing to consider

Test Plan

  • TCKs will be updated to the latest corresponding version.

    • MP Telemetry 2.1

      • There is no new functionality, and the existing tests in WildFly’s testsuite/integration/expansion tests will ensure that the functionality works as before.

      • No new tests are needed.

    • MP OpenAPI 4.1

      • There is no new functionality, and the existing tests in WildFly’s testsuite/integration/expansion tests will ensure that the functionality works as before.

      • No new tests are needed.

  • The TCKs will run at default stability level

Community Documentation

Tracked in WFLY-20956: * There is a list of version of the individual specifications here https://github.com/wildfly/wildfly/blob/main/docs/src/main/asciidoc/Getting_Started_Guide.adoc?plain=1#L119-L129 This table will be updated to list the new versions * The subsystem configuration documentation for MicroProfile OpenAPI has some links which include the current version of the specification. These will be updated.

Release Note Content

MicroProfile specifications have been updated to the versions that are part of MicroProfile Platform 7.1. (See the table in the Overview if exact versions are needed)