如何用Jib构建多主类Java Gradle项目镜像并运行时指定主类

核心结论 #

不需要为每个主类单独构建镜像，完全可以通过Jib配置实现运行时动态指定主类。

问题原因 #

当项目存在多个主类且未在Jib配置中指定时，Jib无法自动确定要执行的主类，因此抛出报错：

Multiple valid main classes were found: ...

正确配置方案 #

方案1：自定义Entrypoint，通过命令行参数传递主类 #

修改Jib的container配置，预留外部传入主类的参数位置，构建后即可在docker run时动态指定：

container {
  // 用${0}接收外部传入的主类参数
  entrypoint = ['/bin/sh', '-c', 'java -cp $(cat /app/jib-classpath-file) ${0}']
}

构建镜像后，运行时通过以下命令指定主类：

docker run 你的镜像名 完整包名.主类名

示例：若主类为com.example.ServiceA和com.example.ServiceB，运行时可执行：

docker run my-project-image com.example.ServiceA
# 切换主类只需修改参数
docker run my-project-image com.example.ServiceB

方案2：设置默认主类，同时允许运行时覆盖 #

如果需要一个默认主类，同时保留运行时替换的灵活性，可采用以下配置：

container {
  // 设置默认主类
  mainClass = 'com.example.DefaultMain'
  // 配置entrypoint，允许通过命令行参数覆盖主类
  entrypoint = ['java', '-cp', '@/app/jib-classpath-file']
}

运行时，直接在镜像名后追加目标主类名即可覆盖默认值：

docker run my-project-image com.example.AlternativeMain

之前配置失败的原因 #

你之前的配置写死了MainClass，没有预留外部传入参数的位置，因此无法动态替换主类。改成使用参数占位符或直接开放命令行参数传递，就能解决问题。

内容的提问来源于stack exchange，提问作者Tom