feat: Add Docker support with Jib and GitHub Actions CI/CD #6

adityamparikh · 2025-10-27T00:19:43Z

Summary

This PR adds comprehensive Docker support to the Solr MCP Server project using Google's Jib for containerization and GitHub Actions for automated CI/CD.

Key Features

Jib Integration:

Multi-platform Docker images (linux/amd64, linux/arm64)
No Docker daemon required for builds
Optimized layered images for faster deployments
Support for local builds, Docker Hub, and GitHub Container Registry

GitHub Actions Workflow:

Automated JAR builds and testing on every push/PR
Automated Docker image publishing to GHCR and Docker Hub
Smart tagging strategy:
- Main branch: version-SHA + latest
- Version tags: semantic version + latest
Test results and coverage reports as artifacts

Documentation:

Comprehensive README updates with Docker setup guide
Integration instructions for Claude Desktop using Docker
FAQ explaining why Jib was chosen over Spring Boot Buildpacks
Publishing instructions for both Docker Hub and GHCR

Why Jib over Buildpacks?

Jib was chosen because Docker images built with Spring Boot Buildpacks output logs to stdout, which interferes with the MCP protocol's STDIO transport. The MCP protocol requires a clean stdout channel - any extraneous output causes connection errors with MCP clients like Claude Desktop.

Changes

Add Jib Gradle plugin (v3.4.5) to gradle/libs.versions.toml
Add Jib configuration to build.gradle.kts with multi-platform support
Add GitHub Actions workflow (.github/workflows/build-and-publish.yml)
Update README with Docker documentation

adityamparikh · 2025-10-27T00:22:41Z

Next step - publish to github mcp registry https://github.blog/ai-and-ml/generative-ai/how-to-find-install-and-manage-mcp-servers-with-the-github-mcp-registry/

adityamparikh · 2025-10-28T20:59:53Z

FYI @epugh @chatman

epugh · 2025-10-28T22:21:28Z

just clicked approval on the workflows..

epugh · 2025-10-28T23:08:35Z

Looks like we need to resolve some conflicts first... Thoughts on how to test this, just maybe go through the docker steps?

# Conflicts: # build.gradle.kts # gradle/libs.versions.toml

epugh · 2025-10-29T14:09:09Z

@adityamparikh do we need to deal with the sonarqube failure in this PR? I think we moved to a differetn tool...

epugh · 2025-10-29T14:35:17Z

This requires Java 25! Exciting! Do we think there will be issues with adoption if we require Java 25 if this is running "on my local laptop"?

epugh · 2025-10-29T14:57:58Z

I wonder... should the artifact be called solr-mcp instead of solr-mcp-server since the repo is solr-mcp... Keep the pattern the same! And maybe soemday we include solr-mcp artifact into Solr itself....

epugh · 2025-10-29T15:01:18Z

I am getting this error on running ./gradlew jibDockerBuild.... I am on an older mac with Intel chip:

➜  solr-mcp git:(pr/6) ✗ ./gradlew jibDockerBuild
> Task :jibDockerBuild FAILED

[Incubating] Problems report is available at: file:///Users/epugh/Documents/projects/solr-mcp/build/reports/problems/problems-report.html

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':jibDockerBuild'.
> Check the full stace trace, and if the root cause is from ASM ClassReader about unsupported class file version, see https://github.com/GoogleContainerTools/jib/blob/master/docs/faq.md#i-am-seeing-unsupported-class-file-major-version-when-building

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to generate a Build Scan (Powered by Develocity).
> Get more help at https://help.gradle.org.

Deprecated Gradle features were used in this build, making it incompatible with Gradle 10.

You can use '--warning-mode all' to show the individual deprecation warnings and determine if they come from your own scripts or plugins.

For more on this, please refer to https://docs.gradle.org/9.1.0/userguide/command_line_interface.html#sec:command_line_warnings in the Gradle documentation.

BUILD FAILED in 3s
3 actionable tasks: 1 executed, 2 up-to-date
➜  solr-mcp git:(pr/6) ✗ java --version
openjdk 25.0.1 2025-10-21 LTS
OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS)

epugh · 2025-10-29T15:01:57Z

Same error with ./gradlew jibBuildTar

epugh · 2025-10-29T15:05:29Z

Yeah, I think we should be solr-mcp everywhere!

adityamparikh · 2025-10-29T15:52:12Z

I am getting this error on running ./gradlew jibDockerBuild.... I am on an older mac with Intel chip:


➜  solr-mcp git:(pr/6) ✗ ./gradlew jibDockerBuild

> Task :jibDockerBuild FAILED



[Incubating] Problems report is available at: file:///Users/epugh/Documents/projects/solr-mcp/build/reports/problems/problems-report.html



FAILURE: Build failed with an exception.



* What went wrong:

Execution failed for task ':jibDockerBuild'.

> Check the full stace trace, and if the root cause is from ASM ClassReader about unsupported class file version, see https://github.com/GoogleContainerTools/jib/blob/master/docs/faq.md#i-am-seeing-unsupported-class-file-major-version-when-building



* Try:

> Run with --stacktrace option to get the stack trace.

> Run with --info or --debug option to get more log output.

> Run with --scan to generate a Build Scan (Powered by Develocity).

> Get more help at https://help.gradle.org.



Deprecated Gradle features were used in this build, making it incompatible with Gradle 10.



You can use '--warning-mode all' to show the individual deprecation warnings and determine if they come from your own scripts or plugins.



For more on this, please refer to https://docs.gradle.org/9.1.0/userguide/command_line_interface.html#sec:command_line_warnings in the Gradle documentation.



BUILD FAILED in 3s

3 actionable tasks: 1 executed, 2 up-to-date

➜  solr-mcp git:(pr/6) ✗ java --version

openjdk 25.0.1 2025-10-21 LTS

OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS)

I can't try this at this moment but I had downgraded to jdk 21 since jib support was not added for jdk 25 but the latest 3.4.7 version should have it GoogleContainerTools/jib@v3.4.5-gradle...v3.4.7-gradle

# Conflicts: # build.gradle.kts # gradle/libs.versions.toml

…d HTTP modes

adityamparikh · 2025-10-31T02:08:54Z

@epugh #7 will update to solr-mcp everywhere.
Removed sonar and claude. Will use whatever apache org allows us to.

epugh · 2025-10-31T11:15:11Z

okay, jibBuildDocker is working. jibBuildTar isn't: Execution failed for task ':jibBuildTar'.

com.google.cloud.tools.jib.plugins.common.BuildStepsExecutionException: multi-platform image building not supported when building a local tar image however I think we can fix that in the next PR!

adityamparikh · 2025-10-31T12:04:38Z

Thanks! We may not need a tar output so we may be able to remove it from the doc.

epugh · 2025-10-31T13:42:38Z

I like less build tooling!

dsmiley · 2025-11-11T02:18:49Z

wow this touched seemingly every source file to format it. Consequently, this is unreviewable. Please never do that in a PR about something else.

Add Docker support with Jib and GitHub Actions CI/CD

64d3ef2

adityamparikh mentioned this pull request Oct 27, 2025

feat: add Docker support with Jib and GitHub Actions CI/CD #4

Closed

5 tasks

Minimal .asf.yaml to get correct github notifications in place

4adefba

Apply spotless plugin (#5)

0db92d1

adityamparikh added 2 commits October 28, 2025 19:17

Add Docker support with Jib and GitHub Actions CI/CD

b7fa393

# Conflicts: # build.gradle.kts # gradle/libs.versions.toml

Merge remote-tracking branch 'origin/docker-jib' into docker-jib

5f422ae

# Conflicts: # build.gradle.kts # gradle/libs.versions.toml

Update the repo name pattern.

1cb62fb

adityamparikh added 2 commits October 29, 2025 22:40

Add Docker support with Jib and GitHub Actions CI/CD

e841c4c

# Conflicts: # build.gradle.kts # gradle/libs.versions.toml

test: add Docker integration tests for MCP server under both STDIO an…

14343b9

…d HTTP modes

adityamparikh changed the title ~~Add Docker support with Jib and GitHub Actions CI/CD~~ feat: Add Docker support with Jib and GitHub Actions CI/CD Oct 31, 2025

epugh merged commit e7642e7 into apache:main Oct 31, 2025
1 check failed

feat: Add Docker support with Jib and GitHub Actions CI/CD #6

feat: Add Docker support with Jib and GitHub Actions CI/CD #6

Uh oh!

Conversation

adityamparikh commented Oct 27, 2025

Summary

Key Features

Why Jib over Buildpacks?

Changes

Uh oh!

adityamparikh commented Oct 27, 2025

Uh oh!

adityamparikh commented Oct 28, 2025

Uh oh!

epugh commented Oct 28, 2025

Uh oh!

epugh commented Oct 28, 2025

Uh oh!

epugh commented Oct 29, 2025

Uh oh!

epugh commented Oct 29, 2025

Uh oh!

epugh commented Oct 29, 2025

Uh oh!

epugh commented Oct 29, 2025

Uh oh!

epugh commented Oct 29, 2025

Uh oh!

epugh commented Oct 29, 2025

Uh oh!

adityamparikh commented Oct 29, 2025

Uh oh!

adityamparikh commented Oct 31, 2025

Uh oh!

epugh commented Oct 31, 2025

Uh oh!

Uh oh!

adityamparikh commented Oct 31, 2025

Uh oh!

epugh commented Oct 31, 2025

Uh oh!

dsmiley commented Nov 11, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants