BitBucket自托管运行器：能否基于官方镜像扩展而非使用Docker-in-Docker？

• 完全可以基于官方镜像构建自定义镜像
  你完全不用局限于官方默认镜像，直接编写Dockerfile以docker-public.packages.atlassian.com/sox/atlassian/bitbucket-pipelines-runner为基础镜像，添加嵌入式开发所需的工具链、依赖包、环境变量甚至许可证文件都没问题。举个贴合你场景的简单示例：

  FROM docker-public.packages.atlassian.com/sox/atlassian/bitbucket-pipelines-runner
  # 安装嵌入式编译工具链
  RUN apt-get update && apt-get install -y gcc-arm-none-eabi make openocd
  # 设置编译目标环境变量
  ENV BUILD_TARGET=STM32F4
  # 复制本地许可证文件到容器指定路径
  COPY ./tool_license.key /opt/embedded-tools/license.key
  

  构建这个自定义镜像后，直接用它替换官方镜像启动自托管运行器即可，完全满足你的需求。

• Docker-in-Docker仅适用于特定场景
  只有当你的BitBucket Pipeline任务需要在运行过程中动态构建、推送或运行其他Docker镜像时，才需要启用Docker-in-Docker模式。如果你的工作只是编译嵌入式代码、打包固件、运行单元测试这类不需要操作Docker的任务，完全没必要用DinD，反而会增加配置复杂度。

• 凭证传递的简化方案
  既然不想把凭证内置到镜像里，也不想折腾DinD的凭证传递，最简单的方式是在启动自托管运行器容器时，通过环境变量或本地卷挂载传入：

  • 环境变量方式：docker run -e TOOL_CREDENTIAL="your-key" your-custom-image
  • 卷挂载方式：docker run -v /host/local/credentials:/container/path/credentials your-custom-image
    这样凭证不会被打包到镜像中，也不用处理DinD的额外配置，能大幅降低你的工作量。

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