Archiva安装以及配置文档

第1章 下载安装包

首先去官网：http://archiva.apache.org/下载最新的Release，目前2010年1月20日发布了一个稳定的1.3版本。

下载地址为：http://archiva.apache.org/download.html，选择Archiva 1.3 Standalone进行下载。

下载完成后，将文件解压到本地的硬盘上，修改为了便于管理与记忆将文件夹的名称为archiva（默认的文件夹名为：apache-archiva-1.3）。

这里我只是在window的环境下进行安装（可以运行的操作系统有：Linux，Mac ，Solaris ），安装前要保证jdk是否安装，maven是否安装（这个主要用来测试archiva是否安装成功），他俩的环境变量是否已配置。（环境变量的配置很简单，就是把他俩bin目录加到环境变量的path里即可。例如jdk为：C:/Program Files/Java/jdk1.5.0_09/bin，maven为：D:/apache-maven-2.2.1/bin）

1.1 安装步骤

1.在运行里启动cmd，然后进入archiva/bin的目录。

2.输入命令：【archiva install】进行安装。会自动提示安装完成。

3.然后输入：archiva start 来启动archiva。

4.在浏览器中输入http://localhost:8080/archiva来进入控制台。初次登陆需要设置管理员的密码。这个时候会有一个java的Applet的签名确认，这里需要你点击永远信任（具体的单词忘了是哪个了，所以有可能不是这个词，但是大概意思是这个，所以这里就用永远信任来代替）。

1.2 安装过程中的常见问题

没有安装jdk，或者maven。

第2章 使用说明

2.1 登陆Archiva修改密码

使用admin登陆Archiva新建用户，但是设置用户角色是必须是【Repository Observer】 ,这里thirdparty用来放置所有第三方的jar包（在开发阶段internal被禁止，按照internal的配置新建一个资源库：thirdparty来代替internal）

2.2 配置settings.xml及使用说明

为了统一以及规范，settings.xml文件的位置统一放在：$user.dir/.m2/settings.xml。其中$user.dir建议使用邮箱名或者汉字拼音，禁止使用汉字或者administrator。

规范的例子：C:/Docume~1 /liuyupeng/.m2/settings.xml。

因为Maven在读取settings.xml时，首选会先去$user.dir/.m2/下是否存在settings.xml如果存在则读取这个配置文件的信息，如果不存在才回去本地安装maven的目录读取settings.xml的信息，而且maven也推荐这种方式进行settings.xml文件的配置。

大家需要配置两个地方：

第一、在<servers>的标签中，增加如下的代码：

<server>

<id>snapshots</id>

<username>[userName]</username>

<password>[password]</password>

</server>

<server>

<id>thirdparty</id>

<username>[userName]</username>

<password>[password]</password>

</server>

这里[userName]，[password]值的是Archiva的登陆帐号的用户名以及密码。（再强调一下，如果这个帐号没有进行修改密码的激活，那么将是无效的！）

第二、在</profiles>的标签中，增加如下的代码：

<profile>

<id>Repository Proxy</id>

<activation>

<activeByDefault>true</activeByDefault>

</activation>

<repositories>

<repository>

<id>snapshots</id>

<name>Archiva Managed Snapshot Repository</name>

<url>http://192.168.1.8:8088/archiva/repository/snapshots/</url>

<releases>

<enabled>false</enabled>

</releases>

<snapshots>

<enabled>true</enabled>

</snapshots>

</repository>

<repository>

<id>thirdparty</id>

<name>Third Party</name>

<url>http://192.168.1.8:8088/archiva/repository/thirdparty/</url>

<releases>

<enabled>true</enabled>

</releases>

<snapshots>

<enabled>false</enabled>

</snapshots>

</repository>

</repositories>

</profile>

 

在这里实际上是配置了两个资源库的地址：一个是snapshots用来存放所有beta版本的Artifact；一个是thirdparty是产品所用到的第三方jar包的资源库，凡是从外部获得的jar都需要放在这个资源库中。关于这两资源库稍后还会有详细的说明。

2.3 配置pom.xml

pom.xml中不再允许添加外网的url地址，因为现在有Archiva所有第三方的jar就能从Archiva下载，所以pom.xml中不需要再填写外网的url地址。

2.4 上传Artifact

第三方的jar通过Archiva下载时，Archiva会同时在服务器中保存一份，这一个动作是Archiva自动完成的，所以不用大家操作，这些第三方的jar是保存在thirdparty资源库中。

另外自己需要上传beta版的Artifact，这些beta必须是经过单元测试以及继承测试通过的jar。（这里捎带手提一句，以后公司会上代码质量管理的软件，所以大家在上传代码或者jar时需要注意了，如果没有测试或者代码质量较低导致bug反复修改，会给自己的考评造成不小的影响！），beta版的Artifact是上传到Snapshot资源库。

2.4.1 上传方式

2.4.1.1 使用命令行进行上传

启动cmd，进入jar文件的目录，然后执行：

mvn deploy:deploy-file -DgroupId=ant -DartifactId=ant -Dversion=1.6.5 -Dpackaging=jar -Dfile=ant-1.6.5.jar -DrepositoryId=snapshots -Durl=http://192.168.1.8:8088/archiva/repository/snapshots/

在以上的参数中，仅仅列出了大家需要必须填写的参数

这些参数有：

groupId

artifactId

version

packaging

file

repositoryId

url

关于命令行参数的详细文档请见：http://maven.apache.org/plugins/maven-deploy-plugin/deploy-file-mojo.html

2.4.1.2 使用UI上传

登录到Archiva后，在左边的菜单中，有一个选项upload Artifact，点击这个连接后，在如下的页面中，大家可以填写表单内容，提交自己需要上传的Artifact