JFrog帮助中心

我们的新门户即将推出!
文档+知识库





JFrog帮助中心-新的知识体验即将到来!



概述

Artifactory通过支持直接使用的本地存储库,将高级工件管理引入C/ c++世界柯南客户端来管理Conan包和依赖项。作为一个存储库,Artifactory为使用Conan的C/ c++开发人员提供了许多好处:

  1. 针对C/ c++包的安全私有存储库,根据项目或开发团队提供细粒度的访问控制
  2. 自动布局和存储C/ c++包为所有平台配置在柯南客户端
  3. 能够从本地存储库向Conan命令行工具提供来自Artifactory的C/ c++依赖项。
  4. 企业特性,如高可用性、多站点开发的存储库复制、大规模可伸缩存储的不同选项。

有关构建Conan包和使用Conan客户端的更多详细信息,请参阅柯南的文档

Artifactory Community Edition for C/ c++

在Artifactory CE中可以获得Conan存储库。

>了解更多

从Xray 3.21.2及以上版本开始,Xray可以扫描柯南包,更多信息请参见Conan和C/ c++在Xray中的支持



配置

局部存储库

要启用C/ c++包元数据的计算,政府模块,选择存储库|知识库|本地并设置柯南成为包类型创建本地存储库时。

确保也选择conan-default作为存储库布局。

页面内容




远程存储库

弃用的通知

一个远程存储库Artifactory中定义的作为在远程URL上管理的注册中心的缓存代理,例如https://center.conan.io,甚至是由Artifactory的另一个实例在远程站点上管理的Conan存储库。

从远程存储库请求的Conan包将按需缓存。您可以从远程存储库缓存中删除Conan包,但是,您不能手动将Conan文件推送到远程Conan存储库。

要定义一个远程存储库来代理远程存储库,请遵循以下步骤:

  1. 政府模块,在存储库|存储库|远程,点击新建远程存储库
  2. 在New Repository对话框中,设置包类型柯南,设置库的关键中指定远程存储库的URLURL字段,如下所示。

解析柯南远程包

要解析Conan远程包,请将远程存储库聚合到虚拟存储库中,因为它们不能直接从远程存储库中解析。

虚拟存储库

一个虚拟存储库Artifactory中定义的集合了包含在虚拟存储库中的本地和远程存储库中的Conan包。使用虚拟存储库非常有用,因为用户将继续使用虚拟存储库,而管理员可以管理包含的存储库,替换默认部署目标,并且这些更改对用户是透明的。

按照以下步骤定义虚拟柯南存储库:

  1. 创建一个新的虚拟存储库政府模块,在存储库|知识库|虚拟,点击新建虚拟存储库并设置柯南随着包类型
  2. 设置库的关键价值。

  3. 选择要包含的基础本地和远程Conan存储库存储库部分。
  4. 您还可以选择配置您的默认部署存储库



与Artifactory一起使用柯南

一旦安装了Conan客户机,您就可以通过Artifactory的命令行界面访问Conan存储库。您只能使用Conan客户端从您的Artifactory本地Conan存储库安装包或将包导出。

本地vs远程

不要让柯南的术语迷惑了你。出于集成的目的,Conan“Remote”实际上是您为Conan包创建的Artifactory本地存储库。

创建了Conan存储库之后,在Tree Browser视图i中选择它n的应用程序模块,Artifactory|工件选项卡,并点击帮我介绍t查看将存储库用作安装包的源和导出的目标所需的代码片段。

在下面的部分中,用于表示您设置的逻辑名称,Conan客户端可以使用该名称识别Artifactory中的Conan本地存储库。

添加存储库

要将本地存储库与柯南一起使用,首先需要将其作为柯南“远程”添加到客户端,如下所示:

conan remote add < remote > http:///api/conan/

地点:

库的关键

Conan存储库必须在路径中以api/ Conan作为前缀

当通过Artifactory访问Conan存储库时,存储库URL必须以api /柯南在小路上。这适用于柯南的所有命令,包括柯南安装

例如,如果您使用Artifactory独立或作为本地服务,您将使用以下URL访问您的Conan存储库:

http://localhost:8081/artifactory/api /柯南/<库关键>

或者,如果您正在使用Artifactory Cloud, URL将是:

https:// < server name > .jfrog.io / artifactory /api /柯南/<库关键>

验证柯南客户端

要向Artifactory验证Conan客户端,您需要使用以下命令登录:

conan user -p  -r  

匿名访问Artifactory

如果Artifactory配置为匿名访问,您可以跳过验证柯南客户端。

允许匿名访问

Artifactory支持Conan存储库允许匿名访问启用。

允许匿名访问, Artifactory默认情况下不会查询Conan客户端以获取身份验证参数,因此您需要向Artifactory指示以不同的方式请求身份验证参数。

属性可以覆盖默认行为力身份验证复选框中的新建或编辑存储库y对话框。

设置后,Artifactory将首先从Conan客户机请求身份验证参数,然后再尝试访问此存储库。

安装依赖关系

中定义的从Artifactory安装依赖项conanfile.txt文件使用:

柯南安装。- r <远程>

上传包

要将包上传到您的Artifactory本地Conan存储库,请使用:

柯南上传 -r ——all

其中指定您的柯南配方引用格式为/@/


查看单个柯南包信息

Artifactory允许您直接从UI中查看Conan包的选定元数据。

应用程序模块,Artifactory|工件选项卡,树浏览器,向下钻取以选择要检查的包文件。元数据显示在柯南的信息选项卡。显示的具体信息取决于您所选择的树项。选择包的根项将显示用于上传包的Conan配方的详细信息。

如果您选择其中一个包,您将获得详细的柯南包信息,包括设置选项依赖关系(”需要”)


柯南V2包支持

支持柯南服务器API v2并介绍了二进制布局的扩展来支持柯南套餐修订修订允许您在保持相同的Conan引用和预期的情况下更改工件通过防止数据在服务器上被覆盖来实现包的不变性。
这个例子展示了带有"9999”作为“1”是Recipe Revision“4”为“包修订”

用户/ lib / 1.0 /通道/ 1 /包/ 9999/4 / *

修订支持柯南客户端

当Revision功能被启用时,Conan客户端根据引用在Artifactory中搜索最新版本,除非用户另有指定。升级您的conan客户端版本以使用Artifactory 6.9并不是强制性的,但是如果您想使用修订版本,则需要下载启用修订模式的conan客户端1.13。

默认情况下,Conan客户端根据引用在Artifactory中搜索最新版本,除非用户另有指定。

柯南包V1向后兼容性

Artifactory 6.9.0通过自动将柯南服务器API v1二进制布局迁移到新格式,为使用柯南服务器API v1创建的包提供向后兼容性。
升级过程完成后(所有节点为高可用性),所有Conan API端点被阻塞,无法访问,开始向柯南服务器API V2迁移。
迁移之后,对于Recipe修订和Package修订,所有Conan服务器API v1包的默认修订都被设置为“0”,端点将再次可以访问。

默认情况下,两个线程专用于迁移作业。在从以前的版本升级到Artifactory 6.9之前,您可以在美元JFROG_HOME / artifactory / etc / artifactory.system.properties文件(JFROG_HOME美元/ artifactory / var / etc / artifactory / artifactory.system.properties如果修改7.x)。
注意,您可以在迁移过程中分配更多线程,但需要重新启动Artifactory。

artifactory.conan.v2.migration.job.queue。工人= 2(默认)

系统需求

  • 人工版本6.9.0及以上。
  • Artifactory Pro许可证及以上或用于C/ c++的人工CE
  • 柯南客户端版本1.13.0及以上与修订模式启用。在柯南客户端启用Revision模式,请参见柯南的客户

修改索引

使用Conan客户机来部署包。默认情况下,Conan客户端将请求最新的请求修改柯南的参考文献。
在使用Conan客户端进行部署时.timestamp文件在每个修订根目录下创建每一个配方及包装修改根
该文件包含部署的纪元时间(以毫秒为单位,例如,1547984992855),仅在使用柯南客户

仅使用柯南客户端部署柯南包

不要在UI中或通过REST API部署部署Conan包,以防止索引一致性和失败的解析。


查看单个柯南V2包信息

Artifactory允许您直接从UI中查看Conan包的选定元数据。在工件选项卡上,选择树浏览器并向下钻取以选择要检查的包文件。元数据显示在柯南的信息选项卡。显示的具体信息取决于您所选择的树项。选择包的根项将显示用于上传包的Conan配方的详细信息。

查看柯南包修订

从Artifactory 6.9.0开始,支持Conan v2,并引入了新的Conan格式布局来支持Revisions属性。

下面的示例显示了一个带有默认版本“0”“两个配方


  • 没有标签
版权所有©2023 JFrog Ltd.