aahmedse/maven

Docker镜像文档

镜像概述

本镜像基于maven:3.8.5-openjdk-8-slim构建，集成了Docker运行环境、Python 2、SSH客户端及Git工具，旨在提供一个可在容器内运行Docker的综合环境，适用于需要在隔离环境中进行Java项目构建、Docker镜像构建或开发调试的场景。

核心功能与特性

• 基础环境：基于Maven 3.8.5和OpenJDK 8，支持Java项目构建
• Docker环境：集成Docker引擎及wrapdocker工具，支持在容器内运行Docker命令
• 开发工具：包含Python 2、SSH客户端（openssh-client）及Git，满足代码拉取、远程操作等需求
• 数据持久化：通过卷挂载/var/lib/docker，确保Docker数据持久化存储

使用场景

• Java项目的Docker化构建（在容器内完成项目编译并构建Docker镜像）
• 需要隔离Docker环境的开发或测试场景
• 需在单一容器内集成Maven构建、版本控制（Git）及Docker操作的工作流

使用方法

基本运行命令

由于需要运行Docker引擎，容器需以特权模式启动，并挂载Docker数据卷：

bash
docker run --privileged -v /var/lib/docker:/var/lib/docker [镜像名称或ID]

关键配置说明

卷挂载

• /var/lib/docker：Docker引擎数据存储目录，必须挂载以确保容器内Docker数据持久化，避免重启后数据丢失。

环境变量

本镜像未定义额外环境变量，可根据需求通过-e参数添加自定义环境变量，例如：

bash
docker run --privileged -v /var/lib/docker:/var/lib/docker -e "MAVEN_OPTS=-Xmx512m" [镜像名称或ID]

启动命令

默认启动命令为wrapdocker，该脚本负责初始化Docker环境并启动Docker服务。如需自定义启动行为，可在运行时覆盖命令：

bash
docker run --privileged -v /var/lib/docker:/var/lib/docker [镜像名称或ID] /bin/bash

典型使用示例

1. 启动容器并进入交互模式

bash
docker run -it --privileged -v /var/lib/docker:/var/lib/docker [镜像名称或ID] /bin/bash

进入容器后，可直接使用docker命令（如docker ps）、mvn命令（如mvn clean package）、git命令（如git clone）等工具。

2. 集成到docker-compose

创建docker-compose.yml文件：

yaml
version: '3'
services:
  dev-env:
    image: [镜像名称或ID]
    privileged: true
    volumes:
      - /var/lib/docker:/var/lib/docker
      - ./maven-repo:/root/.m2/repository  # 可选：挂载Maven本地仓库，加速依赖下载
    command: wrapdocker

通过docker-compose up -d启动服务。

注意事项

• 必须使用--privileged参数运行容器，否则Docker引擎无法正常启动
• wrapdocker脚本会自动处理Docker daemon的启动，无需额外手动启动
• 如需要网络访问（如拉取Git代码、Docker镜像），确保容器网络配置正确
• Python 2已停止官方支持，建议仅在必要场景下使用，优先考虑迁移至Python 3环境