From 45e47c78670ef8cf489f1b041a991b04644e7dc1 Mon Sep 17 00:00:00 2001 From: Dinakar Guniguntala Date: Wed, 18 May 2016 02:45:46 -0400 Subject: [PATCH 1/6] =?UTF-8?q?Add=20documentation=20to=20the=20ibmjava=20?= =?UTF-8?q?(IBM=C2=AE=20SDK,=20Java=E2=84=A2=20Technology=20Edition)=20doc?= =?UTF-8?q?ker=20image.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ibmjava/README-short.txt | 1 + ibmjava/content.md | 89 ++++++++++++++++++++++++++++++++++++++++ ibmjava/github-repo | 1 + ibmjava/license.md | 7 ++++ ibmjava/user-feedback.md | 7 ++++ 5 files changed, 105 insertions(+) create mode 100644 ibmjava/README-short.txt create mode 100644 ibmjava/content.md create mode 100644 ibmjava/github-repo create mode 100644 ibmjava/license.md create mode 100644 ibmjava/user-feedback.md diff --git a/ibmjava/README-short.txt b/ibmjava/README-short.txt new file mode 100644 index 000000000..7b63fc2ce --- /dev/null +++ b/ibmjava/README-short.txt @@ -0,0 +1 @@ +Official IBM® SDK, Java™ Technology Edition Docker Image. diff --git a/ibmjava/content.md b/ibmjava/content.md new file mode 100644 index 000000000..8aa65565d --- /dev/null +++ b/ibmjava/content.md @@ -0,0 +1,89 @@ +### Overview + +The images in this repository contain IBM® SDK, Java™ Technology Edition. See the license section for restrictions that relate to the use of this image. For more information about IBM® SDK, Java™ Technology Edition and API documentation, see the [IBM Knowledge Center](http://www.ibm.com/support/knowledgecenter/SSYKE2/welcome_javasdk_family.html). For tutorials, recipes, and Java usage in Bluemix, see [IBM developerWorks](http://www.ibm.com/developerworks/java). + +Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. + +### Images + +There are three types of Docker images here: the Software Developers Kit (SDK), and the Java Runtime Environment (JRE) and a small footprint version of the JRE (SFJ). These images can be used as the basis for custom built images for running your applications. + +##### Small Footprint JRE + +The Small Footprint JRE ([SFJ](http://download.boulder.ibm.com/ibmdl/pub/software/dw/jdk/docs/bluemix/libertyforjava_jre.doc.html)) is designed specifically for web developers who want to develop and deploy cloud-based Java applications. Java tools and functions that are not required in the cloud environment, such as the Java control panel, are removed. The runtime environment is stripped down to provide core, essential function that has a greatly reduced disk and memory footprint. + +##### Alpine Linux + +Consider using [Alpine Linux](http://alpinelinux.org/) if you are concerned about the size of the overall image. Alpine Linux is a stripped down version of Linux that is based on [musl glibc](http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc) and Busybox, resulting in a [Docker image](https://hub.docker.com/_/alpine/) size of approximately 5 MB. Due to its extremely small size and reduced number of installed packages, it has a much smaller attack surface which improves security. However, because the IBM SDK has a dependency on gnu glibc, installing this library adds an extra 8 MB to the image size. The following table compares Docker Image sizes based on the latest JRE `8.0-3.0`. + +| JRE | JRE | SFJ | SFJ | +|:------:|:------:|:------:|:------:| +| Ubuntu | Alpine | Ubuntu | Alpine | +| 300 MB | 186 MB | 218 MB | 104 MB | + +**Note: Alpine Linux is not an officially supported operating system for IBM® SDK, Java™ Technology Edition.** + +To run a pre-built jar file with the JRE image, use the following commands: + +```dockerfile +FROM ibmjava:jre +RUN mkdir /opt/app +COPY japp.jar /opt/app +CMD ["java", "-jar", "/opt/app/japp.jar"] +``` + +You can build and run the Docker Image as shown in the following example: + +```console +docker build -t japp . +docker run -it --rm japp +``` + +If you want to place the jar file on the host file system instead of inside the container, you can mount the host path onto the container by using the following commands: + +```dockerfile +FROM ibmjava:jre +CMD ["java", "-jar", "/opt/app/japp.jar"] +``` + +```console +docker build -t japp . +docker run -it -v /path/on/host/system/jars:/opt/app japp +``` + +### Using the Class Data Sharing feature + +IBM SDK, Java Technology Edition provides a feature called [Class data sharing](http://www-01.ibm.com/support/knowledgecenter/SSYKE2_8.0.0/com.ibm.java.lnx.80.doc/diag/understanding/shared_classes.html). This mechanism offers transparent and dynamic sharing of data between multiple Java virtual machines (JVMs) running on the same host thereby reducing the amount of physical memory consumed by each JVM instance. By providing partially verified classes and possibly pre-loaded classes in memory, this mechanism also improves the start up time of the JVM. + +To enable class data sharing between JVMs that are running in different containers on the same host, a common location must be shared between containers. This requirement can be satisfied through the host or a data volume container. When enabled, class data sharing creates a named "class cache", which is a memory-mapped file, at the common location. This feature is enabled by passing the `-Xshareclasses` option to the JVM as shown in the following Dockerfile example: + +```dockerfile +FROM ibmjava:jre +RUN mkdir /opt/shareclasses +RUN mkdir /opt/app +COPY japp.jar /opt/app +CMD ["java", "-Xshareclasses:cacheDir=/opt/shareclasses", "-jar", "/opt/app/japp.jar"] +``` + +The `cacheDir` sub-option specifies the location of the class cache. For example `/opt/sharedclasses`. When sharing through the host, a host path must be mounted onto the container at the location the JVM expects to find the class cache. For example: + +```console +docker build -t japp . +docker run -it -v /path/on/host/shareclasses/dir:/opt/shareclasses japp +``` + +When sharing through a data volume container, create a named data volume container that shares a volume. + +```console +docker create -v /opt/shareclasses --name classcache japp /bin/true +``` + +Then start your JVM container by using `--volumes-from` flag to mount the shared volume, as shown in the following example: + +```console +docker run -it --volumes-from classcache japp +``` + +### See Also + +See the [Websphere-Liberty image](https://hub.docker.com/_/websphere-liberty/), which builds on top of this IBM docker image for Java. diff --git a/ibmjava/github-repo b/ibmjava/github-repo new file mode 100644 index 000000000..529995006 --- /dev/null +++ b/ibmjava/github-repo @@ -0,0 +1 @@ +https://github.com/ibmruntimes/ci.docker diff --git a/ibmjava/license.md b/ibmjava/license.md new file mode 100644 index 000000000..14521b0af --- /dev/null +++ b/ibmjava/license.md @@ -0,0 +1,7 @@ +### License + +The Dockerfiles and associated scripts are licensed under the [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0.html). + +Licenses for the products installed within the images: + +- IBM® SDK, Java™ Technology Edition: [International License Agreement for Non-Warranted Programs](http://www14.software.ibm.com/cgi-bin/weblap/lap.pl?la_formnum=&li_formnum=L-PMAA-A3Z8P2&title=IBM® SDK, Java™ Technology Edition Docker Image, Version 8.0&l=en). diff --git a/ibmjava/user-feedback.md b/ibmjava/user-feedback.md new file mode 100644 index 000000000..b2593e248 --- /dev/null +++ b/ibmjava/user-feedback.md @@ -0,0 +1,7 @@ +#### Issues + +For issues relating specifically to this Docker image, please use the [GitHub issue tracker](https://github.com/ibmruntimes/ci.docker/issues). + +For more general issues relating to IBM® SDK, Java™ Technology Edition you can ask questions in the developerWorks forum: [IBM Java Runtimes and SDKs](https://www.ibm.com/developerworks/community/forums/html/forum?id=11111111-0000-0000-0000-000000000367). + +For general information on Troubleshooting with the SDK, please do take a look at our [How Do I ...?](http://www.ibm.com/developerworks/java/jdk/howdoi/) page. From 3940cdf327928f19dfdc503105048993f3811178 Mon Sep 17 00:00:00 2001 From: Dinakar Guniguntala Date: Wed, 18 May 2016 05:43:43 -0400 Subject: [PATCH 2/6] =?UTF-8?q?Revert=20"Add=20documentation=20to=20the=20?= =?UTF-8?q?ibmjava=20(IBM=C2=AE=20SDK,=20Java=E2=84=A2=20Technology=20Edit?= =?UTF-8?q?ion)=20docker=20image."?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This reverts commit 45e47c78670ef8cf489f1b041a991b04644e7dc1. --- ibmjava/README-short.txt | 1 - ibmjava/content.md | 89 ---------------------------------------- ibmjava/github-repo | 1 - ibmjava/license.md | 7 ---- ibmjava/user-feedback.md | 7 ---- 5 files changed, 105 deletions(-) delete mode 100644 ibmjava/README-short.txt delete mode 100644 ibmjava/content.md delete mode 100644 ibmjava/github-repo delete mode 100644 ibmjava/license.md delete mode 100644 ibmjava/user-feedback.md diff --git a/ibmjava/README-short.txt b/ibmjava/README-short.txt deleted file mode 100644 index 7b63fc2ce..000000000 --- a/ibmjava/README-short.txt +++ /dev/null @@ -1 +0,0 @@ -Official IBM® SDK, Java™ Technology Edition Docker Image. diff --git a/ibmjava/content.md b/ibmjava/content.md deleted file mode 100644 index 8aa65565d..000000000 --- a/ibmjava/content.md +++ /dev/null @@ -1,89 +0,0 @@ -### Overview - -The images in this repository contain IBM® SDK, Java™ Technology Edition. See the license section for restrictions that relate to the use of this image. For more information about IBM® SDK, Java™ Technology Edition and API documentation, see the [IBM Knowledge Center](http://www.ibm.com/support/knowledgecenter/SSYKE2/welcome_javasdk_family.html). For tutorials, recipes, and Java usage in Bluemix, see [IBM developerWorks](http://www.ibm.com/developerworks/java). - -Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. - -### Images - -There are three types of Docker images here: the Software Developers Kit (SDK), and the Java Runtime Environment (JRE) and a small footprint version of the JRE (SFJ). These images can be used as the basis for custom built images for running your applications. - -##### Small Footprint JRE - -The Small Footprint JRE ([SFJ](http://download.boulder.ibm.com/ibmdl/pub/software/dw/jdk/docs/bluemix/libertyforjava_jre.doc.html)) is designed specifically for web developers who want to develop and deploy cloud-based Java applications. Java tools and functions that are not required in the cloud environment, such as the Java control panel, are removed. The runtime environment is stripped down to provide core, essential function that has a greatly reduced disk and memory footprint. - -##### Alpine Linux - -Consider using [Alpine Linux](http://alpinelinux.org/) if you are concerned about the size of the overall image. Alpine Linux is a stripped down version of Linux that is based on [musl glibc](http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc) and Busybox, resulting in a [Docker image](https://hub.docker.com/_/alpine/) size of approximately 5 MB. Due to its extremely small size and reduced number of installed packages, it has a much smaller attack surface which improves security. However, because the IBM SDK has a dependency on gnu glibc, installing this library adds an extra 8 MB to the image size. The following table compares Docker Image sizes based on the latest JRE `8.0-3.0`. - -| JRE | JRE | SFJ | SFJ | -|:------:|:------:|:------:|:------:| -| Ubuntu | Alpine | Ubuntu | Alpine | -| 300 MB | 186 MB | 218 MB | 104 MB | - -**Note: Alpine Linux is not an officially supported operating system for IBM® SDK, Java™ Technology Edition.** - -To run a pre-built jar file with the JRE image, use the following commands: - -```dockerfile -FROM ibmjava:jre -RUN mkdir /opt/app -COPY japp.jar /opt/app -CMD ["java", "-jar", "/opt/app/japp.jar"] -``` - -You can build and run the Docker Image as shown in the following example: - -```console -docker build -t japp . -docker run -it --rm japp -``` - -If you want to place the jar file on the host file system instead of inside the container, you can mount the host path onto the container by using the following commands: - -```dockerfile -FROM ibmjava:jre -CMD ["java", "-jar", "/opt/app/japp.jar"] -``` - -```console -docker build -t japp . -docker run -it -v /path/on/host/system/jars:/opt/app japp -``` - -### Using the Class Data Sharing feature - -IBM SDK, Java Technology Edition provides a feature called [Class data sharing](http://www-01.ibm.com/support/knowledgecenter/SSYKE2_8.0.0/com.ibm.java.lnx.80.doc/diag/understanding/shared_classes.html). This mechanism offers transparent and dynamic sharing of data between multiple Java virtual machines (JVMs) running on the same host thereby reducing the amount of physical memory consumed by each JVM instance. By providing partially verified classes and possibly pre-loaded classes in memory, this mechanism also improves the start up time of the JVM. - -To enable class data sharing between JVMs that are running in different containers on the same host, a common location must be shared between containers. This requirement can be satisfied through the host or a data volume container. When enabled, class data sharing creates a named "class cache", which is a memory-mapped file, at the common location. This feature is enabled by passing the `-Xshareclasses` option to the JVM as shown in the following Dockerfile example: - -```dockerfile -FROM ibmjava:jre -RUN mkdir /opt/shareclasses -RUN mkdir /opt/app -COPY japp.jar /opt/app -CMD ["java", "-Xshareclasses:cacheDir=/opt/shareclasses", "-jar", "/opt/app/japp.jar"] -``` - -The `cacheDir` sub-option specifies the location of the class cache. For example `/opt/sharedclasses`. When sharing through the host, a host path must be mounted onto the container at the location the JVM expects to find the class cache. For example: - -```console -docker build -t japp . -docker run -it -v /path/on/host/shareclasses/dir:/opt/shareclasses japp -``` - -When sharing through a data volume container, create a named data volume container that shares a volume. - -```console -docker create -v /opt/shareclasses --name classcache japp /bin/true -``` - -Then start your JVM container by using `--volumes-from` flag to mount the shared volume, as shown in the following example: - -```console -docker run -it --volumes-from classcache japp -``` - -### See Also - -See the [Websphere-Liberty image](https://hub.docker.com/_/websphere-liberty/), which builds on top of this IBM docker image for Java. diff --git a/ibmjava/github-repo b/ibmjava/github-repo deleted file mode 100644 index 529995006..000000000 --- a/ibmjava/github-repo +++ /dev/null @@ -1 +0,0 @@ -https://github.com/ibmruntimes/ci.docker diff --git a/ibmjava/license.md b/ibmjava/license.md deleted file mode 100644 index 14521b0af..000000000 --- a/ibmjava/license.md +++ /dev/null @@ -1,7 +0,0 @@ -### License - -The Dockerfiles and associated scripts are licensed under the [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0.html). - -Licenses for the products installed within the images: - -- IBM® SDK, Java™ Technology Edition: [International License Agreement for Non-Warranted Programs](http://www14.software.ibm.com/cgi-bin/weblap/lap.pl?la_formnum=&li_formnum=L-PMAA-A3Z8P2&title=IBM® SDK, Java™ Technology Edition Docker Image, Version 8.0&l=en). diff --git a/ibmjava/user-feedback.md b/ibmjava/user-feedback.md deleted file mode 100644 index b2593e248..000000000 --- a/ibmjava/user-feedback.md +++ /dev/null @@ -1,7 +0,0 @@ -#### Issues - -For issues relating specifically to this Docker image, please use the [GitHub issue tracker](https://github.com/ibmruntimes/ci.docker/issues). - -For more general issues relating to IBM® SDK, Java™ Technology Edition you can ask questions in the developerWorks forum: [IBM Java Runtimes and SDKs](https://www.ibm.com/developerworks/community/forums/html/forum?id=11111111-0000-0000-0000-000000000367). - -For general information on Troubleshooting with the SDK, please do take a look at our [How Do I ...?](http://www.ibm.com/developerworks/java/jdk/howdoi/) page. From fba2e20b6eb1ef2456f7e7e78cdad1c88d99f716 Mon Sep 17 00:00:00 2001 From: Dinakar Guniguntala Date: Wed, 18 May 2016 06:00:34 -0400 Subject: [PATCH 3/6] =?UTF-8?q?Add=20documentation=20to=20the=20ibmjava=20?= =?UTF-8?q?(IBM=C2=AE=20SDK,=20Java=E2=84=A2=20Technology=20Edition)=20doc?= =?UTF-8?q?ker=20image.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ibmjava/README-short.txt | 1 + ibmjava/content.md | 89 ++++++++++++++++++++++++++++++++++++++++ ibmjava/github-repo | 1 + ibmjava/license.md | 7 ++++ ibmjava/user-feedback.md | 7 ++++ 5 files changed, 105 insertions(+) create mode 100644 ibmjava/README-short.txt create mode 100644 ibmjava/content.md create mode 100644 ibmjava/github-repo create mode 100644 ibmjava/license.md create mode 100644 ibmjava/user-feedback.md diff --git a/ibmjava/README-short.txt b/ibmjava/README-short.txt new file mode 100644 index 000000000..7b63fc2ce --- /dev/null +++ b/ibmjava/README-short.txt @@ -0,0 +1 @@ +Official IBM® SDK, Java™ Technology Edition Docker Image. diff --git a/ibmjava/content.md b/ibmjava/content.md new file mode 100644 index 000000000..8aa65565d --- /dev/null +++ b/ibmjava/content.md @@ -0,0 +1,89 @@ +### Overview + +The images in this repository contain IBM® SDK, Java™ Technology Edition. See the license section for restrictions that relate to the use of this image. For more information about IBM® SDK, Java™ Technology Edition and API documentation, see the [IBM Knowledge Center](http://www.ibm.com/support/knowledgecenter/SSYKE2/welcome_javasdk_family.html). For tutorials, recipes, and Java usage in Bluemix, see [IBM developerWorks](http://www.ibm.com/developerworks/java). + +Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. + +### Images + +There are three types of Docker images here: the Software Developers Kit (SDK), and the Java Runtime Environment (JRE) and a small footprint version of the JRE (SFJ). These images can be used as the basis for custom built images for running your applications. + +##### Small Footprint JRE + +The Small Footprint JRE ([SFJ](http://download.boulder.ibm.com/ibmdl/pub/software/dw/jdk/docs/bluemix/libertyforjava_jre.doc.html)) is designed specifically for web developers who want to develop and deploy cloud-based Java applications. Java tools and functions that are not required in the cloud environment, such as the Java control panel, are removed. The runtime environment is stripped down to provide core, essential function that has a greatly reduced disk and memory footprint. + +##### Alpine Linux + +Consider using [Alpine Linux](http://alpinelinux.org/) if you are concerned about the size of the overall image. Alpine Linux is a stripped down version of Linux that is based on [musl glibc](http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc) and Busybox, resulting in a [Docker image](https://hub.docker.com/_/alpine/) size of approximately 5 MB. Due to its extremely small size and reduced number of installed packages, it has a much smaller attack surface which improves security. However, because the IBM SDK has a dependency on gnu glibc, installing this library adds an extra 8 MB to the image size. The following table compares Docker Image sizes based on the latest JRE `8.0-3.0`. + +| JRE | JRE | SFJ | SFJ | +|:------:|:------:|:------:|:------:| +| Ubuntu | Alpine | Ubuntu | Alpine | +| 300 MB | 186 MB | 218 MB | 104 MB | + +**Note: Alpine Linux is not an officially supported operating system for IBM® SDK, Java™ Technology Edition.** + +To run a pre-built jar file with the JRE image, use the following commands: + +```dockerfile +FROM ibmjava:jre +RUN mkdir /opt/app +COPY japp.jar /opt/app +CMD ["java", "-jar", "/opt/app/japp.jar"] +``` + +You can build and run the Docker Image as shown in the following example: + +```console +docker build -t japp . +docker run -it --rm japp +``` + +If you want to place the jar file on the host file system instead of inside the container, you can mount the host path onto the container by using the following commands: + +```dockerfile +FROM ibmjava:jre +CMD ["java", "-jar", "/opt/app/japp.jar"] +``` + +```console +docker build -t japp . +docker run -it -v /path/on/host/system/jars:/opt/app japp +``` + +### Using the Class Data Sharing feature + +IBM SDK, Java Technology Edition provides a feature called [Class data sharing](http://www-01.ibm.com/support/knowledgecenter/SSYKE2_8.0.0/com.ibm.java.lnx.80.doc/diag/understanding/shared_classes.html). This mechanism offers transparent and dynamic sharing of data between multiple Java virtual machines (JVMs) running on the same host thereby reducing the amount of physical memory consumed by each JVM instance. By providing partially verified classes and possibly pre-loaded classes in memory, this mechanism also improves the start up time of the JVM. + +To enable class data sharing between JVMs that are running in different containers on the same host, a common location must be shared between containers. This requirement can be satisfied through the host or a data volume container. When enabled, class data sharing creates a named "class cache", which is a memory-mapped file, at the common location. This feature is enabled by passing the `-Xshareclasses` option to the JVM as shown in the following Dockerfile example: + +```dockerfile +FROM ibmjava:jre +RUN mkdir /opt/shareclasses +RUN mkdir /opt/app +COPY japp.jar /opt/app +CMD ["java", "-Xshareclasses:cacheDir=/opt/shareclasses", "-jar", "/opt/app/japp.jar"] +``` + +The `cacheDir` sub-option specifies the location of the class cache. For example `/opt/sharedclasses`. When sharing through the host, a host path must be mounted onto the container at the location the JVM expects to find the class cache. For example: + +```console +docker build -t japp . +docker run -it -v /path/on/host/shareclasses/dir:/opt/shareclasses japp +``` + +When sharing through a data volume container, create a named data volume container that shares a volume. + +```console +docker create -v /opt/shareclasses --name classcache japp /bin/true +``` + +Then start your JVM container by using `--volumes-from` flag to mount the shared volume, as shown in the following example: + +```console +docker run -it --volumes-from classcache japp +``` + +### See Also + +See the [Websphere-Liberty image](https://hub.docker.com/_/websphere-liberty/), which builds on top of this IBM docker image for Java. diff --git a/ibmjava/github-repo b/ibmjava/github-repo new file mode 100644 index 000000000..529995006 --- /dev/null +++ b/ibmjava/github-repo @@ -0,0 +1 @@ +https://github.com/ibmruntimes/ci.docker diff --git a/ibmjava/license.md b/ibmjava/license.md new file mode 100644 index 000000000..14521b0af --- /dev/null +++ b/ibmjava/license.md @@ -0,0 +1,7 @@ +### License + +The Dockerfiles and associated scripts are licensed under the [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0.html). + +Licenses for the products installed within the images: + +- IBM® SDK, Java™ Technology Edition: [International License Agreement for Non-Warranted Programs](http://www14.software.ibm.com/cgi-bin/weblap/lap.pl?la_formnum=&li_formnum=L-PMAA-A3Z8P2&title=IBM® SDK, Java™ Technology Edition Docker Image, Version 8.0&l=en). diff --git a/ibmjava/user-feedback.md b/ibmjava/user-feedback.md new file mode 100644 index 000000000..b2593e248 --- /dev/null +++ b/ibmjava/user-feedback.md @@ -0,0 +1,7 @@ +#### Issues + +For issues relating specifically to this Docker image, please use the [GitHub issue tracker](https://github.com/ibmruntimes/ci.docker/issues). + +For more general issues relating to IBM® SDK, Java™ Technology Edition you can ask questions in the developerWorks forum: [IBM Java Runtimes and SDKs](https://www.ibm.com/developerworks/community/forums/html/forum?id=11111111-0000-0000-0000-000000000367). + +For general information on Troubleshooting with the SDK, please do take a look at our [How Do I ...?](http://www.ibm.com/developerworks/java/jdk/howdoi/) page. From 432fb10907a1e9b851d7232d3522b7530017d44c Mon Sep 17 00:00:00 2001 From: Dinakar Guniguntala Date: Wed, 18 May 2016 09:11:01 -0400 Subject: [PATCH 4/6] Update content.md to conform to docker md. --- ibmjava/content.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ibmjava/content.md b/ibmjava/content.md index 8aa65565d..cd79e91d9 100644 --- a/ibmjava/content.md +++ b/ibmjava/content.md @@ -16,7 +16,7 @@ The Small Footprint JRE ([SFJ](http://download.boulder.ibm.com/ibmdl/pub/softwar Consider using [Alpine Linux](http://alpinelinux.org/) if you are concerned about the size of the overall image. Alpine Linux is a stripped down version of Linux that is based on [musl glibc](http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc) and Busybox, resulting in a [Docker image](https://hub.docker.com/_/alpine/) size of approximately 5 MB. Due to its extremely small size and reduced number of installed packages, it has a much smaller attack surface which improves security. However, because the IBM SDK has a dependency on gnu glibc, installing this library adds an extra 8 MB to the image size. The following table compares Docker Image sizes based on the latest JRE `8.0-3.0`. -| JRE | JRE | SFJ | SFJ | +| JRE | JRE | SFJ | SFJ | |:------:|:------:|:------:|:------:| | Ubuntu | Alpine | Ubuntu | Alpine | | 300 MB | 186 MB | 218 MB | 104 MB | From 31c90046e8340f099c1b1a77d97455b197708c64 Mon Sep 17 00:00:00 2001 From: Dinakar Guniguntala Date: Tue, 9 Aug 2016 21:55:03 +0530 Subject: [PATCH 5/6] Update version to 1.8.0_sr3fp10 and add links to s390x and ppc64le images. --- ibmjava/content.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/ibmjava/content.md b/ibmjava/content.md index cd79e91d9..314b3ccd9 100644 --- a/ibmjava/content.md +++ b/ibmjava/content.md @@ -1,6 +1,6 @@ ### Overview -The images in this repository contain IBM® SDK, Java™ Technology Edition. See the license section for restrictions that relate to the use of this image. For more information about IBM® SDK, Java™ Technology Edition and API documentation, see the [IBM Knowledge Center](http://www.ibm.com/support/knowledgecenter/SSYKE2/welcome_javasdk_family.html). For tutorials, recipes, and Java usage in Bluemix, see [IBM developerWorks](http://www.ibm.com/developerworks/java). +The images in this repository contain IBM® SDK, Java™ Technology Edition, version 1.8.0\_sr3fp10 (8.0-3.10). See [what's new](http://www.ibm.com/support/knowledgecenter/SSYKE2_8.0.0/com.ibm.java.lnx.80.doc/diag/preface/changes_80/whatsnew_sr3fp10.html). See the license section for restrictions that relate to the use of this image. For more information about IBM® SDK, Java™ Technology Edition and API documentation, see the [IBM Knowledge Center](http://www.ibm.com/support/knowledgecenter/SSYKE2/welcome_javasdk_family.html). For tutorials, recipes, and Java usage in Bluemix, see [IBM developerWorks](http://www.ibm.com/developerworks/java). Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. @@ -14,15 +14,21 @@ The Small Footprint JRE ([SFJ](http://download.boulder.ibm.com/ibmdl/pub/softwar ##### Alpine Linux -Consider using [Alpine Linux](http://alpinelinux.org/) if you are concerned about the size of the overall image. Alpine Linux is a stripped down version of Linux that is based on [musl glibc](http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc) and Busybox, resulting in a [Docker image](https://hub.docker.com/_/alpine/) size of approximately 5 MB. Due to its extremely small size and reduced number of installed packages, it has a much smaller attack surface which improves security. However, because the IBM SDK has a dependency on gnu glibc, installing this library adds an extra 8 MB to the image size. The following table compares Docker Image sizes based on the latest JRE `8.0-3.0`. +Consider using [Alpine Linux](http://alpinelinux.org/) if you are concerned about the size of the overall image. Alpine Linux is a stripped down version of Linux that is based on [musl glibc](http://wiki.musl-libc.org/wiki/Functional_differences_from_glibc) and Busybox, resulting in a [Docker image](https://hub.docker.com/_/alpine/) size of approximately 5 MB. Due to its extremely small size and reduced number of installed packages, it has a much smaller attack surface which improves security. However, because the IBM SDK has a dependency on gnu glibc, installing this library adds an extra 8 MB to the image size. The following table compares Docker Image sizes based on the latest JRE `8.0-3.10`. | JRE | JRE | SFJ | SFJ | |:------:|:------:|:------:|:------:| | Ubuntu | Alpine | Ubuntu | Alpine | -| 300 MB | 186 MB | 218 MB | 104 MB | +| 305 MB | 184 MB | 220 MB | 101 MB | **Note: Alpine Linux is not an officially supported operating system for IBM® SDK, Java™ Technology Edition.** +##### Architectures Supported + +In addition to the x86\_64 images, [ppc64le](https://hub.docker.com/r/ppc64le/ibmjava/) and [s390x](https://hub.docker.com/r/s390x/ibmjava/) images are available as well. + +### How to use this Image + To run a pre-built jar file with the JRE image, use the following commands: ```dockerfile From 7e928389776157152ac1cee517a23a9e5257699a Mon Sep 17 00:00:00 2001 From: Dinakar Guniguntala Date: Wed, 10 Aug 2016 14:22:56 +0530 Subject: [PATCH 6/6] Update url for SFJ and image urls for x86_64, ppc64le and s390x. --- ibmjava/content.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/ibmjava/content.md b/ibmjava/content.md index 314b3ccd9..821ea7ceb 100644 --- a/ibmjava/content.md +++ b/ibmjava/content.md @@ -10,7 +10,7 @@ There are three types of Docker images here: the Software Developers Kit (SDK), ##### Small Footprint JRE -The Small Footprint JRE ([SFJ](http://download.boulder.ibm.com/ibmdl/pub/software/dw/jdk/docs/bluemix/libertyforjava_jre.doc.html)) is designed specifically for web developers who want to develop and deploy cloud-based Java applications. Java tools and functions that are not required in the cloud environment, such as the Java control panel, are removed. The runtime environment is stripped down to provide core, essential function that has a greatly reduced disk and memory footprint. +The Small Footprint JRE ([SFJ](http://www.ibm.com/support/knowledgecenter/en/SSYKE2_8.0.0/com.ibm.java.lnx.80.doc/user/small_jre.html)) is designed specifically for web developers who want to develop and deploy cloud-based Java applications. Java tools and functions that are not required in the cloud environment, such as the Java control panel, are removed. The runtime environment is stripped down to provide core, essential function that has a greatly reduced disk and memory footprint. ##### Alpine Linux @@ -25,7 +25,11 @@ Consider using [Alpine Linux](http://alpinelinux.org/) if you are concerned abou ##### Architectures Supported -In addition to the x86\_64 images, [ppc64le](https://hub.docker.com/r/ppc64le/ibmjava/) and [s390x](https://hub.docker.com/r/s390x/ibmjava/) images are available as well. +Docker Images for the following architectures are now available: + +- [x86\_64](https://hub.docker.com/_/ibmjava/) +- [ppc64le](https://hub.docker.com/r/ppc64le/ibmjava/) +- [s390x](https://hub.docker.com/r/s390x/ibmjava/) ### How to use this Image