Maven的settings.xml文件结构之mirrors

最新推荐文章于 2024-09-05 11:13:54 发布

原创最新推荐文章于 2024-09-05 11:13:54 发布 · 1.3w 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#Maven #settings #mirror #mirrorOf

Maven 专栏收录该内容

45 篇文章

订阅专栏

本文介绍了如何在企业环境中配置Maven项目的远程库镜像，包括镜像库的基本概念、配置示例及参数说明。

Maven的远程库提供大量构件，供Maven项目直接下载使用。对于任何一个Maven项目，如果没有特别声明，默认使用同一个Maven的central库，称为Super POM，该库的url如下：

http://repo.maven.apache.org/maven2/

但是该远程库为所以项目共用，而且需要连接公共互联网访问，由于访问互联网的限制或安全控制的需要，在企业内部往往需要建立对远程库Super POM的镜像，并在此基础上组织自己的代码库。将Super POM库镜像到企业内部的代码库，即远程库的mirror。

Maven引用镜像，而不是直接引用远程库，这需要在Maven的settings.xml文件中进行设置，示例如下：

    <mirrors>
        <mirror>
            <id>my-arm</id>
            <mirrorOf>*,!sonar</mirrorOf>
            <url>https://mydomain/artifactory/proj-my-arm-release/</url>
        </mirror>
    </mirrors>

从上述示例可知，定义一个镜像库，至少需要提供如下三个参数：

首先是镜像库的id，用以唯一标识该镜像库，默认default
其次是镜像库的url，即该镜像库的访问位置
最后，也是最重要的，是要镜像的远程库。例如，如果要镜像Maven的central库，则设置<mirrorOf>central</mirrorOf>

对于mirrorOf参数，如果该镜像库的目标远程库不止一个，则可以使用*表示任意远程库；external:*表示任何不在localhost和文件系统中的远程库；r1,r2表示r1库或者r2库；*,!r1表示除了r1库之外的任何远程库。

此外，定义镜像库还可以提供name, layout(默认default), mirrorOfLayouts(默认default,legacy)。

注意：一个被镜像的远程库，在镜像库中只能有一个镜像。