diff --git a/README.md b/README.md index 5ebba5e2..c146d821 100644 --- a/README.md +++ b/README.md @@ -19,16 +19,8 @@ ## Container Images 1. **Supported Images** - * Our recommended set uses Red Hat's [Universal Base Image](https://www.redhat.com/en/blog/introducing-red-hat-universal-base-image) as the Operating System and are re-built daily. They are available from [IBM Container Registry](docs/icr-images.md) and [Docker Hub](https://hub.docker.com/r/openliberty/open-liberty). - * Another set, using Ubuntu as the Operating System, can be found on [Docker Hub](https://hub.docker.com/_/open-liberty). These are re-built automatically anytime something changes in the layers below. - -1. **Beta Images** - * The latest Open Liberty beta runtime can be found on [Docker Hub](https://hub.docker.com/_/open-liberty). It's available via the `beta` and `beta-java11` tags. - -1. **Daily Images** - * Images with the daily Open Liberty binaries are available [here](https://hub.docker.com/r/openliberty/daily). The scripts used for this image can be found [here](https://github.com/OpenLiberty/ci.docker.daily). - -_**Important Notice:**_ The `kernel` **tag is now deprecated** and it will not be updated (starting with 20.0.0.11). The new tag, that provides kernel binary, is named `kernel-slim`. + * Our recommended set uses Red Hat's [Universal Base Image (UBI)](https://www.redhat.com/en/blog/introducing-red-hat-universal-base-image) as the Operating System and are rebuilt periodically. They are available from IBM Container Registry (icr.io) and are listed [here](docs/icr-images.md). + * Another set, using Ubuntu as the Operating System, can be found on [Docker Hub](https://hub.docker.com/_/open-liberty). ## Building an Application Image @@ -37,7 +29,7 @@ According to best practices for container images, you should create a new image Your application image template should follow a pattern similar to: ```dockerfile -FROM icr.io/appcafe/open-liberty:kernel-slim-java8-openj9-ubi +FROM icr.io/appcafe/open-liberty:kernel-slim-java17-openj9-ubi # Add Liberty server configuration including all necessary features COPY --chown=1001:0 server.xml /config/ @@ -91,7 +83,7 @@ This section describes the optional enterprise functionality that can be enabled ### Deprecated Enterprise Functionality -The following enterprise functionalities are now **deprecated**. You should **stop** using them. They are still available in `full` but not available in `kernel-slim`: +The following enterprise functionalities are now **deprecated**. You should **stop** using them. They are still available in `full` but not available in `kernel-slim`. They have been removed from the Open Liberty images based on Java 21 and above.: * `HTTP_ENDPOINT` * Description: Add configuration properties for an HTTP endpoint. diff --git a/docs/icr-images.md b/docs/icr-images.md index e3e70de4..bba502a4 100644 --- a/docs/icr-images.md +++ b/docs/icr-images.md @@ -5,11 +5,19 @@ Open Liberty container images are available from the IBM Container Registry (ICR The images for the latest Liberty release and the last two quarterly releases (versions ending in _.3_, _.6_, _.9_ and _.12_) are available and are refreshed regularly to include fixes for the operating system (OS) and Java. -Available image tags are listed below. The tags follow this naming convention: +Available image tags are listed below. The tags use the following naming convention. For more information on tags, see [Container image tags naming conventions](https://docs-draft-openlibertyio.mqj6zf7jocq.us-south.codeengine.appdomain.cloud/docs/latest/container-images.html#tags) documentation. ``` -----ubi +--- ``` +Liberty images with Java 21 are based on UBI 9 minimal and include IBM Semeru Runtimes for Java 21 JRE. This combination offers a compact and effective Java runtime that is suited for applications that need Java 21. + +Liberty images with Java 8, 11 and 17 and with the `openj9` type are based on UBI 8 standard and include IBM Semeru Runtime for the respective Java version with the JDK. Images with the `ibmjava` type are based on UBI 8 standard and include IBM Java 8 JRE. + +The `latest` tag simplifies pulling the full latest Open Liberty release with the latest Java JRE. It is an alias for the `full-java21-openj9-ubi-minimal` tag. If you do not specify a tag value, `latest` is used by default. + +The `beta` tag is based on UBI 9 minimal and the latest Java JRE and provides the most recent beta release of Liberty, which includes all the features and capabilities from the most recent release, plus new and updated features that are currently in development. + Append a tag to `icr.io/appcafe/open-liberty` to pull a specific image. For example: ``` icr.io/appcafe/open-liberty:23.0.0.12-kernel-slim-java17-openj9-ubi @@ -21,46 +29,65 @@ ibmcloud cr region-set global ibmcloud cr images --restrict appcafe/open-liberty ``` -## Latest version (23.0.0.12) +## Latest version (24.0.0.1) ``` +kernel-slim-java21-openj9-ubi-minimal +kernel-slim-java17-openj9-ubi +kernel-slim-java11-openj9-ubi kernel-slim-java8-openj9-ubi kernel-slim-java8-ibmjava-ubi -kernel-slim-java11-openj9-ubi -kernel-slim-java17-openj9-ubi +full-java21-openj9-ubi-minimal +full-java17-openj9-ubi +full-java11-openj9-ubi full-java8-openj9-ubi full-java8-ibmjava-ubi -full-java11-openj9-ubi -full-java17-openj9-ubi +latest beta ``` +## 24.0.0.1 + +``` +24.0.0.1-kernel-slim-java21-openj9-ubi-minimal +24.0.0.1-kernel-slim-java17-openj9-ubi +24.0.0.1-kernel-slim-java11-openj9-ubi +24.0.0.1-kernel-slim-java8-openj9-ubi +24.0.0.1-kernel-slim-java8-ibmjava-ubi + +24.0.0.1-full-java21-openj9-ubi-minimal +24.0.0.1-full-java17-openj9-ubi +24.0.0.1-full-java11-openj9-ubi +24.0.0.1-full-java8-openj9-ubi +24.0.0.1-full-java8-ibmjava-ubi +``` + ## 23.0.0.12 ``` +23.0.0.12-kernel-slim-java17-openj9-ubi +23.0.0.12-kernel-slim-java11-openj9-ubi 23.0.0.12-kernel-slim-java8-openj9-ubi 23.0.0.12-kernel-slim-java8-ibmjava-ubi -23.0.0.12-kernel-slim-java11-openj9-ubi -23.0.0.12-kernel-slim-java17-openj9-ubi +23.0.0.12-full-java17-openj9-ubi +23.0.0.12-full-java11-openj9-ubi 23.0.0.12-full-java8-openj9-ubi 23.0.0.12-full-java8-ibmjava-ubi -23.0.0.12-full-java11-openj9-ubi -23.0.0.12-full-java17-openj9-ubi ``` ## 23.0.0.9 ``` +23.0.0.9-kernel-slim-java17-openj9-ubi +23.0.0.9-kernel-slim-java11-openj9-ubi 23.0.0.9-kernel-slim-java8-openj9-ubi 23.0.0.9-kernel-slim-java8-ibmjava-ubi -23.0.0.9-kernel-slim-java11-openj9-ubi -23.0.0.9-kernel-slim-java17-openj9-ubi +23.0.0.9-full-java17-openj9-ubi +23.0.0.9-full-java11-openj9-ubi 23.0.0.9-full-java8-openj9-ubi 23.0.0.9-full-java8-ibmjava-ubi -23.0.0.9-full-java11-openj9-ubi -23.0.0.9-full-java17-openj9-ubi ```