makeorg/docker-sbt

docker-sbt 镜像文档

概述

docker-sbt是一个集成了Docker环境、Java运行时和SBT（Scala Build Tool）的构建镜像，旨在为Scala项目提供统一、便捷的构建环境，简化项目构建流程，确保开发与部署环境的一致性。

核心功能与特性

• 多工具集成：包含Docker环境，支持容器化操作；内置Java运行时，满足Scala项目运行需求；集成SBT构建工具，支持Scala项目的编译、测试和打包。
• 环境一致性：统一的构建环境，避免因本地环境差异导致的构建问题。
• 便捷性：开箱即用，无需手动配置SBT、Java及Docker依赖。

使用场景

• Scala项目构建：用于Scala应用程序的编译、测试和打包。
• CI/CD流程：集成到持续集成/持续部署 pipeline 中，实现自动化构建。
• 本地开发：为开发者提供一致的本地构建环境，简化项目 setup 流程。

使用方法

基本使用（Docker Run）

通过以下命令启动容器并运行SBT命令：

bash
docker run --rm -v $(pwd):/app -w /app docker-sbt sbt clean compile

• -v $(pwd):/app：将当前目录挂载到容器内的/app目录，便于项目文件访问。
• -w /app：设置工作目录为/app。
• sbt clean compile：执行SBT的清理和编译命令。

包含Docker操作的使用

若需在容器内使用Docker（如构建镜像），需挂载宿主机Docker套接字：

bash
docker run --rm -v $(pwd):/app -v /var/run/docker.sock:/var/run/docker.sock -w /app docker-sbt sbt docker:publishLocal

• -v /var/run/docker.sock:/var/run/docker.sock：挂载宿主机Docker套接字，使容器内Docker命令可与宿主机Docker服务通信。

自定义SBT配置

可通过挂载自定义SBT配置文件覆盖默认配置：

bash
docker run --rm -v $(pwd):/app -v ~/.sbt:/root/.sbt -w /app docker-sbt sbt package

• -v ~/.sbt:/root/.sbt：将本地SBT配置目录挂载到容器内，使用自定义配置。

注意事项

• 确保宿主机已安装Docker，且当前用户有足够权限运行Docker命令。
• 挂载目录时，注意文件权限问题，避免因权限不足导致构建失败。
• 如需使用特定版本的Java或SBT，建议查看镜像标签说明，选择对应版本的镜像。