RFR: 8311302: Allow for jlinking a custom runtime without packaged modules being present [v4]
Severin Gehwolf
sgehwolf at openjdk.org
Fri Oct 6 11:17:32 UTC 2023
> Please review this patch which adds a "jmodless" jlink mode to the JDK. Fundamentally this patch adds an option to use `jlink` even though your JDK install might not come with the packaged modules (directory `jmods`). This is particularly useful to further reduce the size of a jlinked runtime. After the removal of the concept of a JRE, a common distribution mechanism is still the full JDK with all modules and packaged modules. However, packaged modules can incur an additional size tax. For example in a container scenario it could be useful to have a base JDK container including all modules, but without also delivering the packaged modules. This comes at a size advantage of `~25%`. Such a base JDK container could then be used to `jlink` application specific runtimes, further reducing the size of the application runtime image (App + JDK runtime; as a single image *or* separate bundles, depending on the app being modularized).
>
> The basic design of this approach is to add a jlink plugin for tracking non-class and non-resource files of a JDK install. I.e. files which aren't present in the jimage (`lib/modules`). This enables producing a `JmodLessArchive` class which has all the info of what constitutes the final jlinked runtime.
>
> Basic usage example:
>
> $ diff -u <(./bin/java --list-modules --limit-modules java.se) <(../linux-x86_64-server-release/images/jdk/bin/java --list-modules --limit-modules java.se)
> $ diff -u <(./bin/java --list-modules --limit-modules java.se) <(../linux-x86_64-server-release/images/jdk/bin/java --list-modules --limit-modules jdk.jlink)
> $ ls ../linux-x86_64-server-release/images/jdk/jmods
> java.base.jmod java.net.http.jmod java.sql.rowset.jmod jdk.crypto.ec.jmod jdk.internal.opt.jmod jdk.jdi.jmod jdk.management.agent.jmod jdk.security.auth.jmod
> java.compiler.jmod java.prefs.jmod java.transaction.xa.jmod jdk.dynalink.jmod jdk.internal.vm.ci.jmod jdk.jdwp.agent.jmod jdk.management.jfr.jmod jdk.security.jgss.jmod
> java.datatransfer.jmod java.rmi.jmod java.xml.crypto.jmod jdk.editpad.jmod jdk.internal.vm.compiler.jmod jdk.jfr.jmod jdk.management.jmod jdk.unsupported.desktop.jmod
> java.desktop.jmod java.scripting.jmod java.xml.jmod jdk.hotspot.agent.jmod jdk.internal.vm.compiler.management.jmod jdk.jlink.jmod jdk.naming.dns.jmod jdk.unsupported...
Severin Gehwolf has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains seven additional commits since the last revision:
- Work-around JDK-8317609 (jdk.jcmd module doesn't verify)
- Fix tests after merge
- Merge branch 'master' into jdk-8311302-jmodless-link
- Implementation for run-image link and single-hop
This uses a stamp file in 'lib/modules' jimage in order to recognize
multi-hop links. However, this has the caveat of no longer producing
reproducible builds as compared to a packaged module-based link.
Add an option to allow for multi-hop, which disables the stamp file
addition and makes it reproducible again.
- Exit the jlink on modified files by default
This is configurable so add tests for both scenarios.
- Use 'run-image' as the term shown with --verbose
- 8311302: Allow for jlinking a custom runtime without packaged modules being present
-------------
Changes:
- all: https://git.openjdk.org/jdk/pull/14787/files
- new: https://git.openjdk.org/jdk/pull/14787/files/738b8a31..2e73e300
Webrevs:
- full: https://webrevs.openjdk.org/?repo=jdk&pr=14787&range=03
- incr: https://webrevs.openjdk.org/?repo=jdk&pr=14787&range=02-03
Stats: 144634 lines in 4016 files changed: 69362 ins; 29938 del; 45334 mod
Patch: https://git.openjdk.org/jdk/pull/14787.diff
Fetch: git fetch https://git.openjdk.org/jdk.git pull/14787/head:pull/14787
PR: https://git.openjdk.org/jdk/pull/14787
More information about the core-libs-dev
mailing list