docker-maven

支持的标签及对应的Dockerfile链接

所有镜像发布于 csanchez/maven，扩展自Docker官方镜像的版本同时发布于 maven。

基于Linux的镜像

查看Docker Hub maven 和 csanchez/maven 获取最新标签列表

• openjdk-8
• openjdk-8-slim
• openjdk-11
• openjdk-11-slim
• openjdk-14
• openjdk-14-slim
• openjdk-15
• adoptopenjdk-8
• adoptopenjdk-8-openj9
• adoptopenjdk-11
• adoptopenjdk-11-openj9
• adoptopenjdk-14
• adoptopenjdk-14-openj9
• ibmjava-8
• ibmjava-8-alpine
• amazoncorretto-8
• amazoncorretto-11
• azulzulu-11 - 仅在 csanchez/maven 仓库下

基于Windows的镜像

查看Docker Hub csanchez/maven 获取最新标签列表

• openjdk-8-windows
• openjdk-8-windows-nanoserver
• openjdk-11-windows
• openjdk-11-windows-nanoserver
• openjdk-14-windows
• adoptopenjdk-8-openj9-windows
• adoptopenjdk-11-openj9-windows
• amazoncorretto-8-windows
• amazoncorretto-11-windows
• azulzulu-11-windows

什么是Maven？

Apache Maven 是一款软件项目管理与理解工具。基于项目对象模型（POM）概念，Maven可从中央信息源管理项目的构建、报告和文档。

如何使用此镜像

可直接使用Maven Docker镜像运行Maven项目，通过 docker run 传递Maven命令：

Linux

docker run -it --rm --name my-maven-project -v "$(pwd)":/usr/src/mymaven -w /usr/src/mymaven maven:3.3-jdk-8 mvn verify

Windows

docker run -it --rm --name my-maven-project -v "$(Get-Location)":C:/Src -w C:/Src csanchez/maven:3.3-jdk-8-windows mvn verify

Windows

docker run -it --rm --name my-maven-project -v "$(Get-Location)":C:/Src -w C:/Src maven:3.3-jdk-8-windows mvn clean install

构建本地Docker镜像（可选）

此为基础镜像，包含最精简的必要依赖。若在 Dockerfile 中添加自定义包，可按以下方式构建本地镜像：

Linux

docker build --tag my_local_maven:3.6.0-jdk-8 .

Windows

docker build -f Dockerfile.windows --tag my_local_maven:3-jdk-9-windows --build-arg WINDOWS_DOCKER_TAG=1803 .

多阶段构建

可使用Maven构建应用并通过多阶段构建将其打包到不含Maven的镜像中：

# 构建阶段
FROM maven
WORKDIR /usr/src/app
COPY pom.xml .
RUN mvn -B -e -C -T 1C org.apache.maven.plugins:maven-dependency-plugin:3.1.1:go-offline
COPY . .
RUN mvn -B -e -o -T 1C verify

# 打包阶段（不含Maven）
FROM openjdk
COPY --from=0 /usr/src/app/target/*.jar ./

重用Maven本地仓库

通过创建卷并挂载到 /root/.m2，可在容器间重用本地Maven仓库：

docker volume create --name maven-repo
docker run -it -v maven-repo:/root/.m2 maven mvn archetype:generate # 下载依赖
docker run -it -v maven-repo:/root/.m2 maven mvn archetype:generate # 重用已下载依赖

或直接使用主机的 .m2 缓存目录（如与IDE共享的目录）：

docker run -it --rm -v "$PWD":/usr/src/mymaven -v "$HOME/.m2":/root/.m2 -v "$PWD/target:/usr/src/mymaven/target" -w /usr/src/mymaven maven mvn package

在镜像中打包本地仓库

$MAVEN_CONFIG 目录（默认 /root/.m2 或 C:\Users\ContainerUser\.m2）可配置为卷，故构建时复制的内容会丢失。为此提供 /usr/share/maven/ref/（或 C:\ProgramData\Maven\Reference）目录，容器启动时会将其内容复制到 $MAVEN_CONFIG。

要创建预打包仓库，需准备含所需依赖的 pom.xml 并在 Dockerfile 中使用：

COPY pom.xml /tmp/pom.xml
RUN mvn -B -f /tmp/pom.xml -s /usr/share/maven/ref/settings-docker.xml dependency:resolve

添加自定义 settings.xml 到镜像：

COPY settings.xml /usr/share/maven/ref/

示例可查看 tests 目录。

以非root用户运行（Windows不支持）

Maven需用户主目录存储依赖，若用户不存在需设置 user.home Java属性。例如，以用户 1000 运行并挂载主机Maven仓库：

docker run -v ~/.m2:/var/maven/.m2 -ti --rm -u 1000 -e MAVEN_CONFIG=/var/maven/.m2 maven mvn -Duser.home=/var/maven archetype:generate

镜像变体

maven 镜像提供多种变体，适用于不同场景：

maven:<version>

默认镜像，适用于临时容器（挂载源码运行）及作为基础镜像构建其他镜像，含最精简依赖。

构建与测试

构建镜像

docker build -t maven .

测试

测试使用 bats（Linux）和 pester（Windows，需Pester 4.x）编写，位于 tests 目录。通过环境变量 TAG 指定测试镜像：

Linux

TAG=jdk-11 bats tests

Windows

$env:TAG="jdk-11" ; Invoke-Pester -Path tests

运行所有测试

Linux：

for dir in $(/bin/ls -1 -d */ | grep -v 'tests\|windows'); do TAG=$(basename $dir) bats tests; done

Windows：

Get-ChildItem -Path windows\* -File -Include "Dockerfile.windows-*" | ForEach-Object { Push-Location ; $env:TAG=$_.Name.Replace('Dockerfile.windows-', '') ; Invoke-Pester -Path tests ; Pop-Location }

依赖准备

• Bats：OS X可通过 brew install bats 安装
• Pester：Windows需升级到4.x，参考教程
• 初始化子模块：

  git submodule init
  git submodule update
  

发布到Docker Hub

需向 docker-library/official-images 提交PR，通过 publish.sh 运行 generate-stackbrew-library.sh 实现。

许可证

查看镜像中软件的许可证信息。

用户反馈

问题反馈

通过 GitHub issue 提交问题，或在Freenode的 #docker-library IRC频道联系官方镜像维护者。

贡献

欢迎贡献功能、修复或更新。大型贡献建议先通过 GitHub issue 讨论，以确保方向正确并避免重复工作。