accupara/ubuntu 镜像文档

1. 镜像概述和主要用途

1.1 概述

accupara/ubuntu 镜像是基于官方 Ubuntu 镜像构建的基础镜像，默认使用非 root 用户运行以增强安全性，并预装了 git、subversion 和 debhelpers 工具。镜像源代码托管于 GitHub。

1.2 主要用途

作为开发、构建环境的基础镜像，适用于需要 Ubuntu 系统环境且依赖版本控制工具（git/svn）或 Debian 包构建工具（debhelpers）的场景，尤其适合对容器内权限有严格要求的使用场景。

2. 核心功能和特性

• 基础系统：基于官方 Ubuntu 镜像构建，确保系统兼容性和稳定性。
• 安全增强：默认以非 root 用户运行，降低容器内权限风险。
• 预装工具：集成常用开发/构建工具，包括：
  • git（分布式版本控制系统）
  • subversion（集中式版本控制系统）
  • debhelpers（Debian 包构建工具集）。
• 多版本支持：提供多个 Ubuntu 版本和架构（32位/64位），具体标签见「版本标签」章节。

3. 使用场景和适用范围

• 开发环境：作为基础镜像搭建需要版本控制工具（git/svn）的开发环境。
• 构建环境：用于 Debian/Ubuntu 软件包（.deb）的构建流程，依托预装的 debhelpers 工具。
• 权限限制场景：需要限制容器内进程权限，避免直接使用 root 用户的场景。
• 基础镜像：作为其他应用镜像的基础层，减少重复配置工作。

4. 使用方法和配置说明

4.1 镜像拉取

通过 Docker Hub 拉取指定版本镜像：

# 拉取 Ubuntu 18.04 64位版本
docker pull accupara/ubuntu:18.04

# 拉取 Ubuntu 16.0432位版本
docker pull accupara/ubuntu:16.04_32

4.2 运行容器

4.2.1 基本交互式运行

以默认非 root 用户启动容器并进入终端：

docker run -it --rm accupara/ubuntu:18.04 /bin/bash

4.2.2 挂载本地目录

将本地项目目录挂载到容器中，用于开发或构建操作：

docker run -it --rm -v $(pwd):/app accupara/ubuntu:16.04 /bin/bash

4.2.3 临时使用 root 用户

如需 root 权限，可通过 -u root 参数指定：

docker run -it --rm -u root accupara/ubuntu:14.04 /bin/bash

4.3 配置说明

• 默认用户：镜像默认使用非 root 用户运行，具体用户名、UID/GID 等信息可通过以下命令查看或参考 GitHub 源代码：

  docker run --rm accupara/ubuntu:18.04 id
  

• 工具路径：预装工具（git、subversion、debhelpers）已添加到系统 PATH，可直接在终端中调用（如 git --version svn --version）。

4.4 docker-compose 配置示例

创建 docker-compose.yml 文件定义服务：

version: '3'
services:
  dev-env:
    image: accupara/ubuntu:18.04
    volumes:
      - ./project:/workspace  # 挂载本地项目目录
    command: /bin/bash  # 启动终端
    # 如需 root 权限，添加以下行
    # user: root

启动服务：

docker-compose up -d
docker-compose exec dev-env /bin/bash  # 进入容器终端

5. 版本标签

注：版本详情可通过 MicroBadger 查看，具体标签以 Docker Hub 和 GitHub 源代码 为准。

6. 源代码与反馈

镜像源代码托管于 GitHub，如有问题或需求，可通过仓库提交 issue 或 PR。