Ubuntu 最小化基础镜像文档

一、镜像概述和主要用途

概述

本镜像为基于 Ubuntu 系统的最小化安装版本，通过 Docker *** contrib 脚本及 debootstrap 工具构建，确保底层环境的可靠性和纯净性。镜像仅包含 Ubuntu 系统运行所需的核心组件，无多余依赖，体积精简。

主要用途

作为 Bamboo Agents 的基础镜像（Bamboo 是 Atlassian 提供的 CI/CD 工具，Bamboo Agents 为执行构建、测试任务的代理节点），提供轻量级、可扩展的运行环境。同时也适用于需要最小化 Ubuntu 环境的其他场景，如轻量级应用部署、测试环境构建等。

二、核心功能和特性

1. 最小化系统环境
   仅包含 Ubuntu 系统核心组件，剔除冗余依赖，镜像体积小，启动速度快。

2. 可靠的构建方式
   基于 Docker *** contrib 脚本及 debootstrap 工具构建，遵循 Docker 镜像构建最佳实践，确保环境一致性和稳定性。

3. 良好的兼容性
   基于 Ubuntu 稳定版本，兼容 Ubuntu 生态的软件包管理工具（如 apt），可直接通过 apt 安装所需依赖。

4. 高度可扩展
   作为基础镜像，支持用户通过 Dockerfile 或容器内操作，灵活添加应用依赖、配置环境变量等，满足定制化需求。

三、使用场景和适用范围

主要场景

• Bamboo Agents 基础环境：作为 Bamboo Agents 的底层镜像，用户可在此基础上安装构建工具（如 JDK、Maven、Git、Docker 等），构建定制化的 CI/CD 代理节点。
• 轻量级应用部署：适用于需要 Ubuntu 环境但对资源占用敏感的场景，如运行轻量级服务、脚本任务等。
• 测试与开发环境：提供纯净的 Ubuntu 环境，用于软件兼容性测试、临时开发环境搭建等。

四、使用方法和配置说明

1. 镜像拉取

从镜像仓库拉取本镜像（假设镜像名称为 minimal-ubuntu-bamboo-base，实际需替换为真实仓库地址）：

bash
docker pull [镜像仓库地址]/minimal-ubuntu-bamboo-base:latest

2. 基本运行命令

2.1 交互式运行容器

用于查看镜像环境或临时操作：

bash
docker run -it --rm [镜像仓库地址]/minimal-ubuntu-bamboo-base:latest /bin/bash

• -it：交互式终端
• --rm：容器退出后自动删除
• /bin/bash：启动 bash 终端

2.2 后台运行容器

若需长期运行（如作为基础环境承载服务）：

bash
docker run -d --name minimal-ubuntu-container [镜像仓库地址]/minimal-ubuntu-bamboo-base:latest sleep infinity

• -d：后台运行
• --name：指定容器名称
• sleep infinity：保持容器运行（可替换为实际服务命令）

3. 环境变量

本镜像为最小化安装，无预设环境变量。用户可根据需求在运行容器时通过 -e 参数自定义，或在构建自定义镜像时通过 ENV 指令添加，例如：

bash
docker run -it -e "APP_HOME=/app" [镜像仓库地址]/minimal-ubuntu-bamboo-base:latest /bin/bash

4. 构建自定义镜像（基于本镜像）

通过 Dockerfile 扩展镜像，安装所需工具（以构建 Bamboo Agent 基础环境为例）：

Dockerfile 示例

dockerfile
# 基于本镜像构建
FROM [镜像仓库地址]/minimal-ubuntu-bamboo-base:latest

# 安装基础工具（Bamboo Agent 常用依赖）
RUN apt-get update && apt-get install -y --no-install-recommends \
    openjdk-17-jdk \
    git \
    maven \
    && rm -rf /var/lib/apt/lists/*

# 设置环境变量
ENV JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH

# 暴露 Bamboo Agent 默认端口（可选）
EXPOSE 54663

构建命令

bash
docker build -t custom-bamboo-agent-base -f Dockerfile .

5. Docker Compose 配置示例

适用于多容器环境中作为基础服务依赖：

yaml
version: '3.8'
services:
  bamboo-agent-base:
    image: [镜像仓库地址]/minimal-ubuntu-bamboo-base:latest
    container_name: bamboo-agent-base
    tty: true  # 保持终端连接
    volumes:
      - ./agent-data:/data  # 挂载数据卷（可选）
    # 可添加自定义环境变量、网络配置等

启动命令：

bash
docker-compose up -d

五、注意事项

1. 本镜像为最小化安装，部分系统工具（如 ifconfig、ping 等）未预装，需通过 apt-get install 手动安装。
2. 建议基于本镜像构建自定义镜像时，使用 --no-install-recommends 减少不必要依赖，并清理 apt 缓存（rm -rf /var/lib/apt/lists/*）以减小镜像体积。
3. 作为 Bamboo Agents 基础镜像时，需确保后续安装的构建工具版本与 Bamboo 服务器兼容。