This is an automated email from the ASF dual-hosted git repository.
dongjoon-hyun pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/spark-kubernetes-operator.git
The following commit(s) were added to refs/heads/main by this push:
new 5472185 [SPARK-58144] Add `verification-metadata.xml` regeneration
guide to `AGENTS.md` and fix `README.md`
5472185 is described below
commit 54721859dfdde28432c62cfb9836b65fd5e4b55c
Author: Dongjoon Hyun <[email protected]>
AuthorDate: Wed Jul 15 09:18:01 2026 -0700
[SPARK-58144] Add `verification-metadata.xml` regeneration guide to
`AGENTS.md` and fix `README.md`
### What changes were proposed in this pull request?
This PR aims to
- Add a `gradle/verification-metadata.xml` regeneration guide to
**`AGENTS.md`** and
- Fix the existing guide in **`README.md`** accordingly.
Previously, since `--write-verification-metadata` is append-only, the
guides now instruct to delete the existing file first and restore the ASF
license header after regeneration.
`gradle/verification-metadata.xml` is also regenerated by following the new
guide,
removing 237 lines of stale entries.
### Why are the changes needed?
The previous guide kept stale checksums of removed or upgraded dependencies
forever.
### Does this PR introduce _any_ user-facing change?
No.
### How was this patch tested?
Manually verified that `./gradlew build` passes with the regenerated
metadata.
### Was this patch authored or co-authored using generative AI tooling?
Generated-by: Claude Fable 5
Closes #757 from dongjoon-hyun/SPARK-58144.
Authored-by: Dongjoon Hyun <[email protected]>
Signed-off-by: Dongjoon Hyun <[email protected]>
---
AGENTS.md | 14 +++++++++
README.md | 11 +++++--
gradle/verification-metadata.xml | 64 ----------------------------------------
3 files changed, 23 insertions(+), 66 deletions(-)
diff --git a/AGENTS.md b/AGENTS.md
index fb26991..d264682 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -83,6 +83,20 @@ toolchain provisions JDK 26, so a JDK 21+ is required.
./gradlew dependencyUpdates # Report newer dependency versions
```
+When upgrading dependencies, regenerate `gradle/verification-metadata.xml`
from scratch.
+Since `--write-verification-metadata` is append-only and keeps stale entries
of removed or
+old dependencies, delete the existing file first so that the regenerated file
contains
+only the checksums of the current dependencies, then restore the ASF license
header
+(Gradle rewrites the file without it). Pass `--refresh-dependencies` so that
metadata
+files (BOM / parent POMs) already present in the local Gradle cache are
downloaded and
+recorded again — without it their checksums are silently dropped and CI fails
with a
+cold cache:
+
+```bash
+rm gradle/verification-metadata.xml
+./gradlew --write-verification-metadata sha512 build --refresh-dependencies
+```
+
Helm chart (the lint mirrors CI):
```bash
diff --git a/README.md b/README.md
index f9852a4..472ed86 100644
--- a/README.md
+++ b/README.md
@@ -41,10 +41,17 @@ To build, run:
## Updating Dependency Verification Metadata
-When upgrading dependencies, regenerate `gradle/verification-metadata.xml`:
+When upgrading dependencies, regenerate `gradle/verification-metadata.xml`
from scratch.
+Since `--write-verification-metadata` is append-only and keeps stale entries
of removed or
+old dependencies, delete the existing file first so that the regenerated file
contains
+only the checksums of the current dependencies. Pass `--refresh-dependencies`
so that
+metadata files (BOM / parent POMs) already present in the local Gradle cache
are
+downloaded and recorded again — without it their checksums are silently
dropped and
+CI fails with a cold cache:
```bash
-./gradlew --write-verification-metadata sha512 build
+rm gradle/verification-metadata.xml
+./gradlew --write-verification-metadata sha512 build --refresh-dependencies
```
Note that Gradle rewrites the file without the ASF license header,
diff --git a/gradle/verification-metadata.xml b/gradle/verification-metadata.xml
index 9c82b39..d849e5b 100644
--- a/gradle/verification-metadata.xml
+++ b/gradle/verification-metadata.xml
@@ -3132,24 +3132,6 @@
<sha512
value="59586a910501990c91617feed7699cfe872a481d81190109bb17acbcaa7d6abe07f60e0650e7911b742568d8ece40175eb825aca9f0ff4116dbf45991aafd327"
origin="Generated by Gradle"/>
</artifact>
</component>
- <component group="org.fusesource" name="fusesource-pom" version="1.9">
- <artifact name="fusesource-pom-1.9.pom">
- <sha512
value="48eb0b8b9b8037fde1321b07d6e35f3d63abc2df08289eb7d3f979a9d9c52241578d7aa15b0d2422a2b941639fa0107431974b97f0661b7b34d2258be2fd1744"
origin="Generated by Gradle"/>
- </artifact>
- </component>
- <component group="org.fusesource.leveldbjni" name="leveldbjni-all"
version="1.8">
- <artifact name="leveldbjni-all-1.8.jar">
- <sha512
value="2e9f806af5d89c00e345b4516ffd325893a07f30c87274fa5b8ce314aad021633750b665d8c338fbf5adc79a527e19caf96d0b12af57e56fb8d3d8f7fd845a96"
origin="Generated by Gradle"/>
- </artifact>
- <artifact name="leveldbjni-all-1.8.pom">
- <sha512
value="33fa6901f370ca0da6e37cd97fdf30221ed9fff53d15b1de7f26f01332ecd31e81cdd34f242c00fca964dc8786d23cf8993d06c99f152e2af4d0e2bccc6d792f"
origin="Generated by Gradle"/>
- </artifact>
- </component>
- <component group="org.fusesource.leveldbjni" name="leveldbjni-project"
version="1.8">
- <artifact name="leveldbjni-project-1.8.pom">
- <sha512
value="5c7876c4d5f3024a4016c6ec699fce8b0bbc2ce3bdd97a0fc5b368d1f8f072f0b45e10ae06d39545712f7f32b2019b51f74a0772c83bf5ed82e140dc4625feb0"
origin="Generated by Gradle"/>
- </artifact>
- </component>
<component group="org.glassfish.hk2" name="external" version="3.0.6">
<artifact name="external-3.0.6.pom">
<sha512
value="7ece659484a684e908b84bc6e0c31b5704a7363fbda8e946077b95fe2381e5b3fc52ee362d0a73dcca49d36f644c977d0502bdd1a5afa9bc48a4c6327f38d6be"
origin="Generated by Gradle"/>
@@ -3539,14 +3521,6 @@
<sha512
value="7c7c75f45ed08a7a6c9d4573d4e50657b2377e6127fbed89334cf83e522f8ef3a162f132ae192a840119b0ac3a2cac7608c5d6ea9d7506c6c5033c52148d3cc0"
origin="Generated by Gradle"/>
</artifact>
</component>
- <component group="org.junit.jupiter" name="junit-jupiter"
version="6.1.1">
- <artifact name="junit-jupiter-6.1.1.jar">
- <sha512
value="ff269c26bf11376b31e838d525f5265ed0382578f6b108534b24f96e477e12550149e7903840743d92b9fe5add9e834884562e58a2f29421377ec8a11a2046ba"
origin="Generated by Gradle"/>
- </artifact>
- <artifact name="junit-jupiter-6.1.1.module">
- <sha512
value="c44be73dac9b4a76ce8f5d383ead9ba86bc57c2e83038766d2ef99f0fc188410c1e4fd6e3495b059bd6091fe5d1790c0fb14a424def9c6d206bb80566e7ff808"
origin="Generated by Gradle"/>
- </artifact>
- </component>
<component group="org.junit.jupiter" name="junit-jupiter"
version="6.1.2">
<artifact name="junit-jupiter-6.1.2.jar">
<sha512
value="41224ff5ea674be2193c509b981586904e21f296a3d946e4f40cee8e129db31ba261e37b47dcc8dca5373fff33dc8291120e5691da3f1cd376043d2089683c9f"
origin="Generated by Gradle"/>
@@ -3556,9 +3530,6 @@
</artifact>
</component>
<component group="org.junit.jupiter" name="junit-jupiter-api"
version="6.1.1">
- <artifact name="junit-jupiter-api-6.1.1.jar">
- <sha512
value="9ca3e182b4b41cb8556df31699d04a8d4ab835c5fed1f2e5215888b033977ed6c513108b36c85b97119604deb83f161bfc360d79f3fb57edd9136e0546ee5bb4"
origin="Generated by Gradle"/>
- </artifact>
<artifact name="junit-jupiter-api-6.1.1.module">
<sha512
value="dc9cc4a5e772ee111651c2010c32ec1fb9f9730155753686ee392b892bf662fc5675f23b16860e8a465493d70993f0e83b5207835be98a65cc8768a7e8c49af2"
origin="Generated by Gradle"/>
</artifact>
@@ -3572,9 +3543,6 @@
</artifact>
</component>
<component group="org.junit.jupiter" name="junit-jupiter-engine"
version="6.1.1">
- <artifact name="junit-jupiter-engine-6.1.1.jar">
- <sha512
value="4b5f8035e9c59650cffb879d57aee6757e81a08fcd50290f3ee0a15fa7ffa0eec19dfc0f7bd4f2a3bac471ca7955474bb25851a41afa2fbe42b9da03b4eebaab"
origin="Generated by Gradle"/>
- </artifact>
<artifact name="junit-jupiter-engine-6.1.1.module">
<sha512
value="8eed1763aa73af0a45c096d6fa288494e3c2a3ac45a65fbf281fe55638e24ff31ed3bd47ae1c700162d2da68885c8febda0977cd744fff6e32c4d0d6abad358a"
origin="Generated by Gradle"/>
</artifact>
@@ -3587,14 +3555,6 @@
<sha512
value="c58ed3bd54509853ad7a07331447d7bf74bbd292f3e5d31db591fb1b79e09d6fa249f863838b294b071b7fad8d6f606a21f822c3d5d06120edf1010ed38d5ecf"
origin="Generated by Gradle"/>
</artifact>
</component>
- <component group="org.junit.jupiter" name="junit-jupiter-params"
version="6.1.1">
- <artifact name="junit-jupiter-params-6.1.1.jar">
- <sha512
value="90aff39ac2743a3b681d84becd01dc37a7c3fb5043ae693386535a7993a88ecc843d0fbd2efdf8bc7e96236966d84e41aaf02a3f085870377fd1963bf3114914"
origin="Generated by Gradle"/>
- </artifact>
- <artifact name="junit-jupiter-params-6.1.1.module">
- <sha512
value="485b145e4eb1d2fc38ab04a9123ebe58c1cd5f86ec3c0878b25a56b888cbf4406a2448c02fbe59b2e668c80cf1f29bb88b00b89d4a742346a9e44cec53a6dd86"
origin="Generated by Gradle"/>
- </artifact>
- </component>
<component group="org.junit.jupiter" name="junit-jupiter-params"
version="6.1.2">
<artifact name="junit-jupiter-params-6.1.2.jar">
<sha512
value="c7e54a13e482280506b58dd5c64b0e690ed3c3fad49a415f640f470f87698a1cfd870a1845837cb3ca03c3d860cc4074f4d29437d2b50a5f0a6e0db04761123b"
origin="Generated by Gradle"/>
@@ -3603,14 +3563,6 @@
<sha512
value="9aa2260dc556cc1865f3907769d2dc1aa69a28f26d2e84f348f1c1c3ba530d605d14979aba809f7ece842706b03cc06ff0197d76c158e30ce1540fcb3831909c"
origin="Generated by Gradle"/>
</artifact>
</component>
- <component group="org.junit.platform" name="junit-platform-commons"
version="6.1.1">
- <artifact name="junit-platform-commons-6.1.1.jar">
- <sha512
value="732d4a8ad7e609b2df4304051a69f0bf6cfa52c52f2f81c13433c8f69be9a86ed377470de5fe32994705962d2235a510ee4eddf231d6d0a363b6beca24d04b31"
origin="Generated by Gradle"/>
- </artifact>
- <artifact name="junit-platform-commons-6.1.1.module">
- <sha512
value="b44b5897ceb0efe2c76905fd70ba00e9130b46724403387eb2b0c3373b6e20b1b39ab8ecc260ff73cce3780dfad24b07b354c6b01cee6add2d564d2919847195"
origin="Generated by Gradle"/>
- </artifact>
- </component>
<component group="org.junit.platform" name="junit-platform-commons"
version="6.1.2">
<artifact name="junit-platform-commons-6.1.2.jar">
<sha512
value="52294bae22a470223e4c5a81051e76029e59935d6e0afbf3f3c5993e288ae3f1d3f0e5f6bc47bb7eed6963fd66405206c2e33a1b699502bfdd8c69d83937e477"
origin="Generated by Gradle"/>
@@ -3619,14 +3571,6 @@
<sha512
value="e769d6db2c0eba9b6ada02c6da7f0ce7eb99ba0fe0319d9a27124b9de4edf29a1a185dc18d717f859baf209827e82ead0d31436e3325e0f58298cde84ea252ca"
origin="Generated by Gradle"/>
</artifact>
</component>
- <component group="org.junit.platform" name="junit-platform-engine"
version="6.1.1">
- <artifact name="junit-platform-engine-6.1.1.jar">
- <sha512
value="6a91bf570721f18f26d197cec888b732e1010076cbaf46c9655f293d77fe3490a2701f2903944db62a4fec5790fe7b2262ce6f62881a85cea5e6f78376d3b0b7"
origin="Generated by Gradle"/>
- </artifact>
- <artifact name="junit-platform-engine-6.1.1.module">
- <sha512
value="5d805e7e783147341d75098899e87e1b004bf1c2d071e5a0dba1263406c8429436fe3236b194fe4500a7db3965c3eae103b1d2e9901a841b77e8590ffdfde21f"
origin="Generated by Gradle"/>
- </artifact>
- </component>
<component group="org.junit.platform" name="junit-platform-engine"
version="6.1.2">
<artifact name="junit-platform-engine-6.1.2.jar">
<sha512
value="da732fbc304cfdb79909ba42bafaf8deb211f419ab575ffb4269868a436e00014d992db4a14ae900216e39bea6b5f0cc7cf9d0c35540245ffd15d86e05792f41"
origin="Generated by Gradle"/>
@@ -3635,14 +3579,6 @@
<sha512
value="40692bc6cde83d6936f1accbee407daafca7c172aa750944791014bafe5469d350f8b84742eb8a7e21757a554c4c4846f4495db0969d571b8222d5d13a78a389"
origin="Generated by Gradle"/>
</artifact>
</component>
- <component group="org.junit.platform" name="junit-platform-launcher"
version="6.1.1">
- <artifact name="junit-platform-launcher-6.1.1.jar">
- <sha512
value="4e9d2a87bbc7f6562724eb14cd6b4b2eb1a1c58eca5fc9e2f2f15bb61542809dd96cd06f96102ac10c17e96f4b029b462be81626b75fbe1a07a671b86c672df9"
origin="Generated by Gradle"/>
- </artifact>
- <artifact name="junit-platform-launcher-6.1.1.module">
- <sha512
value="c626d351a5dc36a395990929c5403a418a1ffe88e6fe5e9e753d035c7fb6299ef9c209c394901bb1f16b8c99aa3e7bc4afa0606bfdd502d93396f6028d665b58"
origin="Generated by Gradle"/>
- </artifact>
- </component>
<component group="org.junit.platform" name="junit-platform-launcher"
version="6.1.2">
<artifact name="junit-platform-launcher-6.1.2.jar">
<sha512
value="ef8935c23f2a8c485fa1cc6b35fff92b0fa7c41fde9e1c30065ef308a4cda2d1e74f91d63b4c5827c342369d5e3a5f0750d1f8d8d5a2d5c70bf0118747a86fb0"
origin="Generated by Gradle"/>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
