Apache Archiva使用手册完整版

ApacheArchiva使用手册

目录ApacheArchiva使用手册 11 用户指导 41.1 预览 4权限 4存储库浏览布局 4工件信息 4下载工件 7元数据 71.2 搜索 7索引 7可以搜索什么？ 8快速搜索 8搜索结果 91.3 删除工件 10删除神器 10删除groupId 10删除工件 101.4 配置Maven2以使用Archiva存储库 11仅使用Archiva 11使用Archiva作为附加存储库 111.5 添加工件到到存储库中 13通过Maven添加到Archiva存储库 13通过WebUI表单进行添加 151.6 配置虚拟存储库 16配置虚拟存储库 181.7 RSS订阅 18工件的新版本 19认证 191.8 查询Artifacts 19查询格式 192 管理员指南 192.1 用户安全管理 19a) 管理Archiva用户 19管理用户 20用户版 21用户注册 22b) 角色管理 22一般角色 242.2 Archiva系统配置 24A. 配置存储库 24B. 配置代理连接器 24C. 配置网络代理 24D. 配置代理连接器规则 24E. 网络配置 24F. 配置存储库扫描和使用者 24G. 暂存和合并存储库 24H. 外观配置 24I. UI配置 24J. Url缓存失败配置 24K. 文件锁定配置 24L. Redback运行时配置 242.3 系统状态 252.4 日志文件 252.5 存储库统计功能 25

用户指导预览权限用户只能浏览自己的存储库。如果用户无权访问任何存储库，则会显示“您无权访问存储库。请求系统管理员访问”的消息。存储库浏览布局RepositoryBrowse中存储库的当前布局使用Maven2布局，即groupId，artifactId和version。单击版本时，将显示“工件信息”页面（请参阅下一节）。目前有关于Maven1工件的问题，请参阅/browse/MRM-585。工件信息存储库中的项目是超链接，允许您轻松访问以查看更多信息。通过单击组ID或工件ID，您将进入存储库浏览器。“工件信息”页面分为六个视图：1.工件信息：

此处显示有关工件的基本信息。这些是groupId，artifactId，版本和包装。还可以使用依赖pom.xml，用户可以将其复制并粘贴到pom文件中，以将该工件声明为项目的依赖项。2.依赖性：此处将列出工件的依赖关系。用户可以通过单击groupId，artifactId或Versions链接轻松导航到特定依赖项。还显示了依赖的范围。3.依赖树。工件的依赖关系以树状视图显示，也可以导航。列出存储库中使用此工件的所有工件。5.邮寄名单。此处显示工件pom中可用的项目邮件列表。6.下载。单击此链接会将工件下载到本地计算机。7.查看工件内容。单机此链接可以远程到远程上查看工件内容下载工件可以从工件信息页面下载工件，下载框中提供了与工件关联的所有文件（metadata.xml文件除外），文件大小（以字节为单位）显示在下载框的右侧。注意：下载工件后，系统会要求您输入用于下载工件的存储库的用户名和密码。只有具有该存储库的GlobalRepositoryManager，RepositoryManager或RepositoryObserver角色的用户才能下载该工件。元数据在1.4版本后，引入了新的存储库API或“元数据存储库”。元数据存储库的基本功能之一，能够通过添加有关项目的通用信息（如评级，注释等）存储在元数据存储库的项目属性文件中。只有具有工件所在的存储库的RepositoryManager角色的用户才能通过工件浏览中的元数据选项卡添加或删除元数据中的属性。要在元数据中添加属性，只需在相应的文本字段中指定“

属性名称”和“

属性值”，然后单击“

添加”。要删除属性，只需单击要删除的特定属性的相应删除图标（X）。“成功删除”

成功删除后应显示消息。搜索Archiva的搜索功能允许用户在存储库中搜索特定的工件。索引在Archiva中搜索工件之前，需要先将它们编入索引。以下动作可以创建Aritfacts索引：扫描存储库时在工具库中添加或上载工件时从远程存储库代理或下载工件时当远程索引可用并下载时在存储库扫描期间，index-content使用者（请参阅使用者）创建索引任务并将其排入索引任务队列中。此索引任务又由任务执行程序执行，而这正是实际索引发生的位置。当工件添加在Archiva存储库中或从远程存储库代理时，也会创建类似的索引任务并排队。可以搜索什么？可以在“存储库扫描”页面的“

RepositoryScanning-FileTypessection”（indexable-content）中配置在存储库扫描期间编制索引的存储库文件。默认情况下，可索引内容文件类型为：**/*.txt**/*.TXT**/*.block**/*.config**/*.pom**/*.xml**/*.xsd**/*.dtd**/*.tld快速搜索存储库中和上述配置匹配的所有文件内容将在存储库扫描期间编制索引。因此，当您在搜索框中键入单词时，Archiva将在索引中搜索该查询字符串，并以分页的工件列表的形式返回所有搜索。对于包含空格的查询字符串，Archiva搜索包含空格的查询字符串。因此，如果您输入'commonslogging'，搜索结果将包含引用'commonslogging'的工件列表，该工件仍由空格分隔。在这种情况下，“commons-logging”（连字符分隔）不包含在搜索结果中。Archiva还可以在索引中搜索java类，包和方法，并返回包含查询字符串的工件列表。在以前的版本中，我们需要在搜索框中的查询字符串之前附加关键字'bytecode：'（如'bytecode：myMethod'）。只需在搜索框中键入java类或包名称即可！您可以使用各种标准来搜索工件：简单查询字符串高级参数OSGI参数搜索结果您可以在搜索结果中应用各种过滤器。以下是搜索结果的示例屏幕截图：当用户单击搜索结果列表中的特定工件时，Archiva将引导用户进入工件信息页面（存储库浏览中的同一页面）。否则，如果它不是pom文件（例如metadata.xml），则该文件将显示为要从浏览器下载的文件。删除工件删除神器删除工件功能允许从托管存储库中删除groupId或工件。用户必须具有存储库管理器角色才能从中删除工件。要删除工件，您只需浏览到要删除的内容即可删除groupId在要删除的groupId附近使用垃圾桶图标删除工件浏览到工件的详细视图，转到工件选项卡，然后删除带有垃圾图标的工件配置Maven2以使用Archiva存储库要使本地Maven2安装使用Archiva代理，您需要将所需的存储库添加到'settings.xml'。此文件通常位于${user.dir}/config/settings.xml中仅使用Archiva如果您希望Archiva作为Maven安装使用的唯一存储库，您可以使用Maven镜像设置来强制执行此行为。首先，您需要通过将以下内容添加到settings.xml文件来选择未配置的默认存储库：<settings><!--omittedxml--><mirrors><mirror><id>archiva.default</id><url>:8080/repository/internal/</url><mirrorOf>external:*</mirrorOf></mirror></mirrors><!--omittedxml--></settings>有了这个，所有存储库请求将被发送到内部存储库（默认情况下配置为代理中央存储库）。如果您希望使用单独的Archiva存储库，则可以根据需要添加额外的镜像声明：<!--omittedxml--><mirror><id>archiva.apache.snapshots</id><url>:8080/repository/snapshots/</url><mirrorOf>apache.snapshots</mirrorOf></mirror><!--omittedxml-->使用Archiva作为附加存储库您需要为Archiva中设置的每个存储库添加一个条目。如果您的存储库包含插件;

记得还要包含一个<pluginRepository>设置。创建新的配置文件以设置存储库<settings><!--omittedxml--><profiles><profile><id>RepositoryProxy</id><activation><activeByDefault>true</activeByDefault></activation><!--*******************************************************--><!--repositoriesforjarartifacts--><!--*******************************************************--><repositories><repository><!--omittedxml--></repository><!--omittedxml--></repositories><!--*******************************************************--><!--repositoriesformavenplugins--><!--*******************************************************--><pluginRepositories><pluginRepository><!--omittedxml--></pluginRepository><!--omittedxml--></pluginRepositories></profile><!--omittedxml--></profiles><!--omittedxml--></settings>2将存储库配置添加到配置文件您可以从Archiva管理页面上的POM代码段复制存储库配置以获取常规存储库。：<repository><id>repository-1</id><url>:8080/repository/internal/</url><releases><enabled>true</enabled></releases><snapshots><enabled>false</enabled></snapshots></repository>3添加必要的安全配置仅当来宾帐户没有给定存储库的读访问权时，才需要这样做。<settings><!--omittedxml--><servers><server><id>repository-1</id><username>{archiva-user}</username><password>{archiva-pwd}</password></server><!--omittedxml--></servers><!--omittedxml--></settings>添加工件到到存储库中如何在Archiva存储库中添加工件。Maven配置：通过Maven添加到Archiva存储库网页UI：通过WebUI形式添加通过Maven添加到Archiva存储库在Archiva中创建用户以进行添加设置用户角色：'RepositoryManager'到目标存储库在“settings.xml”中服务器，使用用户进行身份验证<settings><!--omittedxml--><servers><server><id>ernal</id><username>{archiva-deployment-user}</username><password>{archiva-deployment-pwd}</password></server><server><id>archiva.snapshots</id><username>{archiva-deployment-user}</username><password>{archiva-deployment-pwd}</password></server><!--omittedxml--></servers><!--omittedxml--></settings>使用HTTP添加Archiva配置pom.xml的distributionManagement部分（根据需要自定义URL）。该ID在资源库中的distributionManagement

必须匹配服务器settings.xml中的ID信息。<project><!--omittedxml--><distributionManagement><repository><id>ernal</id><name>InternalReleaseRepository</name><url>:8080/repository/internal/</url></repository><snapshotRepository><id>archiva.snapshots</id><name>InternalSnapshotRepository</name><url>:8080/repository/snapshots/</url></snapshotRepository></distributionManagement><!--omittedxml--></project>使用WebDAV添加到Archiva在某些情况下，您可能希望使用WebDAV而不是HTTP来添加。执行以下附加步骤：将dav：添加到添加URL的前面：<project><!--omittedxml--><distributionManagement><repository><id>ernal</id><name>InternalReleaseRepository</name><url>dav::8080/repository/internal/</url></repository><snapshotRepository><id>archiva.snapshots</id><name>InternalSnapshotRepository</name><url>dav::8080/repository/snapshots/</url></snapshotRepository></distributionManagement><!--omittedxml--></project></项目>在pom.xml中添加构建扩展（Maven2.0.9及更高版本中不需要）<project><!--omittedxml--><build><extensions><extension><groupId>org.apache.maven.wagon</groupId><artifactId>wagon-webdav-jackrabbit</artifactId><version>2.2</version></extension></extensions></build><!--omittedxml--></project>使用Maven将第三方工件添加到Archiva您可以使用mvndeploy：deploy-file将单个工件添加到Archiva。如上所述，如果您具有设置文件，则可以使用以下类型的命令添加工件：mvndeploy:deploy-file-Dfile=filename.jar-DpomFile=filename.pom-DrepositoryId=ernal-Durl=:8080/repository/internal/如果您希望使用WebDAV添加文件，请将dav：添加到URL的开头，如前面的说明中所述。但是，在2.0.9之前的Maven版本上，您还需要在要执行“

mvndeploy：deploy-file

”

的目录中创建一个名为pom.xml

的文件：<project><modelVersion>4.0.0</modelVersion><groupId>com.example</groupId><artifactId>webdav-deploy</artifactId><packaging>pom</packaging><version>1</version><name>WebdavDeploymentPOM</name><build><extensions><extension><groupId>org.apache.maven.wagon</groupId><artifactId>wagon-webdav-jackrabbit</artifactId><version>2.2</version></extension></extensions></build></project>此pom不会与工件一起添加，它只是用于使WebDAV协议可用于构建过程。或者，您可以将此文件保存在其他位置，并使用“

mvn...-f/path/to/filename

”强制使用备用POM文件。通过WebUI表单进行添加在存储库中添加的最简单方法是通过WebUI表单，可以在UploadArtifact部分中访问。只需按以下步骤操作：在Archiva中，单击左侧菜单中的UploadArtifact选项。填写以下必填字段：GroupId-要添加的工件的groupId。工件ID-要添加的工件的artifactId。版本-要添加的工件的版本。包装-要添加的工件的后缀。（例如jar,war,ear,etc）拖放要添加的文件。选择要添加到的存储库。请注意，如果您没有对存储库的写入权限，则不允许在其上进行添加。现在，如果您希望Archiva为工件生成pom，请选中GenerateMaven2POM字段。（现在，只能生成Maven2poms。）或者，提供要与工件一起添加的POM文件。单击“保存文件”，将显示一条消息，通知您上载/添加是否成功。这些是添加后将在您的存储库中的文件：工件POM文件maven-metadata.xml（如果工件级别中不存在，则会创建，否则只会更新）maven-metadata.xml.sha1和maven-metadata.xml.md5（这些将为新创建的maven-metadata.xml文件生成，否则它们将被更新）s配置虚拟存储库虚拟存储库（或存储库组）的主要优点是，如果使用多个代理存储库，则只需指定一个URL而不是多个存储库URL例如，您在settings.xml中具有以下配置：<settings><!--omittedxml--><profiles><profile><id>RepositoryProxy</id><activation><activeByDefault>true</activeByDefault></activation><repositories><repository><id>internal.releases</id><url>http://localhost:8080/repository/internal.releases/</url><releases><enabled>true</enabled></releases><snapshots><enabled>false</enabled></snapshots></repository><repository><id>third.party.repo</id><url>http://localhost:8080/repository/third.party.repo/</url><releases><enabled>true</enabled></releases><snapshots><enabled>false</enabled></snapshots></repository><repository><id>snapshots</id><url>http://localhost:8080/repository/snapshots/</url><releases><enabled>false</enabled></releases><snapshots><enabled>true</enabled></snapshots></repository></repositories></profile><!--omittedxml--></profiles><!--omittedxml--></settings>如果您在Archiva中配置了虚拟存储库，则只需在settings.xml中对其进行配置：<settings><!--omittedxml--><profiles><profile><id>RepositoryProxy</id><activation><activeByDefault>true</activeByDefault></activation><repositories><repository><id>internal.releases</id><url>http://localhost:8080/repository/[repository_group_id]/</url></repository></repositories></profile><!--omittedxml--></profiles><!--omittedxml--></settings>而且你仍然可以获得所需的所有工件。有关如何在Archiva中设置虚拟仓库的步骤，请参阅配置虚拟仓库部分。配置虚拟存储库以下是设置虚拟存储库的步骤：在webapp中，转到RepositoryGroups页面。要创建虚拟存储库或存储库组，请转到添加选项卡要添加存储库，请拖放可用的存储库。现在，将虚拟存储库URL

http://[host]:[port]/repository/[repository_group_id]/到settings.xml中，方法与配置常规存储库相同-作为镜像或作为附加存储库。如果该组下的存储库是安全的，您还必须在settings.xml中设置Archiva登录凭据。请注意，服务器标识应与存储库组标识符匹配。RSS订阅订阅地址：http：//[hostname]：[port]/feeds/[repositoryId]订阅Feed有两种方法：1.复制上面指定的默认网址并将其添加到您的Feed阅读器。只需确保替换hostname，port和repositoryId。该repositoryId是要监视repositoryId。2.通过“存储库”页面中的“源”图标。右键单击存储库配置的源图标并复制该链接。然后将此链接添加到您的Feed阅读器。工件的新版本Feed的默认URL：http：//[hostname]：[port]/feeds/[groupId]/[artifactId]您可以按照NewArtifactsInRepository部分中指定的方式订阅feed，但在＃1中，您需要指定groupId和artifactId而不是repositoryId。在＃2中，您需要转到“浏览”部分。rssfeed图标位于artifactId级别。认证用于rss提要的身份验证方法是Http基本身份验证。如果您的阅读器支持此功能，则在订阅源时会提示您输入用户名和密码。为此提供您的Archiva帐户凭据。请注意，只有具有特定存储库的Observer角色的用户才能订阅此Feed。如果为存储库启用了“访客”帐户，则在订阅源时将不再要求您输入用户名和密码。查询Artifacts查询格式wget"http://localhost:9091/archiva/restServices/archivaServices/searchService/artifact?g=org.apache.archiva&a=archiva-model&v=LATEST"查询参数：g=groupId（必填）a=artifactId（必填）v=版本（或LATEST关键字）（必填）r=存储库（可选，如果没有搜索可供当前用户读取的所有存储库）管理员指南用户安全管理管理Archiva用户Archiva使用Redback安全框架来管理存储库安全性。首次启动服务器时，系统将提示您创建管理用户。该用户将被授予管理系统所有方面的权限（以及对所有存储库的访问权限）。然后，可以使用此用户向其他用户授予权限。默认情况下还会创建guest用户，并授予对默认存储库（内部和快照）的读访问权限。无需使用用户名和密码（或未登录Web界面）即可访问具有访客用户访问权限的存储库。管理用户ui提供了一个管理用户的操作。如下：删除用户编辑用户阻止用户强制用户在下次登录时更改密码用户版用于管理用户用于管理用户角色用户注册注意：您可以使用UI配置禁用用户注册用户可以使用ui注册填写登记表角色管理Archiva包含以下存储库访问角色：存储库观察者：具有此角色的用户可以从给定存储库中读取该角色的用途（包括通过Web界面的浏览和搜索功能进行访问）存储库管理器：具有此角色的用户可以写入和管理该角色所针对的给定存储库GlobalRepositoryObserver：具有此角色的用户可以从任何存储库读取（包括通过Web界面的浏览和搜索功能进行访问）GlobalRepositoryManager：具有此角色的用户可以写入和管理实例中的任何存储库角色列表角色详情将用户附加到角色一般角色Archiva还包含以下实例安全性的一般角色：系统管理员：完全访问系统中的所有功能用户管理员：能够为系统中的其他用户创建，编辑和授予角色来宾和注册用户角色不会影响存储库访问。Archiva系统配置存储库基本信息Archiva有两种类型的存储库配置：托管存储库和远程存储库。托管存储库托管存储库是一个存储库，它本地驻留在运行Archiva的服务器上。它可以充当代理存储库，内部部署存储库或本地镜像存储库。托管存储库字段：ID存储库的标识符。这必须是独一无二的。Name存储库的名称。这是显示名称。Directory存储库的位置。如果指定的路径不存在，Archiva将创建缺少的目录。IndexDirectoryArchiva生成的索引文件的位置。如果未指定位置，则将在存储库目录的根目录中创建索引目录（名为.indexer）。此目录包含由索引的不同使用者（如M2Eclipse）使用的打包/捆绑索引。Type存储库布局（maven2或maven1）CronExpression执行存储库扫描时的cron计划。DaysOlder存储库清除的第一个选项。Archiva将检查工件的年龄，如果它超过此字段中设定的天数，则工件将根据当然的保留计数被删除。为了按天数禁用清除并将Archiva设置为按保留计数清除，只需将存储库清除字段设置为0.此处可以设置的最大天数为1000.有关详细信息，请参阅下面的“存储库清除”部分。细节。RetentionCount存储库清除的第二个选项。运行存储库清除时，Archiva将仅保留为此特定快照版本的此字段设置的工件数。有关详细信息，请参阅下面的“存储库清除”部分。Description有关存储库的其他信息。Releases指定存储库中是否存在已发布的工件。Snapshots指定存储库中是否存在快照工件。BlockRedeployments指定是否可以覆盖存储库中已存在的已发布工件。请注意，这仅对非快照部署产生影响。Scanned指定是否可以扫描存储库，这意味着它是一个应该被索引，清除等的本地存储库。DeleteReleasedSnapshots指定在存储库清除期间是否删除已在存储库中具有其发行版本的快照工件。StagingRepository自动为此本地存储库创建阶段存储库。SkipPackedIndexCreation避免为IDE使用创建压缩索引。每个存储库都有自己的http（s）/webdavurl。这允许用户通过http（s）/webdav浏览和访问存储库。该网址具有以下格式：http：//[URLTOARCHIVA]/repository/[REPOSITORYID]（例如http：//localhost：8080/repository/releases）。每个存储库也可以使用pom片段。可以将<distributionManagement>部分复制并粘贴到项目的pom中，以指定项目将部署在该托管存储库中。另一方面，<repositories>部分可以复制并粘贴到项目的pom.xml或Maven的settings.xml中，以告知Maven在构建项目时从托管存储库中获取工件。远程存储库远程存储库是远程驻留的存储库。这些存储库通常是代理存储库。请参阅代理连接器，了解如何代理存储库。远程存储库字段：ID远程存储库的标识符。名称远程存储库的名称。网址远程存储库的URL。也可以使用'file：//'url来代理本地存储库。请注意，如果此本地存储库是archiva的托管存储库，其中包含一些代理连接器，则不会触发这些连接器。用户名用于访问存储库的用户名（如果需要身份验证）。密码用于访问存储库的密码（如果需要身份验证）。下载超时从远程存储库下载停止的时间（以秒为单位）。类型远程存储库的布局（maven2或maven1）。下载远程索引激活下载远程索引以在搜索查询中添加可用的远程工件。远程索引URL可以相对于Url-远程索引目录的路径。Cron表达示下载远程索引的Cron表达式（周日默认每周）索引目录存储索引目录的路径，默认为${appserver.base}/data/remotes/${repositoryId}/。indexer下载远程索引超时以秒为单位的时间，之后将停止下载远程索引文件（默认为300）。远程下载索引代理用于下载远程索引文件的代理。在启动时下载远程索引如果选中，远程索引将在Archiva启动时下载。描述可用于存储有关存储库的其他信息。连接检查路径如果设置，则通过验证给定文件/工件的存在来检查与远程存储库的连接。某些存储库不允许浏览基目录，标准检查可能会失败。该路径相对于存储库Url。附加URL参数查询远程存储库时要添加到url的键/值对。附加Http标头在查询远程存储库时添加为http标头的键/值对。您还可以触发立即下载远程索引文件。来自远程存储库的Maven索引从1.4-M4开始：如果您已经配置了下载远程索引，那么这些文件（MavenIndexer项目格式）将在路径http：//[URLTOARCHIVA]/repository/id/.index中提供（您可以使用这些文件IDE）扫描存储库存储库扫描可以按计划执行，也可以通过单击存储库页面中的“立即扫描存储库”按钮显式执行。默认情况下，Archiva仅处理存储库中与存储库扫描程序的最后一次运行相关的新工件。这意味着如果工件的上次修改日期比上次存储库扫描更新，则将处理工件。否则，它将被跳过。您可以覆盖此行为，并通过勾选存储库页面中的“处理所有工件”复选框并单击“立即扫描存储库”按钮，强制Archiva处理所有工件，而不管其年龄。对于存储库扫描程序找到的每个工件，不同的使用者都会对此工件进行处理。完成的处理示例包括：索引，存储库清除和数据库更新。消费者页面中提供了有关消费者的详细信息。存储库清除存储库清除是清理旧快照存储库的过程。将快照部署到存储库时，Maven会使用带时间戳的版本部署项目/工件。执行项目的每日/每晚构建然后往往会使存储库膨胀。如果神器很大怎么办？那么磁盘空间肯定是个问题。这就是Archiva的存储库清除功能的用武之地。根据使用的标准-按旧天数和保留计数，它将通过删除旧快照来清理存储库。请注意，默认情况下会激活旧标准天数（设置为100天）。为了取消激活它并使用按保留计数条件，您必须将存储库清除按天更旧的字段设置为0.此处需要注意的是，如果激活了旧标准天数，则保留计数将为仍然受到尊重（有关更多详细信息，请参阅下面的RepositoryPurgeByDaysOlder部分），但不是相反。让我们看看使用以下场景的存储库清除的不同行为：存储库中的工件：../artifact-x/2.0-SNAPSHOT/artifact-x-20061118.060401-2.jar../artifact-x/2.0-SNAPSHOT/artifact-x-20061118.060401-2.pom../artifact-x/2.0-SNAPSHOT/artifact-x-20070113.034619-3.jar../artifact-x/2.0-SNAPSHOT/artifact-x-20070113.034619-3.pom../artifact-x/2.0-SNAPSHOT/artifact-x-20070203.028902-4.jar../artifact-x/2.0-SNAPSHOT/artifact-x-20070203.028902-4.pom存储库清除按较旧的天数使用此标准进行清除，Archiva将检查工件的年龄，如果它早于存储库清除旧日期字段中的设置值，则工件将被删除，当然保留计数。如果将旧版本的存储库清除设置为100天（存储库清除按保留计数字段设置为1），并且当前日期为03-01-2007，则给定上面的方案..将保留以下工件：artifact-x-20070113.034619-3.jar，artifact-x-20070113.034619-3.pom，artifact-x-20070203.028902-4.jar和artifact-x-20070203.028902-4.pom。在版本时间戳中很明显，这4个工件从当前日期开始不超过100天（在我们的示例中为03-01-2007），因此它们都被保留。在这种情况下，保留计数没有任何影响，因为优先级是工件的年龄。现在，如果将更早的存储库清除设置为30天（存储库清除按保留计数字段仍设置为1）并且当前日期仍为03-01-2007，则给出上述相同的方案..仅以下工件将被保留：artifact-x-20070203.028902-4.jar和artifact-x-20070203.028902-4.pom。在这种情况下，我们可以看到保留的工件仍然没有在存储库中按天数较早的字段设置的天数较旧，并且仍然满足保留计数。现在，让我们将存储库清除设置为10天之前的日期（存储库清除保留计数字段仍设置为1），当前日期仍为03-01-2007，然后仍然给出上面相同的存储库内容..以下工件仍将保留：artifact-x-20070203.028902-4.jar和artifact-x-20070203.028902-4.pom。从版本时间戳中可以清楚地看出，工件比存储库清除了更旧的旧值，即10天。为什么它仍然保留？通过保留计数回忆存储库清除的值-1:)这可确保为工件的每个唯一版本快照目录保留总共1个工件时间戳版本。存储库按保留计数清除如果存储库清除保留计数字段设置为2，则只有工件artifact-x-20070113.034619-3.jar，artifact-x-20070113.034619-3.pom，artifact-x-20070203.028902-4.jar和artifact-x-20070203.028902-4.pom将保留在存储库中。将删除最旧的快照，仅保留相当于设置保留计数的许多快照（无论工件的新旧程度如何）。删除已发布的快照您还可以配置Archiva以清除已发布的快照工件。这可以通过勾选RepositoryConfiguration窗体中的DeleteReleasedSnapshots复选框来完成。启用此功能后，如果Archiva在存储库扫描期间遇到快照工件，它将检查为该快照的已发布版本配置的所有存储库。如果找到一个，则会删除整个快照版本目录。应该注意的是，此功能完全独立于存储库清除旧天数和保留计数。ApacheArchiva的代理连接器配置Archiva将术语“代理”用于两个不同的概念：远程存储库代理缓存，通过存储库之间的代理连接器配置网络代理，是传统的基于协议的代理（主要用于通过防火墙对远程存储库进行HTTP访问）代理连接器用于将托管存储库（存储在Archiva机器上）链接到远程存储库（通过URL访问）。这将意味着当托管存储库收到请求时，将查询连接器以决定是否应该从远程存储库请求资源（并且可能在本地缓存结果以用于将来的请求）。每个托管存储库都可以代理多个远程存储库，以允许通过Archiva实例内的单个接口对存储库进行分组。例如，通常通过Archiva的单个存储库代理所有远程版本，以及为所有远程快照存储库代理单个快照存储库。基本代理连接器配置只是将远程存储库链接到托管存储库（使用可选的网络代理通过防火墙进行访问）。但是，代理连接器可以专门管理不同类型的工件和路径的行为，以便更灵活地控制对远程存储库的访问。代理连接器代理连接器列表配置订单您可以使用拖放操作配置存储库顺序配置策略从托管存储库请求工件并配置代理连接器时，首先会查询连接器的策略，以决定是否检索和缓存远程工件。应用哪些策略取决于工件的类型。默认情况下，Archiva提供以下政策：发布

-如何处理已发布的工件元数据（未携带SNAPSHOT版本的元数据）。这可以设置为始终（默认），每小时，每天，一次和从不。快照

-如何处理快照工件元数据（带有SNAPSHOT版本的元数据）。这可以设置为始终（默认），每小时，每天，一次和从不。校验和

-从远程存储库下载工件时如何处理不正确的校验和（即工件的校验和与相应的分离校验和文件不匹配）。选项是使远程工件的请求失败，动态修复校验和（默认），或者只是忽略不正确的校验和缓存失败

-是否应缓存检索远程工件的失败（为丢失或错误的工件保存网络带宽）或缓存（默认）。返回错误

-如果远程代理导致错误，此选项确定是否应返回现有工件（当工件尚未存在时出错），或者无论（总是）传递错误。远程错误

-如果遇到远程错误，stop会导致错误立即返回，队列错误将在首先检查其他成功的远程存储库后返回所有错误，而ignore将忽略任何错误。配置白名单和黑名单默认情况下，如果策略通过，则对托管存储库的所有工件请求都将通过代理连接器代理到远程存储库。但是，为给定的远程存储库配置白名单和黑名单可能更有效，这些存储库与要检索的预期工件相匹配。如果仅配置了白名单，则将拒绝所有与白名单元素不匹配的请求。相反，如果仅配置了黑名单，则将接受与所列入黑名单元素之一不匹配的所有请求（而这些匹配将被拒绝）。如果同时定义了白名单和黑名单，则必须在白名单中列出路径，而不是在要接受的黑名单中-所有其他请求都将被拒绝。白名单或黑名