topaztechnology/sbt-java17-build

Scala基础构建镜像

镜像概述

Scala基础构建镜像是一个专为Scala项目多阶段Docker构建设计的基础镜像。它集成了JDK 17和SBT构建工具，并通过缓存特定版本的Scala与SBT，有效缩短项目的镜像构建时间，适用于需要高效构建流程的Scala应用开发。

核心功能与特性

• 集成关键工具：内置JDK 17和SBT，满足Scala项目编译构建的基础环境需求
• 构建优化：缓存特定版本的Scala和SBT，避免重复下载依赖，显著提升构建速度
• 多阶段构建支持：作为基础构建阶段镜像，可与运行时镜像配合，实现精简的最终应用镜像

使用场景与适用范围

• Scala项目的Docker化构建流程
• 需要优化构建时间的CI/CD流水线
• 多阶段构建场景中，作为编译构建阶段的基础环境

使用方法与配置说明

基本使用示例（多阶段构建）

以下是使用该镜像进行Scala项目多阶段构建的Dockerfile示例：

dockerfile
# 构建阶段：使用Scala基础构建镜像
FROM docker.xuanyuan.run/scala-base-build-image AS builder
WORKDIR /app
# 复制项目文件
COPY . .
# 使用SBT构建项目
RUN sbt clean assembly

# 运行阶段：使用轻量级JRE镜像
FROM docker.xuanyuan.run/eclipse-temurin:17-jre-alpine
WORKDIR /app
# 从构建阶段复制构建产物
COPY --from=builder /app/target/scala-*/app-assembly-*.jar app.jar
# 运行应用
CMD ["java", "-jar", "app.jar"]

环境变量配置

该镜像支持通过环境变量自定义SBT和Scala版本（如未指定，将使用默认缓存版本）：

• SBT_VERSION：指定SBT版本（例如 1.9.6）
• SCALA_VERSION：指定Scala版本（例如 3.3.1）

示例：

dockerfile
FROM docker.xuanyuan.run/scala-base-build-image AS builder
ENV SBT_VERSION=1.9.6 SCALA_VERSION=3.3.1
WORKDIR /app
COPY . .
RUN sbt clean assembly

注意事项

• 确保项目的build.sbt中指定的Scala版本与镜像缓存的版本兼容
• 多阶段构建时，建议在构建阶段仅保留必要的构建依赖，以减小最终镜像体积
• 如需自定义SBT配置，可通过挂载或复制sbtconfig.txt到/root/.sbt/目录