|
|
@@ -24,8 +24,11 @@ WARNING:
|
|
|
|
|
|
# Supported tags and respective `Dockerfile` links
|
|
|
|
|
|
-- [`8`, `8u265`, `8u265-al2`, `8-al2-full`, `8-al2-jdk`, `latest`](https://github.com/corretto/corretto-docker/blob/fa556a8d84f2d2f39b1925b15f4fb7ebd3e6e4ed/8/jdk/al2/Dockerfile)
|
|
|
-- [`11`, `11.0.8`, `11.0.8-al2`, `11-al2-jdk`, `11-al2-full`](https://github.com/corretto/corretto-docker/blob/fa556a8d84f2d2f39b1925b15f4fb7ebd3e6e4ed/11/jdk/al2/Dockerfile)
|
|
|
+- [`8`, `8u265`, `8u265-al2`, `8-al2-full`, `8-al2-jdk`, `latest`](https://github.com/corretto/corretto-docker/blob/45521b3fed98030c45c4a7fb23af52c614b48994/8/jdk/al2/Dockerfile)
|
|
|
+- [`11`, `11.0.8`, `11.0.8-al2`, `11-al2-jdk`, `11-al2-full`](https://github.com/corretto/corretto-docker/blob/45521b3fed98030c45c4a7fb23af52c614b48994/11/jdk/al2/Dockerfile)
|
|
|
+- [`8-alpine`, `8u262-alpine`, `8-alpine-full`, `8-alpine-jdk`](https://github.com/corretto/corretto-docker/blob/45521b3fed98030c45c4a7fb23af52c614b48994/8/jdk/alpine/Dockerfile)
|
|
|
+- [`8-alpine-jre`, `8u262-alpine-jre`](https://github.com/corretto/corretto-docker/blob/45521b3fed98030c45c4a7fb23af52c614b48994/8/jre/alpine/Dockerfile)
|
|
|
+- [`11-alpine`, `11.0.8-alpine`, `11-alpine-full`, `11-alpine-jdk`](https://github.com/corretto/corretto-docker/blob/45521b3fed98030c45c4a7fb23af52c614b48994/11/jdk/alpine/Dockerfile)
|
|
|
|
|
|
# Quick reference (cont.)
|
|
|
|
|
|
@@ -76,6 +79,22 @@ Amazon will provide security updates for Corretto 8 until at least June 2023. Up
|
|
|
|
|
|
Corretto is designed as a drop-in replacement for all Java SE distributions unless you are using features (e.g., Java Flight Recorder) not available in OpenJDK. Once Corretto binaries are installed on a host and correctly invoked to run your Java applications (e.g., using the alternatives command on Linux), existing command-line options, tuning parameters, monitoring, and anything else in place will continue to work as before.
|
|
|
|
|
|
+# Image Variants
|
|
|
+
|
|
|
+The `amazoncorretto` images come in many flavors, each designed for a specific use case.
|
|
|
+
|
|
|
+## `amazoncorretto:<version>`
|
|
|
+
|
|
|
+This is the defacto image. If you are unsure about what your needs are, you probably want to use this one. It is designed to be used both as a throw away container (mount your source code and start the container to start your app), as well as the base to build other images off of.
|
|
|
+
|
|
|
+## `amazoncorretto:<version>-alpine`
|
|
|
+
|
|
|
+This image is based on the popular [Alpine Linux project](https://alpinelinux.org), available in [the `alpine` official image](https://hub.docker.com/_/alpine). Alpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general.
|
|
|
+
|
|
|
+This variant is highly recommended when final image size being as small as possible is desired. The main caveat to note is that it does use [musl libc](https://musl.libc.org) instead of [glibc and friends](https://www.etalabs.net/compare_libcs.html), so certain software might run into issues depending on the depth of their libc requirements. However, most software doesn't have an issue with this, so this variant is usually a very safe choice. See [this Hacker News comment thread](https://news.ycombinator.com/item?id=10782897) for more discussion of the issues that might arise and some pro/con comparisons of using Alpine-based images.
|
|
|
+
|
|
|
+To minimize image size, it's uncommon for additional related tools (such as `git` or `bash`) to be included in Alpine-based images. Using this image as a base, add the things you need in your own Dockerfile (see the [`alpine` image description](https://hub.docker.com/_/alpine/) for examples of how to install packages if you are unfamiliar).
|
|
|
+
|
|
|
# License
|
|
|
|
|
|
Amazon Corretto is released under the same open source license as OpenJDK, which is licensed under the GNU Public License version 2 with the Class Path Exception ([GPLv2 with CPE](https://openjdk.java.net/legal/gplv2+ce.html)).
|