如何配置CircleCI的gradle/test任务与其他任务共用相同Docker环境

CircleCI 每个 Job 运行在独立的隔离执行环境中，即使两个 Job 指定完全相同的 Docker 镜像，requires 字段也仅能控制任务执行顺序，不会自动共享文件系统。daml_test 生成的文件仅存在于它自己的运行容器内，容器销毁后文件会被清空，gradle/test 哪怕使用相同镜像启动新容器，也无法读取前序任务生成的文件，这是配置失效的核心原因。
CircleCI 官方不支持跨 Job 复用同一个运行中的容器实例，跨任务共享文件需要通过工作区（Workspace）能力实现。

• 统一两个任务的执行环境：给daml_test显式指定和gradle/test一致的daml-executor，避免两个任务的基础环境依赖版本不一致。
• 持久化daml_test生成的产物：在daml_test执行完成后，通过persist_to_workspace步骤把下游依赖的文件上传到CircleCI托管的工作区存储。如果daml_test是自定义编写的Job，直接在steps末尾加持久化逻辑；如果是第三方orb提供的预定义Job，通过post-steps参数传入持久化步骤即可，不需要重写整个Job。
• 在gradle/test中挂载工作区：调用gradle/test时，通过orb预留的pre-steps参数添加attach_workspace步骤，把上游存储的文件挂载到当前任务的工作目录中，同时显式指定executor: daml-executor覆盖gradle orb默认的执行镜像。

version: 2.1

orbs: 
  gradle: circleci/gradle@2.2.0

executors:
  daml-executor:
    docker:
      - image: cimg/openjdk:11.0-node
    working_directory: ~/project # 统一两个任务的工作目录，避免路径错位

jobs:
  # 自定义daml_test的配置参考，如果是orb提供的daml_test可跳过这段，直接在workflow中传post-steps
  daml_test:
    executor: daml-executor
    parameters:
      daml_sdk_version:
        type: string
      context:
        type: string
    steps:
      - checkout
      # 原有daml_test的执行逻辑，比如安装DAML SDK、执行测试、构建生成文件
      - run:
          name: Execute DAML test and build
          command: |
            # 替换为你实际的daml执行命令
      # 持久化需要共享的文件
      - persist_to_workspace:
          root: ~/project
          paths:
            # 替换为daml_test实际生成的、gradle任务依赖的文件/目录相对路径
            - .daml/dist
            - prototype/generated-src

workflows:
  checkout-build-test:
    jobs:
      - daml_test:
          daml_sdk_version: "2.2.0"
          context: refapps
          # 如果是第三方orb提供的daml_test，取消下面这段注释加持久化步骤即可
          # post-steps:
          #   - persist_to_workspace:
          #       root: ~/project
          #       paths:
          #         - .daml/dist
          #         - prototype/generated-src
      - gradle/test:
          app_src_directory: prototype
          executor: daml-executor # 覆盖gradle orb默认的executor，使用统一的jdk镜像
          requires:
            - daml_test
          # 任务启动前挂载上游持久化的工作区文件
          pre-steps:
            - attach_workspace:
                at: ~/project # 和persist_to_workspace的root路径保持完全一致

• persist_to_workspace的paths需要准确填写所有gradle/test依赖的生成文件路径，漏填会导致下游任务依然找不到对应文件。
• 持久化的root路径和挂载的at路径必须完全一致，否则会出现文件路径错位问题。
• 工作区的文件仅在同一个workflow的上下游依赖任务间共享，符合当前的任务依赖场景，不需要额外配置缓存。

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