Maven deploy 发布

war包等用于部署的模块应该配置忽略安装和发布到仓库

通常特别大，而且不会被引用

  <properties>
    <!-- 避免被安装发布到仓库 -->
    <maven.install.skip>true</maven.install.skip>
    <maven.deploy.skip>true</maven.deploy.skip>
  </properties>

一般情况下应推送源码和文档，便于依赖方研究如何使用和排查问题

推送源码官方参考：http://maven.apache.org/plugins/maven-source-plugin/usage.html

<project>
  ...
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-source-plugin</artifactId>
        <version>3.2.0</version>
        <executions>
          <execution>
            <id>attach-sources</id>
            <phase>verify</phase>
            <goals>
              <goal>jar-no-fork</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
  ...
</project>

应在包中包含 Git 信息方便在没有 Git Tag 的时候找到对应版本

打包Git信息官方参考：https://github.com/git-commit-id/git-commit-id-maven-plugin

<project>
  ...
  <build>
    <plugins>
      <plugin>
        <groupId>io.github.git-commit-id</groupId>
        <artifactId>git-commit-id-maven-plugin</artifactId>
        <version>4.9.9</version>
        <executions>
          <execution>
            <id>git-commit-id</id>
            <phase>initialize</phase>
            <goals>
              <goal>revision</goal>
            </goals>
          </execution>
        </executions>
        <configuration>
          <dateFormat>yyyy-MM-dd HH:mm:ss</dateFormat>
          <generateGitPropertiesFile>true</generateGitPropertiesFile>
          <generateGitPropertiesFilename>${project.build.outputDirectory}/git.json</generateGitPropertiesFilename>
          <format>json</format>
          <failOnNoGitDirectory>false</failOnNoGitDirectory>
          <failOnUnableToExtractRepoInfo>false</failOnUnableToExtractRepoInfo>
        </configuration>
      </plugin>
    </plugins>
  </build>
  ...
</project>

推送私服用命令行代替 distributionManagement 配置

```shell script mvn deploy -D altDeploymentRepository=deploymentRepo::default::发布URL

使用脚本配置发布 URL，而且 URL 应使用变量：
- Jenkins：系统管理 -> 系统配置 -> 全局属性 -> 环境变量
- Jenkins：系统管理 -> 节点管理 -> 配置从节点 -> 节点属性 -> 环境变量
- GitLab CI：群组设置 -> CI/CD -> 变量


下面这种方式建议在发布中央仓库时才使用，避免仓库迁移等情况需要修改多个 pom.xml

发布中央仓库配置：
```xml
  <!-- 发布管理 -->
  <distributionManagement>
    <repository>
      <id>deploymentRepo</id>
      <name>Nexus Release Repository</name>
      <url>https://oss.sonatype.org/service/local/staging/deploy/maven2</url>
    </repository>
    <snapshotRepository>
      <id>deploymentRepo</id>
      <name>Nexus Snapshot Repository</name>
      <url>https://oss.sonatype.org/content/repositories/snapshots</url>
    </snapshotRepository>
  </distributionManagement>

若要在 pom.xml 中设置私服：

  <!-- 发布管理 -->
  <distributionManagement>
    <repository>
      <id>deploymentRepo</id>
      <url>http://私服地址端口/repository/company_or_app_name_Release/</url>
    </repository>
    <snapshotRepository>
      <id>deploymentRepo</id>
      <url>http://私服地址端口/repository/company_or_app_name_Snapshot/</url>
    </snapshotRepository>
  </distributionManagement>

deploymentRepo 是 Maven 配置文件示例的 server id，若没有多个就不要修改，便于统一设置上传密码

setting.xml：

  <servers>
    <server>
      <id>deploymentRepo</id>
      <username>admin</username>
      <password>admin</password>
    </server>
  </servers>