如何指定maven的分布管理组织范围？

Question

我试图弄清楚如何组织许多（大约 50 多个）maven2 项目，以便它们可以部署到中央 Nexus 存储库中。使用 mvn deploy 目标时，确实需要在 distributionManagement 标记中指定目标，如下所示：

<distributionManagement>
   <repository>
      <id>nexus-site</id>
        <url>http://central_nexus/server</url>
   </repository>
</distributionManagement>

现在，我不希望每个 pom.xml（其中 50 多个）都包含此块反复。我的第一个文件是 settings.xml 文件，但似乎不可能（根据设计）在那里定义它。 那么，第一个问题是，为什么会出现这种情况？如果可能的话，我可以在 maven2 发行版的 settings.xml 中指定它，该发行版可以分发给所有开发人员。

我发现的唯一可能的解决方案是创建一个组织范围的 master-pom 项目，其中包含这些设置，并通过 使所有其他 pom.xml 依赖于此 master-pom > 标签。但这在多模块构建中看起来有点奇怪：

- master configuration POM (pm)
- Project 1 parent pom (p1 with module 1 and module 2 as modules)
    - Project 1 module pom (with pm as parent)
    - Project 2 module pom (with pm as parent)

通常我在所有文档中都读到模块 poms 应该使用父 pom，而不是其他的 pom。但是在阅读了有关 Inheritance v. Aggregation 的 Maven 网站后，它写道，这确实是可能的。

我发现的一个问题是 Maven 站点生成，该设置似乎确实存在问题（如果模块没有直接反向引用，则模块无法正确链接）

那么，这是一种有效的方法吗？还有其他更明显、更简单的问题解决方案吗？

Answer 1

对此的最佳解决方案是为您组织中的所有项目创建一个简单的父 pom 文件项目（带有打包“pom”）。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>your.company</groupId>
    <artifactId>company-parent</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <distributionManagement>
        <repository>
            <id>nexus-site</id>
            <url>http://central_nexus/server</url>
        </repository>
    </distributionManagement>

</project>

可以构建、发布并将其部署到本地连接，以便每个人都可以访问其工件。

现在，对于您希望使用它的所有项目，只需包含此部分：

<parent>
  <groupId>your.company</groupId>
  <artifactId>company-parent</artifactId>
  <version>1.0.0</version>
</parent>

此解决方案将允许您轻松地将其他常见内容添加到公司的所有项目中。例如，如果您想将 JUnit 使用标准化为特定版本，那么这将是完美的地方。

如果您的项目使用具有自己的父级的多模块结构，Maven 还支持链式继承，因此完全可以接受让您的项目的父级 pom 文件引用您公司的父级 pom，并且让项目的子模块甚至不知道您的父级 pom 文件。公司的母公司。

我从您的示例项目结构中看到，您正在尝试将父项目与聚合器 pom.xml 置于同一级别。如果您的项目需要自己的父级，我发现的最佳方法是将父级包含在与其余模块相同的级别，并将聚合器 pom.xml 文件放在所有模块目录所在的根目录中。

- pom.xml (aggregator)
    - project-parent
    - project-module1
    - project-module2

您使用此结构所做的是将您的父模块包含在聚合器中，并使用 mvn install 从根目录构建所有内容。

我们在我的组织中使用了这个精确的解决方案，它经受住了时间的考验，并且对我们来说效果很好。

Answer 2

不需要父 POM。

您可以在 poms 中完全省略 distributionManagement 部分，并将其设置在构建服务器上或在 settings.xml 中。

要在构建服务器上执行此操作，只需传递到 mvn 命令：

-DaltSnapshotDeploymentRepository=snapshots::default::https://YOUR_NEXUS_URL/snapshots
-DaltReleaseDeploymentRepository=releases::default::https://YOUR_NEXUS_URL/releases

请参阅 https://maven.apache.org/plugins/maven-deploy-plugin/deploy-mojo.html 了解可以设置哪些选项的详细信息。

也可以在 settings.xml 中进行设置。

只需在其中创建一个启用并包含该属性的配置文件即可。

示例 settings.xml：

<settings>
[...]
  <profiles>
    <profile>
      <id>nexus</id>
      <properties>
        <altSnapshotDeploymentRepository>snapshots::default::https://YOUR_NEXUS_URL/snapshots</altSnapshotDeploymentRepository>
        <altReleaseDeploymentRepository>releases::default::https://YOUR_NEXUS_URL/releases</altReleaseDeploymentRepository>
      </properties>
    </profile>
  </profiles>

  <activeProfiles>
    <activeProfile>nexus</activeProfile>
  </activeProfiles>

</settings>

确保“snapshots”和“releases”的凭据位于 settings.xml 的 部分中

属性 altSnapshotDeploymentRepository 和 altReleaseDeploymentRepository 是通过 maven-deploy-plugin 引入的2.8 版。旧版本将失败并显示错误消息

Deployment failed: repository element was not specified in the POM inside distributionManagement element or in -DaltDeploymentRepository=id::layout::url parameter

要解决此问题，您可以强制使用较新版本的插件：

        <build>
          <pluginManagement>
            <plugins>
              <plugin>
                <artifactId>maven-deploy-plugin</artifactId>
                <version>2.8</version>
              </plugin>
            </plugins>
          </pluginManagement>
        </build>

Answer 3

关于 Michael Wyraz 的答案，您在 中使用 alt*DeploymentRepository 参数settings.xml 或者命令行，在 maven-deploy-plugin 3.0.0 版本中格式发生了变化，

在 value 中：

releases::default::https://YOUR_NEXUS_URL/releases

需要删除 default 部分，使其：

releases::https://YOUR_NEXUS_URL/releases