maven:创建阿里云私有maven仓库塈maven 命令行发布Release版本

灰太狼 2023-01-15 09:25 156阅读 0赞

最近在网上查找才发现阿里云提供了免费私有 maven 仓库，这可解决我的大问题了。  
我们的大部分项目都是开源提供给用户的，这些项目我们都是发布到maven中央仓库，但也有部分内部使用的jar包，我们不希望发布到maven中央仓库，但也需要有发布版本管理，自己搭安装Nexus搭建Maven私有仓库总是有些麻烦，维护工作也不少。现在有阿里云提供的免费私有 maven 仓库正好能解决我们的问题。

打开下面的页面，使用支付宝或钉钉APP扫码认证就登录进来了，  
[https://packages.aliyun.com/maven][https_packages.aliyun.com_maven]

只需要按照提示绑定邮箱，简单的填写一个公司名称就可以了，也不需要做更多的验证。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0LzEwa20_size_16_color_FFFFFF_t_70_pic_center]  
点击`生产库-release`或`非生产库-snapshot`找到`Maven方式`如下图就可以看到详细的设置说明：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0LzEwa20_size_16_color_FFFFFF_t_70_pic_center 1]

## settings.xml ##

如上图在`$HOME/.m2/`文件目录下`settings.xml`  
找到`<servers></servers>`段添加如下用户登录信息。

<server>
        <id>rdc-releases</id>
        <username>************************</username>
        <password>************</password>
      </server>
      <server>
        <id>rdc-snapshots</id>
        <username>************************</username>
        <password>************</password>
      </server>
      
      <server>
        <id>rdc-plugin-releases</id>
        <username>************************</username>
        <password>************</password>
      </server>
      
      <server>
        <id>rdc-plugin-snapshots</id>
        <username>************************</username>
        <password>************</password>
      </server>

找到`<mirrors></mirrors>`段添加如下镜像信息，以便能更快速的下载jar包

<mirror>
    	    <id>mirror</id>
    	    <mirrorOf>central,jcenter,!rdc-releases,!rdc-snapshots</mirrorOf>
    	    <name>mirror</name>
    	    <url>https://maven.aliyun.com/nexus/content/groups/public</url>
    	  </mirror>

找到`<profiles></profiles>`段添加如下profile,以增加私有仓库，这样你的其他引用私有仓库的库的项目才能正确找到私有仓库的jar包

<profile>      
            <id>rdc_repo</id>      
            <activation>      
                <activeByDefault>true</activeByDefault>      
            </activation>      
    		<repositories>
    		  <repository>
    		    <id>rdc-releases</id>
    		    <url>https://packages.aliyun.com/maven/repository/2097834-release-WG4jQB/</url>
    		    <releases>
    		      <enabled>true</enabled>
    		    </releases>
    		    <snapshots>
    		      <enabled>false</enabled>
    		    </snapshots>
    		  </repository>
    		  <repository>
    		    <id>rdc-snapshots</id>
    		    <url>https://packages.aliyun.com/maven/repository/2097834-snapshot-p3z4YQ/</url>
    		    <releases>
    		      <enabled>false</enabled>
    		      </releases>
    		    <snapshots>
    		      <enabled>true</enabled>
    		    </snapshots>
    		  </repository>
    		</repositories>
    		
    		<pluginRepositories>
    		  <pluginRepository>
    		    <id>rdc-plugin-releases</id>
    		    <name>aliyun plugins release repository</name>
    		    <url>https://packages.aliyun.com/maven/repository/2097834-release-WG4jQB/</url>
    		    <releases>
    		      <enabled>true</enabled>
    		    </releases>
    		    <snapshots>
    		      <enabled>false</enabled>
    		    </snapshots>
    		  </pluginRepository>
    		  <pluginRepository>
    		    <id>rdc-plugin-snapshots</id>
    		    <name>aliyun plugins snapshot repository</name>
    		    <url>https://packages.aliyun.com/maven/repository/2097834-snapshot-p3z4YQ/</url>
    		    <releases>
    		      <enabled>false</enabled>
    		    </releases>
    		    <snapshots>
    		      <enabled>true</enabled>
    		    </snapshots>
    		  </pluginRepository>
    		</pluginRepositories>
        </profile>

`settings.xml`部分的修改就算完成了，下一步就是要修改自己项目的`pom.xml`以实现指定上传仓库位置及项目发布

## pom.xml ##

如果你的项目都是要发布到私有仓库的，按照官方提供的方法下图一样`setttings.xml`中定义制品上传配置肯定是更方便的。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0LzEwa20_size_16_color_FFFFFF_t_70_pic_center 2]  
因为我们的项目有的需要上传maven中央仓库，个别需要发布到私有仓库，并不是全部都需要向私有仓库发布，所以对于我们来说在需要发布到私有仓库的项目的pom.xml中定义制品上传配置才是更合适的。  
设置步骤如下：  
如上图找到自己的私有仓库的`Release版本上传仓库位置`和`Snapshot(快照)版本上传仓库位置`，按如下格式在自己的pom.xml中增加`<distributionManagement></distributionManagement>`段，定义自己的私有仓库的上传位置。

> 如果你的maven项目有子项目，只需要修改所有子项目共同引用的根项目的pom.xml就可以(通常就是项目根文件夹下的pom.xml),下同

<distributionManagement>
    		<repository>
    			<id>rdc-releases</id>
    			<url>https://packages.aliyun.com/maven/repository/xxxxxxx-release-xxxxxx</url>
    		</repository>
    		<snapshotRepository>
    			<id>rdc-snapshots</id>
    			<url>https://packages.aliyun.com/maven/repository/xxxxxxx-snapshot-xxxxxx</url>
    		</snapshotRepository>
    	</distributionManagement>

到目前为止，你已经可以执行`mvn deploy`来发布产品了。

但你的制品文件具体推送到哪个库，取决于你的项目`pom.xml`文件中`<version></version>`字段的版本后缀是否为`-SNAPSHOT`,如果后缀为`-SNAPSHOT`则推送到快照版本库，否则推送到Release版本库。

## release ##

对于经常要发布Release版本的我来说，这也挺麻烦的，有的时候一个项目中有几个子项目，所有的子项目中的`pom.xml`中的`<version></version>`字段都要手工修改，忙中出错在所难免。  
其实呢，maven已经很贴心的提供了`release`插件帮助开发者很方便的发布版本

首先在你的`pom.xml`中添加如下字段定义

<scm>
    		<connection>scm:git:https://gitee.com/xxxx/xxxx.git</connection>
    		<developerConnection>scm:git:https://gitee.com/xxxx/xxxx.git</developerConnection>
    		<url>https://gitee.com/xxxx/xxxx</url>
    	</scm>
    	<build>
    		<pluginManagement>
    			<plugins>
    				
    				<plugin>
    					<groupId>org.apache.maven.plugins</groupId>
    					<artifactId>maven-release-plugin</artifactId>
    					<version>2.1</version>
    					<configuration>
    						<mavenExecutorId>forked-path</mavenExecutorId>
    						<useReleaseProfile>false</useReleaseProfile>
    						<arguments>-Paliyun-release</arguments>
    					</configuration>
    				</plugin>
    			</plugins>
    		</pluginManagement>
    	</build>
    	<profiles>
    		
    		<profile>
    			<id>aliyun-release</id>
    			<build>
    				<plugins>
    					<plugin>
    						<groupId>org.apache.maven.plugins</groupId>
    						<artifactId>maven-source-plugin</artifactId>
    						<version>2.1.2</version>
    						<executions>
    							<execution>
    								<id>attach-sources</id>
    								<goals>
    									<goal>jar-no-fork</goal>
    								</goals>
    							</execution>
    						</executions>
    					</plugin>
    					<plugin>
    						<groupId>org.apache.maven.plugins</groupId>
    						<artifactId>maven-javadoc-plugin</artifactId>
    						<executions>
    							<execution>
    								<id>attach-javadocs</id>
    								<goals>
    									<goal>jar</goal>
    								</goals>
    							</execution>
    						</executions>
    					</plugin>
    				</plugins>
    			</build>
    		</profile>
    	</profiles>

有了上面的定义后，发布版本就变得很简单版本

先执行:

mvn release:prepare

完成发布准备工作，这里对当前项目状态有如下要求：

*  要求你的本地git仓库必须是干净的，没有修改未提交的文件
 *  要求项目所有的依赖库的版本都必须是release版本(不能有`-SNAPSHOT`)
 *  要求项目的当前版本为快照版本(`-SNAPSHOT`)

否则会报错，无法进行下一步。在这个过程中，maven会自动修改项目的`pom.xml`中的版本号为Release版本(删除`-SNAPSHOT`)并添加git 标签 (`${project_name}-${version}`),推送到远程git仓库(push)

> 是不是省了好多事儿？

准备工作成功执行后然后再执行：

mvn release:perform

完成版本上传

[https_packages.aliyun.com_maven]: https://packages.aliyun.com/maven
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0LzEwa20_size_16_color_FFFFFF_t_70_pic_center]: /images/20221022/bf7cb5b7bbdc4fbdb528511387490322.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0LzEwa20_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221022/2f55664b8a004edbbd50f37817a44826.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0LzEwa20_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221022/92dea297ab904c66a3c5d4c50a7158ee.png