From a7f6233ddb331df2392e6deae8027059dcff22ba Mon Sep 17 00:00:00 2001 From: Eric Pugh Date: Fri, 19 Jun 2026 12:30:29 -0400 Subject: [PATCH 1/4] first pass of the steps, rough --- dev-docs/release-process.md | 43 +++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 dev-docs/release-process.md diff --git a/dev-docs/release-process.md b/dev-docs/release-process.md new file mode 100644 index 00000000..02da9545 --- /dev/null +++ b/dev-docs/release-process.md @@ -0,0 +1,43 @@ +To release Solr MCP, these are the steps: + +1) Create a release branch like branch_1_0_0. Or update the release branch with latest changes. + +1) Switch to that branch. + +1) Merge https://github.com/apache/solr-mcp/pull/136/changes into the branch. + +1) Set up a release in Apache Trusted Release server at: blah. + +1) create the artifacts via `./gradlew clean build` + +1) Sign them via: +``` +for fn in *.jar +do + ../../gpgsign.sh sign ~/.ssh/.private.asc "$fn" +done +``` + +1) Make sha keys via: +``` +for fn in *.jar +do + sha512 $fn > $fn.sha512 +done +``` + +1) Uplaod all the artifacts to the previously created release in ATR. + +1) Test in Claude Code and Claude Desktop the following steps. + +1) IN the vote thread we want to make it easy for folks to test. Add the following steps: + +``` + + +``` + +1) After the vote, create a tag with the source code in github, as `releases/ +solr-mcp/1.0.0` + +1) After the vote bump the version tag in `main` for 1.1 so we get -snapshot builds there. From ab8cf76027def7f2b7eacea16dad012daf041f40 Mon Sep 17 00:00:00 2001 From: Eric Pugh Date: Sun, 21 Jun 2026 15:36:57 -0400 Subject: [PATCH 2/4] add the smoke tests --- dev-docs/release-process.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/dev-docs/release-process.md b/dev-docs/release-process.md index 02da9545..d5924ce5 100644 --- a/dev-docs/release-process.md +++ b/dev-docs/release-process.md @@ -1,12 +1,12 @@ To release Solr MCP, these are the steps: -1) Create a release branch like branch_1_0_0. Or update the release branch with latest changes. +1) Create a release branch like branch_1_0_0. Or update the existing release branch with latest changes. 1) Switch to that branch. -1) Merge https://github.com/apache/solr-mcp/pull/136/changes into the branch. +1) Deal with `-SNAPSHOT` build artifacts. For 1.0 we will merge https://github.com/apache/solr-mcp/pull/136/changes into the branch. -1) Set up a release in Apache Trusted Release server at: blah. +1) Set up a release in Apache Trusted Release server at https://release-test.apache.org/#project-solr-mcp. 1) create the artifacts via `./gradlew clean build` @@ -32,8 +32,16 @@ done 1) IN the vote thread we want to make it easy for folks to test. Add the following steps: -``` +_This demonstrates how to use the MCP server against a shared public Solr. Please be kind._ +``` +mkdir ./test-solr-mcp +cd ./test-solr-mcp +wget https://release-test.apache.org/download/path/solr-mcp/1.0.0/solr-mcp-1.0.0.jar +claude mcp add solr-mcp --transport stdio \ + --env SOLR_URL=http://quepid-solr.dev.o19s.com:8987/solr \ + -- java -jar $PWD/solr-mcp-1.0.0.jar +claude mcp list # confirm it connects (/mcp inside a session) ``` From f91f70e60e504c3614e37b9a0cc8340fea71b4a6 Mon Sep 17 00:00:00 2001 From: Eric Pugh Date: Thu, 23 Jul 2026 14:45:47 -0300 Subject: [PATCH 3/4] bit of text clean up. --- dev-docs/release-process.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/dev-docs/release-process.md b/dev-docs/release-process.md index d5924ce5..0648ae1b 100644 --- a/dev-docs/release-process.md +++ b/dev-docs/release-process.md @@ -18,7 +18,7 @@ do done ``` -1) Make sha keys via: +1) Make sha keys via (macOS; use `sha512sum` instead of `sha512` on Linux): ``` for fn in *.jar do @@ -26,11 +26,9 @@ do done ``` -1) Uplaod all the artifacts to the previously created release in ATR. +1) Upload all the artifacts to the previously created release in ATR. -1) Test in Claude Code and Claude Desktop the following steps. - -1) IN the vote thread we want to make it easy for folks to test. Add the following steps: +1) Test in Claude Code and Claude Desktop using the steps below, then post the same steps to the vote thread so others can test the release candidate too. _This demonstrates how to use the MCP server against a shared public Solr. Please be kind._ @@ -45,7 +43,6 @@ claude mcp list # confirm it connects (/mcp inside a session) ``` -1) After the vote, create a tag with the source code in github, as `releases/ -solr-mcp/1.0.0` +1) After the vote, create a tag with the source code in github, as `releases/solr-mcp/1.0.0` 1) After the vote bump the version tag in `main` for 1.1 so we get -snapshot builds there. From 171c1435d49edfea5c7c2296dc48109905a8d7a8 Mon Sep 17 00:00:00 2001 From: Eric Pugh Date: Thu, 23 Jul 2026 14:50:50 -0300 Subject: [PATCH 4/4] Finalize some tweaks. --- dev-docs/release-process.md | 21 +++++++-------------- 1 file changed, 7 insertions(+), 14 deletions(-) diff --git a/dev-docs/release-process.md b/dev-docs/release-process.md index 0648ae1b..9be16f18 100644 --- a/dev-docs/release-process.md +++ b/dev-docs/release-process.md @@ -10,6 +10,12 @@ To release Solr MCP, these are the steps: 1) create the artifacts via `./gradlew clean build` +1) `./gradlew build` already ran the Apache RAT license-header check (`org.apache.solr.mcp.rat`) and regenerated the binary `LICENSE`/`NOTICE` as part of `check` — confirm the build was green, then spot-check the generated files bundled in the bootJar: +``` +unzip -p build/libs/solr-mcp-X.Y.Z.jar META-INF/LICENSE +unzip -p build/libs/solr-mcp-X.Y.Z.jar META-INF/NOTICE +``` + 1) Sign them via: ``` for fn in *.jar @@ -28,20 +34,7 @@ done 1) Upload all the artifacts to the previously created release in ATR. -1) Test in Claude Code and Claude Desktop using the steps below, then post the same steps to the vote thread so others can test the release candidate too. - -_This demonstrates how to use the MCP server against a shared public Solr. Please be kind._ - -``` -mkdir ./test-solr-mcp -cd ./test-solr-mcp -wget https://release-test.apache.org/download/path/solr-mcp/1.0.0/solr-mcp-1.0.0.jar -claude mcp add solr-mcp --transport stdio \ - --env SOLR_URL=http://quepid-solr.dev.o19s.com:8987/solr \ - -- java -jar $PWD/solr-mcp-1.0.0.jar -claude mcp list # confirm it connects (/mcp inside a session) - -``` +1) Test in Claude Code or Claude Desktop using the steps in ./dev-docs/SMOKE_TEST.md. 1) After the vote, create a tag with the source code in github, as `releases/solr-mcp/1.0.0`