Remove the usage of the global metadata/index.json from the nbt plugins by jormundur00 · Pull Request #829 · graalvm/native-build-tools

jormundur00 · 2026-02-02T13:29:05Z

In this PR, we remove the legacy repository-wide metadata/index.json and switch fully to per-module index.json files as the single source of truth for reachability metadata discovery and dependency expansion.

Motivation:

The repository structure already maintains per-module metadata at groupId/artifactId/index.json. The outer metadata/index.json was redundant and a frequent source of confusion during packaging and updates.
Removing the global index reduces duplication, simplifies metadata publishing, and aligns directory scanning with the canonical per-module layout.

Summary of changes:

Eliminate all usage of the top-level metadata/index.json. Discovery and resolution now operate exclusively on per-module index.json.
Keep and clarify one-hop “requires” expansion at module level:
- For a requested module (G:A), we include its own module directory and the conventional directories of any modules listed under "requires" in G/A/index.json.
Maintain behavior expected by downstream consumers and tests:
- Modules which declare actual metadata will be included as configuration directories.
- Aggregator modules (like io.netty:netty-all) are included themselves and also expand their “requires” to bring in dependent module directories.

As running changes in this PR depend on the reachability metadata repository PR which removes this metadata/index.json file, and the reachability metadata PR depends on buildtools working with this new format to test in the CI, the merge/release process of these PRs should have the following order:

The reachability metadata PR should be merged first (running CI on the branch of this buildtools PR to complete successfully),
The next reachability metadata release should be dispatched so that buildtools can use it in this PR,
This PR should include the bump to the new reachability metadata version and get merged ASAP,
Reachabilty metadata repository CI will work on the latest SNAPSHOT of buildtools until the new NBT release is released (which should be scheduled as soon as the PR is merged),
We open a PR on the reachability metadata repository to use the newest release of buildtools and no longer use snapshots in the CI.

Please review this PR in conjunction with the reachability metadata PR.

The CI tests in this PR all fail due to:

* What went wrong:
Could not determine the dependencies of task ':nativeTestCompile'.
> Failed to create service 'nativeConfigurationService'.
   > Could not create an instance of type org.graalvm.buildtools.gradle.internal.GraalVMReachabilityMetadataService.
      > The configured GraalVM reachability metadata repository at /home/jovan/NBT/native-build-tools/native-gradle-plugin/build/tmp/configCacheFunctionalTest/work/.gradle-test-kit/native-build-tools/repositories/480a9c4102624914066dd67a0bb0f0b8f6d5c1e8/exploded contains more schema files than supported by this version of Native Build Tools. Found 3 files under 'schemas' but exactly 2 are supported. Please update your Native Build Tools to a newer version which supports the newer schemas.

(as the reachability metadata used in the latest release supports 3 schema files). Without removing the check for the 3rd schema (the global metadata/index.json schema) the CI tests all pass. Once the reachability metadata PR is merged and the new release is out, the CI on this PR will be fixed.

Fixes: #802

…gle module index.json files

jormundur00 · 2026-02-04T10:04:29Z

With the usage of the 0.3.34-prerelease version of reachability metadata (which includes the yet to be merged metadata/index.json removal PR), all the CI tests pass on both the reachability metadata and buildtools side.

The plan is to, once both PRs are approved for merging:

Merge the reachability metadata PR first,
Release the 0.3.34 version of reachability metadata,
Bump the reachability metadata version in this PR from 0.3.34-prerelease to 0.3.34,
Merge this PR.

@vjovanov @melix please take a look at both this PR and the Reachability Metadata PR when you have the time, as the 1.0-M1 release is scheduled for the 12th of February, and this is a major PR that blocks other issues also required for this release.

…ns (#829)

…1.4 to 0.11.5 [skip ci] Bumps [org.graalvm.buildtools:native-maven-plugin](https://github.com/graalvm/native-build-tools) from 0.11.4 to 0.11.5. Release notes *Sourced from [org.graalvm.buildtools:native-maven-plugin's releases](https://github.com/graalvm/native-build-tools/releases).* > 0.11.5 > ------ > > What's Changed > -------------- > > * Bump version to 0.11.5-SNAPSHOT by [`@graalvmbot`](https://github.com/graalvmbot) in [graalvm/native-build-tools#817](https://redirect.github.com/graalvm/native-build-tools/pull/817) > * Make environment variables set in the pom.xml of the native-maven-plugin be visible in the image builder by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#819](https://redirect.github.com/graalvm/native-build-tools/pull/819) > * Add check if correct schemas are present in the reachability metadata repository provided to buildtools by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#821](https://redirect.github.com/graalvm/native-build-tools/pull/821) > * Add fallback for jarless artifacts in the native-maven-plugin by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#824](https://redirect.github.com/graalvm/native-build-tools/pull/824) > * Fix JUnit 6 not working correctly with JDK 21 by expanding the initialize-at-build-time-list by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#832](https://redirect.github.com/graalvm/native-build-tools/pull/832) > * Remove the usage of the global metadata/index.json from the nbt plugins by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#829](https://redirect.github.com/graalvm/native-build-tools/pull/829) > * Revert "Remove the usage of the global metadata/index.json from the nbt plugins" by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#836](https://redirect.github.com/graalvm/native-build-tools/pull/836) > * Use JDK 21 Graal in the CI by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#839](https://redirect.github.com/graalvm/native-build-tools/pull/839) > * Support `-H:+CompatibilityMode` in build tools by [`@vjovanov`](https://github.com/vjovanov) in [graalvm/native-build-tools#822](https://redirect.github.com/graalvm/native-build-tools/pull/822) > * Update reachability metadata to 0.3.34 by [`@graalvmbot`](https://github.com/graalvmbot) in [graalvm/native-build-tools#842](https://redirect.github.com/graalvm/native-build-tools/pull/842) > > **Full Changelog**: <graalvm/native-build-tools@0.11.4...0.11.5> Commits * [`ffd094d`](graalvm/native-build-tools@ffd094d) Release 0.11.5 * [`1d7c2f7`](graalvm/native-build-tools@1d7c2f7) Merge pull request [#842](https://redirect.github.com/graalvm/native-build-tools/issues/842) from graalvm/update-metadata-to-0.3.34 * [`ba1c2e8`](graalvm/native-build-tools@ba1c2e8) Update reachability metadata to 0.3.34 * [`790fa05`](graalvm/native-build-tools@790fa05) Merge pull request [#822](https://redirect.github.com/graalvm/native-build-tools/issues/822) from graalvm/vj/compatibility-mode * [`0631241`](graalvm/native-build-tools@0631241) Implement Compatibility Mode detection * [`1844654`](graalvm/native-build-tools@1844654) Use JDK 21 Graal in the CI ([#839](https://redirect.github.com/graalvm/native-build-tools/issues/839)) * [`6315677`](graalvm/native-build-tools@6315677) Revert "Remove the usage of the global metadata/index.json from the nbt plugi... * [`fe065ce`](graalvm/native-build-tools@fe065ce) Remove the usage of the global metadata/index.json from the nbt plugins ([#829](https://redirect.github.com/graalvm/native-build-tools/issues/829)) * [`94b5b54`](graalvm/native-build-tools@94b5b54) Fix JUnit 6 not working correctly with JDK 21 by expanding the initialize-at-... * [`086cfdf`](graalvm/native-build-tools@086cfdf) Add fallback for jarless artifacts in the native-maven-plugin ([#824](https://redirect.github.com/graalvm/native-build-tools/issues/824)) * Additional commits viewable in [compare view](graalvm/native-build-tools@0.11.4...0.11.5) [![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility\_score?dependency-name=org.graalvm.buildtools:native-maven-plugin&package-manager=maven&previous-version=0.11.4&new-version=0.11.5)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- Dependabot commands and options You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot show ignore conditions` will show all of the ignore conditions of the specified dependency - `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

…1.5 to 1.1.0 [skip ci] Bumps [org.graalvm.buildtools:native-maven-plugin](https://github.com/graalvm/native-build-tools) from 0.11.5 to 1.1.0. Release notes *Sourced from [org.graalvm.buildtools:native-maven-plugin's releases](https://github.com/graalvm/native-build-tools/releases).* > 1.1.0 > ----- > > What's Changed > -------------- > > * Release 1.0.0 by [`@graalvmbot`](https://github.com/graalvmbot) in [graalvm/native-build-tools#857](https://redirect.github.com/graalvm/native-build-tools/pull/857) > * Bump version to 1.0.1-SNAPSHOT by [`@graalvmbot`](https://github.com/graalvmbot) in [graalvm/native-build-tools#858](https://redirect.github.com/graalvm/native-build-tools/pull/858) > * Use a safer way to create the temporary access filter file by [`@sschuberth`](https://github.com/sschuberth) in [graalvm/native-build-tools#852](https://redirect.github.com/graalvm/native-build-tools/pull/852) > * Bump io.netty:netty-codec-http from 4.1.129.Final to 4.1.132.Final in /samples/metadata-repo-integration by [`@dependabot`](https://github.com/dependabot)[bot] in [graalvm/native-build-tools#859](https://redirect.github.com/graalvm/native-build-tools/pull/859) > * Add class introduced in 5.14.1/6.0.1 by [`@marcphilipp`](https://github.com/marcphilipp) in [graalvm/native-build-tools#794](https://redirect.github.com/graalvm/native-build-tools/pull/794) > * Reduce CI usage by running CI only on "pull\_request" and running only the latest gradle version (except when creating a new release) by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#861](https://redirect.github.com/graalvm/native-build-tools/pull/861) > * Update latest docs symlink and improve 1.0.0 release notes by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#866](https://redirect.github.com/graalvm/native-build-tools/pull/866) > * Fix early classpath resolution in GenerateDynamicAccessMetadata by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#868](https://redirect.github.com/graalvm/native-build-tools/pull/868) > * Bump reachability metadata version to 1.0.0 by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#879](https://redirect.github.com/graalvm/native-build-tools/pull/879) > * Add listLibrariesMissingMetadata task/goal for Gradle and Maven by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#877](https://redirect.github.com/graalvm/native-build-tools/pull/877) > > **Full Changelog**: <graalvm/native-build-tools@1.0.0...1.1.0> > > 1.0.0 > ----- > > Breaking Changes > ---------------- > > * Native Build Tools 1.0.0 moves to the `1.0-M1` release of the reachability metadata repository, which uses the new `reachability-metadata.json` metadata format and no longer uses the global `metadata/index.json`. > * This may require dependency and metadata updates in downstream projects; some stacks can regress until they adapt. > > What's Changed > -------------- > > * Fix broken JavaApplicationFunctionalTest due to using a removed feature by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#850](https://redirect.github.com/graalvm/native-build-tools/pull/850) > * Remove the usage of the global metadata/index.json from the nbt plugins by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#829](https://redirect.github.com/graalvm/native-build-tools/pull/829) > * Add reachability-metadata-schema cross-validation by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#840](https://redirect.github.com/graalvm/native-build-tools/pull/840) > * Merge 1.0-M1 branch to master by [`@jormundur00`](https://github.com/jormundur00) in [graalvm/native-build-tools#848](https://redirect.github.com/graalvm/native-build-tools/pull/848) > > **Full Changelog**: <graalvm/native-build-tools@0.11.5...1.0.0> Commits * [`84cc046`](graalvm/native-build-tools@84cc046) Release 1.1.0 * [`95512d0`](graalvm/native-build-tools@95512d0) Add listLibrariesMissingMetadata task/goal for Gradle and Maven ([#877](https://redirect.github.com/graalvm/native-build-tools/issues/877)) * [`0dcda78`](graalvm/native-build-tools@0dcda78) Merge pull request [#879](https://redirect.github.com/graalvm/native-build-tools/issues/879) from jormundur00/bump-metadata-repository-1.0.0 * [`e5b90f0`](graalvm/native-build-tools@e5b90f0) Bump reachability metadata version to 1.0.0 * [`05f45d3`](graalvm/native-build-tools@05f45d3) Fix early classpath resolution in GenerateDynamicAccessMetadata ([#868](https://redirect.github.com/graalvm/native-build-tools/issues/868)) * [`4d614c7`](graalvm/native-build-tools@4d614c7) Update latest docs symlink and improve 1.0.0 release notes ([#866](https://redirect.github.com/graalvm/native-build-tools/issues/866)) * [`ee1351d`](graalvm/native-build-tools@ee1351d) Reduce CI usage by running CI only on "pull\_request" and running only the lat... * [`c6f3674`](graalvm/native-build-tools@c6f3674) Add class introduced in 5.14.1/6.0.1 ([#794](https://redirect.github.com/graalvm/native-build-tools/issues/794)) * [`5bc69bd`](graalvm/native-build-tools@5bc69bd) Bump io.netty:netty-codec-http from 4.1.129.Final to 4.1.132.Final in /sample... * [`395f3b2`](graalvm/native-build-tools@395f3b2) Use a safer way to create the temporary access filter file ([#852](https://redirect.github.com/graalvm/native-build-tools/issues/852)) * Additional commits viewable in [compare view](graalvm/native-build-tools@0.11.5...1.1.0) [![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility\_score?dependency-name=org.graalvm.buildtools:native-maven-plugin&package-manager=maven&previous-version=0.11.5&new-version=1.1.0)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores) Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting `@dependabot rebase`. [//]: # (dependabot-automerge-start) [//]: # (dependabot-automerge-end) --- Dependabot commands and options You can trigger Dependabot actions by commenting on this PR: - `@dependabot rebase` will rebase this PR - `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it - `@dependabot show ignore conditions` will show all of the ignore conditions of the specified dependency - `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself) - `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

jormundur00 added 4 commits January 29, 2026 14:06

Migrate all functionality from parsing metadata/index.json to the sin…

1bfe9bf

…gle module index.json files

Validate new schema version and remove unused schema

3d94199

Remove unused schema from samples and bump schema version

5dcdb71

Fixup docs

9297d16

jormundur00 requested review from melix and vjovanov February 2, 2026 13:29

jormundur00 self-assigned this Feb 2, 2026

jormundur00 added the enhancement New feature or request label Feb 2, 2026

oracle-contributor-agreement Bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label Feb 2, 2026

jormundur00 mentioned this pull request Feb 2, 2026

Remove the usage of the global metadata/index.json from the nbt plugins #826

Closed

jormundur00 marked this pull request as draft February 2, 2026 15:03

jormundur00 force-pushed the jormundur00/global-index-removal branch 4 times, most recently from cfca9a4 to 290ef72 Compare February 4, 2026 08:39

jormundur00 marked this pull request as ready for review February 4, 2026 09:54

vjovanov previously approved these changes Feb 10, 2026

View reviewed changes

jormundur00 dismissed vjovanov’s stale review via 1fcafbc February 11, 2026 07:12

jormundur00 force-pushed the jormundur00/global-index-removal branch 3 times, most recently from 776f79e to 3b416ad Compare February 11, 2026 07:26

Test CI with reachability metadata pre-release

888dc2a

jormundur00 force-pushed the jormundur00/global-index-removal branch from 3b416ad to 888dc2a Compare February 11, 2026 07:27

vjovanov previously approved these changes Feb 11, 2026

View reviewed changes

Lower logback-classic used in sample to avoid using broken metadata

12c9cae

jormundur00 dismissed vjovanov’s stale review via 12c9cae February 11, 2026 10:37

vjovanov approved these changes Feb 11, 2026

View reviewed changes

jormundur00 merged commit fe065ce into master Feb 11, 2026
610 of 611 checks passed

jormundur00 deleted the jormundur00/global-index-removal branch February 11, 2026 11:49

jormundur00 mentioned this pull request Feb 18, 2026

Revert "Remove the usage of the global metadata/index.json from the nbt plugins" #836

Merged

jormundur00 added a commit that referenced this pull request Feb 19, 2026

Remove the usage of the global metadata/index.json from the nbt plugi…

ce290c0

…ns (#829)

jormundur00 mentioned this pull request Feb 19, 2026

Remove the usage of the global metadata/index.json from the nbt plugins #837

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Remove the usage of the global metadata/index.json from the nbt plugins#829

Remove the usage of the global metadata/index.json from the nbt plugins#829
jormundur00 merged 6 commits into
masterfrom
jormundur00/global-index-removal

jormundur00 commented Feb 2, 2026

Uh oh!

jormundur00 commented Feb 4, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

jormundur00 commented Feb 2, 2026

Uh oh!

jormundur00 commented Feb 4, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants