一、概述
本地存储库是本地管理的物理存储库,您可以在其中部署制品。使用本地存储库,Artifactory 为您提供了一个中心位置来存储您的内部二进制文件。通过存储库复制,您甚至可以与位于远程位置的团队共享二进制文件。
可以使用以下 URL 直接访问本地存储库中的制品:
http://<host>:<port>/artifactory/<local-repository-name>/<artifact-path>
二、配置本地存储库位置
要配置本地存储库,请在管理模块中转到Repositories,选择Local选项卡,然后单击Add Repository,然后选择Local Repositories。
三、通用基础设置
一些设置对于本地、远程和虚拟存储库是通用的。这些可以在相应的Basic选项卡中找到。根据为存储库指定的包类型,可以在特定于类型的部分中找到其他设置。
包类型 | 包类型。这必须在创建存储库时指定,并且一旦设置,就不能更改。 |
存储库密钥 | 存储库密钥。存储库的强制标识符,必须是唯一的。它不能以数字开头,也不能包含空格或特殊字符。对于本地存储库,我们建议使用“-local”后缀(例如“libs-release-local”)。 |
环境 | 将存储库分配给选定的环境。环境用于聚合项目资源以简化其管理。只能选择一个环境。 |
存储库布局 | 设置存储库应该用于存储和识别模块的布局。建议与定义的包类型相对应的推荐布局,并索引包上传并相应地计算元数据。 |
公开说明 | 描述存储库内容和用途的自由文本字段。 |
内部说明 | 一个自由文本字段,用于添加有关存储库的附加说明。这些仅对管理员可见。 |
包含和排除模式 | Include Patterns和Exclude Patterns 字段提供了一种在尝试解析不同制品的位置时过滤掉特定存储库的方法。 在每个字段中,您可以指定一个类似 Ant 的模式列表以过滤和过滤制品查询。过滤的工作原理是从包含的模式(默认为全部)中减去排除的模式(默认为无)。 |
在 Xray 中启用索引 | 在存储库上启用索引以进行安全性和合规性分析。可用于JFrog Xray。 |
四、特殊设置
特定的存储库可能有特定的设置,具体取决于包类型。
以Maven为例:
唯一快照最大数量 | 根据存储库布局,指定应存储的同一制品的唯一快照的最大数量。一旦达到此数量并上传新快照,最旧的存储快照将自动删除。 值 0(默认值)表示对唯一快照的数量没有限制。 |
处理发布 | 如果设置,Artifactory 允许您将发布制品部署到此存储库中。 |
处理快照 | 如果设置,Artifactory 允许您将快照制品部署到此存储库中。 |
校验和策略 | 检查校验和可以有效地验证已部署资源的完整性。Checksum Policy确定当已部署资源的客户端校验和丢失或与本地计算的校验和冲突时 Artifactory 的行为方式。 有两种选择: 1.验证客户端校验和(默认)- 如果客户端没有为已部署的制品发送有效校验和,那么Artifactory将向尝试访问该校验和的客户端返回 404(未找到)错误。如果客户端已发送校验和,但它与服务器上计算的校验和冲突,则Artifactory将返回409(冲突)错误,直到部署有效的校验和。 2.信任服务器生成的校验和 - Artifactory不会验证客户端发送的校验和,并且会信任服务器在本地计算的校验和。上传的制品立即可供使用,但完整性可能会受到损害。 |
Maven 快照版本行为 | Artifactory支持集中控制如何将快照部署到存储库中,而不管最终用户特定的设置如何。这可用于保证组织内已部署快照的标准化格式。共有三个选项: 1.唯一:使用唯一的、基于时间的版本号。 2.非唯一:使用默认的自我覆盖命名模式:artifactID-version-SNAPSHOT.type 3.部署者:按原样使用部署者发送的格式。 部署者参数选项 选择 Deployer选项时不会生成元数据。设置复制时不应使用此选项,因为每个Artifactory实例都需要在本地生成其元数据。 4.Maven 3仅支持唯一快照 Maven 3已经放弃了对解析和部署非唯一快照的支持。因此,如果您有一个使用非唯一快照的快照存储库,我们建议您将Maven快照策略更改为“唯一”,并从此存储库中删除任何以前部署的快照。 Maven客户端在部署时生成的唯一快照名称无助于识别构建快照的源代码控制更改,并且与检出源的时间无关。因此,我们建议制品本身应该嵌入修订/标签(作为其名称的一部分或内部),以便清晰可见的修订跟踪。Artifactory 允许您使用修订号标记制品作为其构建集成支持的一部分。 |
抑制 POM 一致性 | groupId:artifactId:version将制品部署到存储库时,Artifactory会验证POM中设置的值是否与部署路径一致。 如果这些之间存在冲突,那么Artifactory将拒绝部署。您可以通过设置此复选框来禁用此行为。 |
五、高级设置
优先级解析 | 在解析虚拟存储库时,设置优先级解析优先于解析顺序。设置存储库优先级将导致仅从使用该字段设置的存储库中合并元数据。如果在这些存储库中未找到包,Artifactory将合并未使用Priority Resolution字段设置的存储库中的元数据。 适用于除 Chef、CocoaPods、Debian、Git LFS、Opkg、Rust、Vagrant和VCS存储库之外的所有存储库类型。 有关此功能的包支持的更多信息,请参阅Artifactory 发行说明。 |
黑屏 | 如果设置,Artifactory在尝试解析制品时会忽略此存储库。该存储库也不可用于下载或部署制品。 |
允许内容浏览 | 设置后,允许 Artifactory用户浏览档案的内部内容(例如,从 Javadoc 档案中浏览特定的Javadoc文件)。 当允许浏览档案时,应采用严格的内容审核以确保恶意用户不会上传可能危及安全的内容(例如跨站点脚本攻击) |
启用 CDN 下载 | 启用对此存储库的CDN下载请求将重定向客户端以直接从AWS CloudFront下载文件。支持Enterprise+ 和Enterprise许可证。 |