csanchez/maven

docker-maven

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

所有镜像发布于 https://hub.docker.com/r/csanchez/maven%EF%BC%8C%E6%89%A9%E5%B1%95%E8%87%AADocker%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E7%9A%84%E7%89%88%E6%9C%AC%E5%90%8C%E6%97%B6%E5%8F%91%E5%B8%83%E4%BA%8E https://hub.docker.com/_/maven%E3%80%82

基于Linux的镜像

查看Docker Hub https://hub.docker.com/_/maven 和 https://hub.docker.com/r/csanchez/maven 获取最新标签列表

• https://github.com/carlossg/docker-maven/blob/master/openjdk-8/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/openjdk-8-slim/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/openjdk-11/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/openjdk-11-slim/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/openjdk-14/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/openjdk-14-slim/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/openjdk-15/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/adoptopenjdk-8/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/adoptopenjdk-8-openj9/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/adoptopenjdk-11/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/adoptopenjdk-11-openj9/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/adoptopenjdk-14/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/adoptopenjdk-14-openj9/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/ibmjava-8/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/ibmjava-8-alpine/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/amazoncorretto-8/Dockerfile
• https://github.com/carlossg/docker-maven/blob/master/amazoncorretto-11/
• https://github.com/carlossg/docker-maven/blob/master/azulzulu-11/Dockerfile - 仅在 csanchez/maven 仓库下

基于Windows的镜像

查看Docker Hub https://hub.docker.com/r/csanchez/maven 获取最新标签列表

• https://github.com/carlossg/docker-maven/blob/master/windows/Dockerfile.windows-openjdk-8
• https://github.com/carlossg/docker-maven/blob/master/windows/Dockerfile.windows-openjdk-8-nanoserver
• https://github.com/carlossg/docker-maven/blob/master/windows/Dockerfile.windows-openjdk-11
• https://github.com/carlossg/docker-maven/blob/master/windows/Dockerfile.windows-openjdk-11-nanoserver
• https://github.com/carlossg/docker-maven/blob/master/windows/Dockerfile.windows-openjdk-14
• https://github.com/carlossg/docker-maven/blob/master/windows/Dockerfile.windows-adoptopenjdk-8-openj9
• https://github.com/carlossg/docker-maven/blob/master/windows/Dockerfile.windows-adoptopenjdk-11-openj9
• https://github.com/carlossg/docker-maven/blob/master/windows/Dockerfile.windows-amazoncorretto-8
• https://github.com/carlossg/docker-maven/blob/master/windows/Dockerfile.windows-amazoncorretto-11
• https://github.com/carlossg/docker-maven/blob/master/windows/Dockerfile.windows-azulzulu-11

什么是Maven？

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

如何使用此镜像

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

Linux

bash
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

powershell
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

powershell
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

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

Windows

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

多阶段构建

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

dockerfile
# 构建阶段
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仓库：

bash
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共享的目录）：

bash
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 中使用：

bash
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 到镜像：

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

示例可查看 tests 目录。

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

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

bash
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>

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

构建与测试

构建镜像

bash
docker build -t maven .

测试

测试使用 https://github.com/sstephenson/bats%EF%BC%88Linux%EF%BC%89%E5%92%8C https://github.com/pester/Pester%EF%BC%88Windows%EF%BC%8C%E9%9C%80Pester 4.x）编写，位于 tests 目录。通过环境变量 TAG 指定测试镜像：

Linux

bash
TAG=jdk-11 bats tests

Windows

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

运行所有测试

Linux：

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

Windows：

powershell
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，参考教程
• 初始化子模块：

  bash
  git submodule init
  git submodule update
  

发布到Docker Hub

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

许可证

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

用户反馈

问题反馈

通过 https://github.com/carlossg/docker-maven/issues 提交问题，或在Freenode的 #docker-library IRC频道联系官方镜像维护者。

贡献

欢迎贡献功能、修复或更新。大型贡献建议先通过 https://github.com/carlossg/docker-maven/issues 讨论，以确保方向正确并避免重复工作。