jumpserver/maven

Maven 镜像文档

快速参考

• 维护者：
  https://github.com/wojiushixiaobai/docker-library-loong64

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

  • https://github.com/wojiushixiaobai/docker-library-loong64/blob/master/maven/openjdk-17-slim/Dockerfile
  • https://github.com/wojiushixiaobai/docker-library-loong64/blob/master/maven/openjdk-11-slim/Dockerfile
  • https://github.com/wojiushixiaobai/docker-library-loong64/blob/master/maven/openjdk-8-slim/Dockerfile

• 问题反馈地址：
  https://github.com/wojiushixiaobai/docker-library-loong64/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  amd64, arm64, loong64

• 描述来源：
  https://github.com/docker-library/docs/tree/master/maven (https://github.com/docker-library/docs/commits/master/maven)

什么是Maven？

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

!https://raw.githubusercontent.com/docker-library/docs/e2782b8942c1af41419536078c8d0176665a005d/maven/logo.png

如何使用此镜像

直接运行Maven项目

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

bash
$ docker run -it --rm --name my-maven-project -v "$(pwd)":/usr/src/mymaven -w /usr/src/mymaven jumpserver/maven:3.9.2-openjdk-8-slim mvn clean install

构建本地Docker镜像（可选）

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

bash
$ docker build --tag my_local_maven:3.5.2-jdk-8 .

复用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缓存目录（如与Eclipse/IDEA共享）：

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 clean package  

在镜像中打包本地仓库

$MAVEN_CONFIG目录（默认/root/.m2）可配置为卷，因此在构建时复制到该目录的内容会丢失。为此，镜像中存在/usr/share/maven/ref/目录，容器启动时会将该目录下的所有内容复制到$MAVEN_CONFIG。

创建预打包仓库

创建包含所需依赖的pom.xml，并在Dockerfile中使用：

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

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

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

示例可参考tests目录。

以非root用户运行

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

镜像变体

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

jumpserver/maven:

默认镜像。若不确定需求，建议使用此变体。既可作为临时容器（挂载源代码启动应用），也可作为基础镜像构建其他镜像。

部分标签包含bookworm等名称，这些是Debian的发行版代号，指示镜像基于哪个Debian版本。若需安装额外包，建议显式指定此类标签以减少Debian版本更新导致的问题。

部分标签包含focal等名称，这些是Ubuntu的发行版代号，指示镜像基于哪个Ubuntu版本。若需安装额外包，建议显式指定此类标签以减少Ubuntu版本更新导致的问题。

许可

查看此镜像包含软件的许可信息。

与所有Docker镜像一样，此镜像可能包含其他软件（如基础发行版的Bash等），这些软件可能采用其他许可。

可在https://github.com/docker-library/repo-info/tree/master/repos/maven%E4%B8%AD%E6%89%BE%E5%88%B0%E8%87%AA%E5%8A%A8%E6%A3%80%E6%B5%8B%E5%88%B0%E7%9A%84%E9%A2%9D%E5%A4%96%E8%AE%B8%E5%8F%AF%E4%BF%A1%E6%81%AF%E3%80%82

对于任何预构建镜像的使用，用户有责任确保其使用符合镜像中所有软件的相关许可。