atlassian/ubuntu-minimal

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 服务器兼容。