maven备忘

1. 搭建私有库

使用docker搭建私有maven库，docker image为sonatype/nexus3

mkdir /path/of/maven/data
chown 200 /path/of/maven/data

nexus3的运行用户id为200，所以需要把数据目录的owner改为200。

启动服务

docker run -d -p 8081:8081 --name nexus -v /path/of/maven/data:/nexus-data sonatype/nexus3

登录nexus服务

在浏览器中输入127.0.0.1:8081，点击sign in链接，默认的管理员用户名为admin密码为admin123。
创建repository

登录后，在管理员页面，可以创建自己的repository。如果创建自己的私有库，创建时，选择maven2 (hosted)，如果创建代理库，则选择maven2 (proxy)。详见参考文档[2]
1. hosted类型
  
  这里需要变更的是Version policy，有3个选择：
  1. Release - 表明本库里放置的是正式发布的库文件
  2. Snapshot - 表明本库里放置的是开发中的库文件
  3. Mixed - 表明库里面放置了上述两种库文件
2. proxy类型
  
  这里需要填写的是Remote storage项，可以填写aliyun的maven镜像地址http://maven.aliyun.com/nexus/content/groups/public/

经过上面的步骤，私有maven库建立完毕。接下来配置本地的maven配置文件，来使用私有maven库。

2. 配置maven setting.xml

maven设定文件为~/.m2/setting.xml


    
        
            dev
            
                
                    mymvn
                    http://127.0.0.1:8081/repository/mymvn/
                    
                        true
                    
                    
                        true
                    
                
            
        
    
    
        
            mymvn
            admin
            admin123
        
    
    
        
            alimavenlocal
            aliyun maven local
            http://127.0.0.1:8081/repository/aliyunmaven/
            central

上面的配置文件配置了1个hosted库，1个proxy库。以及上传文件时需要用的用户名密码。这里在profiles中配置repository，可以根据不同的profile使用不同的repository。

3. 部署jar到私有库

使用mvn命令把jar文件上传到hosted库，以alipay sdk为例：

mvn deploy:deploy-file \
  -DgroupId=com.alipay \
  -DartifactId=sdk-java \
  -Dversion=20170829142630 \
  -Dpackaging=jar \
  -Dfile=alipay-sdk-java20170829142630.jar \
  -Durl=http://127.0.0.1:8081/repository/mymvn/ \
  -DrepositoryId=mymvn

4. 配置`pom.xml`使用私有库

按照下面的配置即可下载到刚才上传的alipay sdk


...
    
        
            mymvn
            http://127.0.0.1:8081/repository/mymvn/
            
                true
            
            
                true
            
        
    

    
        
            com.alipay
            sdk-java
            20170829142630

5. 配置`pom.xml`，发布编译的成果到hosted库


...
    
        
            mymvn
            http://127.0.0.1:8081/repository/mymvn/
            
                true
            
            
                true

在pom.xml所在目录运行下面命令，把自己开发的库部署到hosted库中，mvn会根据pom中的version属性判断发布的是release版还是snapshot版。

mvn deploy

6. 版本发布

每次发布的时候，需要修改pom.xml中的版本号，打包，测试，提交代码，上传jar文件到mvn库。上述一系列动作，可以使用release的插件来自动完成。命令如下：

$ mvn release:prepare
...
[INFO] Working directory: /Users/menglj/workspace/qiyitech/pfw
[INFO] Checking dependencies and plugins for snapshots ...
What is the release version for "pfw"? (cn.com.qiyitech:pfw) 0.4.0: : 
# maven会根据pom中的版本信息来发布，如果pom中写的是`0.4.0-SNAPSHOT`，
# 则发布的版本为`0.4.0`。这里直接回车即可。
What is SCM release tag or label for "pfw"? (cn.com.qiyitech:pfw) pfw-0.4.0: : 
# tag名称，默认即可
What is the new development version for "pfw"? (cn.com.qiyitech:pfw) 0.4.1-SNAPSHOT: : 
# 发布后，下一版本的版本号是多少，可以改为0.5.0-SNAPSHOT

命令执行结束后，会把打包好的package上传到pom中配置的maven库中，修改pom.xml中相应版本号，并提交到版本库中，打上相应的tag。

7. 配置maven镜像

修改maven的settings.xml，增加如下字段：


    
        
            nexus-aliyun
            *
            Nexus aliyun
            http://maven.aliyun.com/nexus/content/groups/public

如果自己搭建了私有库，在镜像中没有私有库中的内容，则修改mirrorOf属性[3]，指明镜像的库ID即可，例如：

central

或者把不走镜像的私有库ID排除

*,!mymvn

参考文档

maven 安装alipay-sdk包到本地及远程仓库
maven使用Nexus私有仓库进行管理
maven repository mirrors