如何在Bitbucket Pipelines的Docker容器中使用SBT与Ivy2缓存？

我之前也碰到过这个头疼的问题，Bitbucket Pipelines的Docker服务确实有这个挂载限制——只能用$BITBUCKET_CLONE_DIR及其子目录，直接挂载~/.ivy2肯定会报错。不过有几个更优雅的解决思路，分享给你：

方案1：修改缓存路径到克隆目录下（最推荐） #

核心思路是把SBT和Ivy的缓存目录从默认的~/.sbt、~/.ivy2迁移到$BITBUCKET_CLONE_DIR下的子目录，这样既符合Bitbucket Pipelines的缓存规则，又能让Docker容器合法挂载这些目录。

具体配置步骤： #

1. 重新定义缓存路径
   在bitbucket-pipelines.yml的definitions里，把sbt和ivy2的缓存指向克隆目录下的子目录：

   definitions:
     caches:
       sbt: $BITBUCKET_CLONE_DIR/.sbt
       ivy2: $BITBUCKET_CLONE_DIR/.ivy2
   

2. 指定SBT/Ivy的缓存位置
   在构建步骤中，通过环境变量告诉SBT和Ivy使用新的缓存目录，然后再执行Docker命令：

   step:
       name: My integration steps with Docker
       image: docker/compose:1.24.0
       size: 2x
       caches:
         - sbt
         - ivy2
       services:
         - docker
       script:
         # 设置环境变量，让SBT和Ivy把缓存写到克隆目录下
         - export SBT_OPTS="-Dsbt.global.base=$BITBUCKET_CLONE_DIR/.sbt -Dsbt.ivy.home=$BITBUCKET_CLONE_DIR/.ivy2"
         - export IVY_HOME=$BITBUCKET_CLONE_DIR/.ivy2
         # 先执行sbt命令触发依赖下载，缓存会自动存入指定目录
         - sbt compile
         # 现在Docker挂载克隆目录下的缓存目录就合法了
         - docker run -it -v $BITBUCKET_CLONE_DIR/.ivy2:/root/.ivy2 alpine sh -c 'ls ~/.ivy2'
   

这样配置后，Bitbucket Pipelines会正常缓存这些目录，Docker挂载也不会触发权限错误，完全不用手动复制，非常优雅。

方案2：预打包依赖到自定义Docker镜像 #

如果你的项目依赖变动不频繁，可以把SBT和常用依赖提前打包到自定义Docker镜像里，这样既不用依赖Pipelines的缓存，也不需要挂载任何目录，构建速度还更快。

示例Dockerfile： #

# 基于OpenJDK镜像，选择和你项目匹配的版本
FROM openjdk:11-jdk-slim

# 安装SBT
RUN apt-get update && apt-get install -y curl && \
    curl -Ls https://github.com/sbt/sbt/releases/download/v1.9.6/sbt-1.9.6.tgz | tar xz -C /opt && \
    rm -rf /var/lib/apt/lists/*

ENV PATH="/opt/sbt/bin:${PATH}"

# 提前下载项目依赖（把你的build.sbt和project目录复制到镜像里）
COPY build.sbt /tmp/build.sbt
COPY project /tmp/project

# 执行sbt compile触发依赖下载，缓存会留在镜像里
RUN cd /tmp && sbt compile

# 清理临时文件，减小镜像体积
RUN rm -rf /tmp/*

构建这个镜像后，推送到Docker Hub或者Bitbucket自己的容器注册表，然后在bitbucket-pipelines.yml里直接使用这个镜像。后续步骤里的Docker容器如果需要依赖，也可以基于这个镜像扩展，或者直接从镜像里复制缓存目录。

为什么之前的方式行不通？ #

Bitbucket Pipelines的Docker服务插件做了安全限制：只能挂载$BITBUCKET_CLONE_DIR及其子目录。这是因为构建环境的其他目录（比如~/.ivy2）属于Pipelines的宿主环境，而Docker容器运行在隔离的沙箱中，插件为了避免权限泄露和环境不一致，才做了这个限制。

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