使用自定义Maven设置文件

Mavensettings.xml文件定义了以各种方式配置 Maven 执行的值。最常见的是，它用于定义本地存储库位置、备用远程存储库服务器以及私有存储库的身份验证信息。在本文中，您将学习如何向部署在 Heroku 上的 Java 应用程序添加自定义设置文件。

如果您已经有一个 Java 应用程序，您可以在本示例中使用它。否则，从Heroku 上的 Java 入门文章创建一个简单的应用程序。

创建自定义设置文件

当settings.xml应用程序的根目录中存在名为的文件时， Heroku 的 Java 支持将在编译时自动使用它来配置 Maven。

为了演示这一点，settings.xml在 Java 项目的根目录中添加一个文件，并将以下代码放入其中。

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <profiles>
    <profile>
      <id>jboss-public</id>
      <repositories>
        <repository>
          <id>jboss-public-repository</id>
          <name>JBoss Public Maven Repository Group</name>
          <url>http://repository.jboss.org/nexus/content/groups/public/</url>
        </repository>
      </repositories>
    </profile>
  </profiles>
  <activeProfiles>
    <activeProfile>jboss-public</activeProfile>
  </activeProfiles>
</settings>

这告诉 Maven在解析应用程序的依赖项时搜索托管在http://repository.jboss.org/的存储库。存储库必须使用 HTTP 或 HTTPS 寻址。

我们可以通过将-s选项添加到任何 Maven 任务来在本地测试设置。但首先，我们需要向项目添加一个新的依赖项。该jboss.web.servlet-api库是一个很好的示例，因为它仅在 JBoss 存储库中可用。将以下元素添加到您的项目的pom.xml：

<dependency>
  <groupId>jboss.web</groupId>
  <artifactId>servlet-api</artifactId>
  <version>2.1.0.GA</version>
</dependency>

现在运行以下命令，Maven 将下载工件。

mvn -s settings.xml dependency:list
[INFO] Scanning for projects...
...
Downloading: http://repository.jboss.org/nexus/content/groups/public/jboss/web/servlet-api/2.1.0.GA/servlet-api-2.1.0.GA.pom
Downloaded: http://repository.jboss.org/nexus/content/groups/public/jboss/web/servlet-api/2.1.0.GA/servlet-api-2.1.0.GA.pom (195 B at 0.2 KB/sec)
Downloading: http://repository.jboss.org/nexus/content/groups/public/jboss/web/servlet-api/2.1.0.GA/servlet-api-2.1.0.GA.jar
Downloaded: http://repository.jboss.org/nexus/content/groups/public/jboss/web/servlet-api/2.1.0.GA/servlet-api-2.1.0.GA.jar (84 KB at 90.8 KB/sec)

如果我们没有使用自定义设置文件，构建就会失败，Maven 会产生这样的错误：

Downloading: http://repo.maven.apache.org/maven2/jboss/web/servlet-api/2.1.0.GA/servlet-api-2.1.0.GA.pom
[WARNING] The POM for jboss.web:servlet-api:jar:2.1.0.GA is missing, no dependency information available
Downloading: http://repo.maven.apache.org/maven2/jboss/web/servlet-api/2.1.0.GA/servlet-api-2.1.0.GA.jar
...
[ERROR] Failed to execute goal on project helloworld: Could not resolve dependencies for project com.example:helloworld:jar:1.0-SNAPSHOT: Could not find artifact jboss.web:servlet-api:jar:2.1.0.GA in central (http://repo.maven.apache.org/maven2) -> [Help 1]

现在将settings.xml和pom.xml更改添加到您的 Git 存储库并像这样部署到 Heroku：

当 Maven 在 dyno 上运行时，我们看到的输出与我们在本地看到的输出相同。这是有效的，因为 Heroku 检测settings.xml根目录中的文件，并将-s选项添加到 Maven 命令。接下来，我们将讨论如何自定义此位置。

定义 MAVEN_SETTINGS_PATH 配置变量

如果您不希望该settings.xml文件位于根目录中，或者您打算在不同的设置配置之间频繁更改，您可能更愿意将设置文件放在自定义位置。Heroku 通过MAVEN_SETTINGS_PATHconfig 变量提供此功能。

我们可以通过将现有文件移动settings.xml到support/目录中并像这样重命名来演示此功能：

mkdir -p support
git mv settings.xml support/jboss-settings.xml

现在我们通过定义MAVEN_SETTINGS_PATH相对于根目录来告诉 Heroku 设置文件所在的位置。

heroku config:set MAVEN_SETTINGS_PATH=support/jboss-settings.xml

在测试更改之前，我们增加了 servlet-api 的版本——强制 Maven 再次下载它。更改pom.xmlto version 中的依赖项2.1.1.GA。它应该是这样的：

<dependency>
  <groupId>jboss.web</groupId>
  <artifactId>servlet-api</artifactId>
  <version>2.1.1.GA</version>
</dependency>

现在将更改提交到 Git，然后像这样重新部署到 Heroku：

git commit -am "moved settings file and incremented servlet-api version"
git push heroku master

Maven 将再次从 JBoss 存储库下载依赖项。这提供了一些灵活性，但有时在您的项目中自定义位置是不够的。您可能希望将文件完全保留在您的代码库之外。

定义 MAVEN_SETTINGS_URL 配置变量

当MAVEN_SETTINGS_URL定义配置变量，Heroku的将下载的文件在指定的位置，并用它来配置Maven。在演示之前，我们必须取消设置我们在上一个示例中定义的变量，因为如果两个变量都设置了，它将优先：

heroku config:unset MAVEN_SETTINGS_PATH

现在，我们可以使用settings.xml来自公开可用源(例如 Torquebox Application Server 代码库)的 。像这样设置配置变量：

heroku config:set MAVEN_SETTINGS_URL="http://raw.githubusercontent.com/torquebox/torquebox/master/support/settings.xml"

和以前一样，将 servlet-api 版本增加到2.1.2.GA，添加pom.xml到 Git 存储库，提交更改并重新部署到 Heroku。Maven 将像之前一样从 JBoss 存储库下载新的工件。

JBoss 存储库很方便，因为它是公共的——不需要密码即可访问。但并非所有存储库都如此开放。

使用受密码保护的存储库

某些工件存储库需要用户名和密码才能访问。很多时候，存储库是托管内部工件的私有服务器。在这种情况下，必须在 中提供访问存储库的凭据，settings.xml如果将文件签入 Git 存储库，这可能会出现问题。

幸运的是，Maven 设置文件可以检测环境变量。表单中的任何标记${env.ENV_VAR}(其中ENV_VAR是变量的名称)都将解析为关联环境变量的值。因此，我们可以将私有 Maven 存储库的密码定义为 Heroku 配置变量，如下所示：

heroku config:set MAVEN_REPO_PASSWORD="deployment123"

然后，我们可以用我们的变量settings.xml通过创建一个文件<server>相匹配的元素<id>中的<repository>元素中<activeProfile>。

<servers>
  <server>
    <id>my-private-repo</id>
    <username>deployment</username>
    <password>${env.MAVEN_REPO_PASSWORD}</password>
  </server>
</servers>

为了演示这一点，您将需要一个私有的 Maven存储库。您可以通过下载Sonatype Nexus并按照保护存储库的说明来创建存储库。或者您可以使用JFrog Artifactory的托管版本。

在任何一种情况下，都可以使用私有存储库来发布内部工件并将它们包含在您的 Heroku 应用程序中。