Skip to content

Commit

Permalink
List 24.0.0.1 images including Java 21 + misc doc updates (#505)
Browse files Browse the repository at this point in the history 
* Update docs to include Java 21 images + misc updates

Signed-off-by: Leo Christy Jesuraj <[email protected]>
  • Loading branch information
@leochr
leochr authored Jan 31, 2024
1 parent b1a9f71 commit 5890b75
Show file tree
Hide file tree
Showing 2 changed files with 46 additions and 27 deletions.
16 changes: 4 additions & 12 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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/
Expand Down Expand Up @@ -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.
Expand Down
57 changes: 42 additions & 15 deletions docs/icr-images.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -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.
```
<fixpack_version_optional>-<liberty_image_flavour>-<java_version>-<java_type>-ubi
<optional fix pack version-><liberty image type>-<java version>-<java type>-<base image type>
```

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
Expand All @@ -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
```

0 comments on commit 5890b75

Please sign in to comment.