databricksruntime/minimal

Databricks Ubuntu Minimal 镜像文档

一、镜像概述和主要用途

本镜像为 Databricks 提供的 Ubuntu minimal 容器镜像，基于 Ubuntu 系统构建，专注于精简系统组件以减小体积。主要用途包括：

• 作为基础镜像，用于构建轻量级应用容器；
• 开发、测试环境的快速部署；
• 资源受限场景（如边缘设备、轻量级服务）的容器化部署。

二、核心功能和特性

1. 精简设计

基于 Ubuntu 系统精简组件，剔除非必要依赖，镜像体积显著小于标准 Ubuntu 镜像，适合资源受限环境。

2. 版本标签策略

• -LTS 后缀标签：基于 Ubuntu LTS（长期支持）版本构建，会定期接收安全补丁和更新，确保稳定性和安全性，推荐生产环境使用。
• 其他标签：作为示例镜像提供，仅用于参考或测试，不保证定期更新，不建议生产环境使用。

3. 兼容性

兼容 Docker 标准运行时，可直接用于 Docker、Kubernetes 等容器编排平台。

三、使用场景和适用范围

1. 基础镜像构建

作为应用容器的基础层，通过 FROM 指令在其之上添加应用依赖和配置，减小最终应用镜像体积。

2. 开发/测试环境

快速启动轻量级 Ubuntu 环境，用于临时开发调试或测试工具链兼容性。

3. CI/CD 流水线

集成到自动化构建流程中，作为编译、打包阶段的基础环境，提升流水线效率。

4. 资源受限环境

适用于边缘计算、嵌入式设备等资源有限场景，或对容器启动速度、磁盘占用有严格要求的部署。

四、详细使用方法和配置说明

1. 镜像拉取

通过 docker pull 命令拉取指定标签的镜像：

bash
# 拉取 LTS 标签（推荐生产环境）
docker pull databricks/ubuntu-minimal:<ubuntu-lts-version>-LTS

# 示例：拉取基于 Ubuntu 22.04 LTS 的镜像（假设标签为 22.04-LTS）
docker pull databricks/ubuntu-minimal:22.04-LTS

# 拉取非 LTS 示例标签（仅测试用）
docker pull databricks/ubuntu-minimal:latest

2. 运行容器示例

（1）基础运行

启动一个交互式容器，进入 bash 终端：

bash
docker run -it --rm databricks/ubuntu-minimal:22.04-LTS /bin/bash

• -it：交互式终端；
• --rm：容器退出后自动删除，避免残留。

（2）作为基础镜像构建自定义应用

通过 Dockerfile 基于本镜像扩展，添加应用依赖：

dockerfile
# 自定义应用 Dockerfile
FROM databricks/ubuntu-minimal:22.04-LTS

# 安装必要依赖（示例：安装 curl）
RUN apt-get update && apt-get install -y curl && rm -rf /var/lib/apt/lists/*

# 设置工作目录
WORKDIR /app

# 复制应用文件
COPY . .

# 启动命令
CMD ["./app"]

3. Docker Compose 配置示例

若需通过 docker-compose 管理容器，可参考以下配置（以基础运行为例）：

yaml
version: '3'
services:
  ubuntu-minimal:
    image: databricks/ubuntu-minimal:22.04-LTS
    tty: true  # 保持终端连接
    volumes:
      - ./local-data:/app/data  # 挂载本地目录到容器内
    command: /bin/bash  # 启动 bash 终端

运行命令：docker-compose up -d

五、注意事项

1. 版本选择：生产环境务必使用 -LTS 标签镜像，以获取定期安全更新；非 LTS 标签仅用于测试，避免依赖其稳定性。
2. 功能限制：作为 minimal 镜像，默认不含图形界面、部分系统工具（如 systemd），需根据需求通过 Dockerfile 扩展安装。
3. 镜像详细构建逻辑可参考 https://github.com/databricks/containers/blob/master/ubuntu/minimal/Dockerfile%E3%80%82

六、配置参数说明

本镜像作为基础 minimal 镜像，无预设自定义配置参数。用户可通过以下方式扩展：

• 环境变量：运行容器时通过 -e KEY=VALUE 设置，或在 Dockerfile 中通过 ENV 指令定义。
• 卷挂载：通过 -v 本地路径:容器路径 挂载数据卷，实现数据持久化或文件共享。
• 命令覆盖：通过 docker run 的 command 参数或 Dockerfile 的 CMD/ENTRYPOINT 自定义容器启动行为。