Maven及Maven仓库管理器Artifactory安装配置手册.doc

Maven及Maven仓库管理器Artifactory安装配置手册目录目录21 maven安装与配置21.1 下载21.2 解压缩21.3 设置环境变量32 Artifactory安装与配置32.1 下载32.2 解压32.3 jdk版本42.4 安装运行42.5 设置Maven仓库42.6 配置maven使用新仓库62.7 安装构件到artifactory构件仓库82.7.1 通过web界面安装构件92.7.2 通过Maven命令行安装构件102.8 Aritfactory其他特性112.8.1 备份构件仓库112.8.2 其他特性121 maven安装与配置1.1 下载Linux：/dyn/closer.cgi/maven/binaries/apache-maven-3.0-bin.tar.gzWindows：/dyn/closer.cgi/maven/binaries/apache-maven-3.0-bin.zip1.2 解压缩Linux：tar -zxvf apache-maven-3.0-bin.tar.gzWindows：略1.3 设置环境变量Linux：cd /etc/profile.d/创建java.sh并编辑vi java.sh/java.sh内容如下：M2_HOME=/./apache-maven-3.0M2=$M2_HOME/binPATH=$M2:$PATHexport M2_HOME M2 PATH/为java.sh添加可执行权限chmod +x java.sh/执行java.sh./java.sh设置完环境变量重新登录，运行mvn -v验证。Windows：略注：由于Maven是java工具，所以安装Maven前必须保证安装了jdk并且版本在1.5及以上。1.4 更改本地仓库位置Maven默认将本地仓库的位置设置在/.m2/repository，你可以在$M2_HOME$/conf/settings.xml中进行更改：2 Artifactory安装与配置2.1 下载到/download.php下载Artifactory的开源版本，目前最新版本为2.3.0，Atrifactory是一个可以部署在Tomcat等容器中的web程序。2.2 解压下载得到的文件为attifactory-2.3.0.zip，解压后目录结构如下：2.3 需要的jdk版本jdk要求1.5及以上，如果使用1.6的话，需要1.6.04以上。2.4 运行Artifactory运行有两种模式：一种模式是通过绑定的Jetty作为独立的服务器运行；另外一种是通过war的形式运行在其他servlet容器中。我们这里介绍的以war的形式运行在tomcat中，作为独立服务的模式请参考其网站上的用户向导：/confluence/display/RTF/Artifactory+User+Guide。Tomcat中运行Artifactory，只需将webappsartifactory.war复制到webapps下，启动Tomcat，通过http:/localhost:8080/artifactory就可以访问。2.5 添加Maven仓库 在Artifactory中我们需要创建3个仓库，它们是：内部私有仓库private-internal-repository：这个仓库包含仅在团队内使用的构件，它们由开发者手动上传，这个仓库不与ibiblio 中的远程仓库同步，因为这个仓库中的构件是团队私有的。 第三方库third-party：这个仓库包含公有的但不在ibiblio服务器上的构件，例如，最新版本的尚不在ibiblio的组件或jdbc驱动。这个仓库不与ibiblio同步，因为ibiblio没有这些jar。 Maven缓存库maven-cache：这个仓库与ibiblio仓库同步，它是ibiblio上的构件的缓存。 访问http:/localhost:8080/artifactory用admin/password登录，登录后进入admin页面，选择Repostories，右面出现Local Repostories、Remote Repositories和Virtual Repositories，如下图：在Local Repositories创建内部私有库private-internal-repository和第三方库third-party，在Remote Repositories创建maven缓存库maven-cache。创建Local Repositories时Repository Key为必填，创建Remote Repositories时除了Repository Key必填外，URL也是必填的，创建后在Artifacts页面就可以看到：点击新添加的仓库private-internal-repository，就会显示该仓库的信息，可以通过url来配置maven使用新仓库：2.6 配置maven使用新仓库两种方式配置maven使用新的仓库：一种是修改settings.xml文件Maven使用$M2_HOME$/conf/settings.xml文件来获取Maven仓库，如果没有在该文件中指定仓库，Maven默认使用ibiblio上的仓库，要使用新的仓库就需要修改settings.xml文件：另外一种是直接修改项目的pom.xml文件：配置完新仓库后，在构建Maven项目的时候，所有的构件库都会从新的仓库下载，控制台会显示下载的过程：在浏览器中查看artifactory，会发现artifactory下载并缓存了ibiblio上的构件：2.7 安装构件到artifactory构件仓库可以通过Web界面或Maven命令行安装构件。通过Web界面来安装更简单更快，并且不需要修改任何配置。通过命令行安装需要修改$M2_HOME$/conf/settings.xml文件和项目pom.xml文件。2.7.1 通过web界面安装构件1、登录artifactory，打开Deploy页面，上传要部署的构件（jar 文件或pom文件）。2、 如果你上传的是jar文件，Artifactory会为它创建pom文件。上传的时候你可以指定上传到哪个仓库以及GroupId、ArtifactId、Version、Type等相关信息。3、 上传完毕显示部署成功。4、 在Artifacts页面就可以看到上传的构件与artifactory自动创建的pom文件一起出现。2.7.2 通过命令行部署构件到artifactory内部仓库命令行部署构件到artifactory内部仓库有两种情况：一种情况是部署已经打包的jar文件，jar文件既可以是maven项目，也可以不是maven项目；另外一种情况是部署maven项目，项目并不需要提前打包，部署过程中会自动打包。 部署jar文件在$M2_HOME$/conf/settings.xml中添加如下配置：执行如下命令：命令中的参数repositoryId必须与$M2_HOME$/conf/settings.xml中server.id保持一致，参数url必须是artifactory中已有的local repository的url。新的构件会在仓库中出现，并且artifactory 会自动为我们创建pom文件。 部署maven项目当我们在maven项目中执行mvn clean install命令的时候，Maven仅仅打包和安装构件到本地仓库，要把它安装到artifactory管理的内部仓库中，我们必须在$M2_HOME$/conf/settings.xml中添加如下配置：并且在项目的pom.xml中添加如下内容：然后在项目目录下执行mvn deploy命令即可。settings.xml中server.id与pom.xml中distributionManagement.repository.id必须保持一致，distributionManagement.repository.url必须是artifactory中已存在的local repository的url。2.7.3 artifactory权限管理Artifactory可以对仓库和用户进行权限管理，使指定的用户对指定的仓库进行指定的操作。用admin用户登录，打开admin-security-permissions，点击添加新的权限目标，添加完毕进行编辑，指定仓库及用户和组的权限maven要使用artifactory中设置的权限需要在settings.xml的servers中添加相应的server标签，可以添加多个server来设置不同的用户。有一个项目myapp，依赖wex-1.2.0.jar和jmeter-java-2.3.4.jar，webx-1.2.0.jar存放在webx-repository仓库中，jmeter-java-2.3.4.jar存放在third-party仓库中，因此pom.xml内容片段如下： webxwebx1.2.0org.apache.jmeterjmeter-java2.3.4 third-partyThird party Repository1:8088/artifactory/third-partywebx-repositorywebx Repository1:8088/artifactory/webx-repository 在仓库管理工具artifactory中我们对webx-repository和third-party两个仓库设置了权限，权限webx管理webx-repository只允许用户webx访问，权限aaaaa管理third-party只允许用户aaaaa访问，并且均不允许匿名访问，因此在settings.xml文件中我们配置了两个server，如下： webx-repository webx webx third-party aaaaa aaaaa 经过以上的配置后，我们运行mvn compile命令来编译myapp项目，但是控制台却显示找不到webx-1.2.0.jar，而当我我们将third-partyThird party Repository1:8088/artifactory/third-partywebx-repositorywebx Repository1:8088/artifactory/webx-repository 改为webx-repositorywebx Repository1:8088/artifactory/webx-repositorythird-partyThird party Repository1:8088/artifactory/third-party 后，mvn compile命令来编译myapp项目，但是控制台却显示找不到jmeter-java-2.3.4.jar。避免上述错误的解决方法是配置权限webx管理多个仓库，这样只需配置一个server即可。2.8 Aritfa