JFrog

    云客户?
    免费开始>
    在MyJFrog中升级>
    云的新功能>






    跳到元数据的末尾
    转到元数据的开始

    概述

    Artifactory原生支持R语言的CRAN存储库，让您完全控制CRAN包的部署和解析过程。综合R档案网络(Comprehensive R Archive Network, CRAN)是一个站点集合，这些站点包含相同的材料，包括R发行版、贡献的扩展、R文档和二进制文件。R是一种编程语言和免费软件环境，专门用于统计计算和图形，由R统计计算基金会提供支持。R语言被广泛使用用于开发统计软件和数据分析数据挖掘者和统计学家。

    Artifactory中的CRAN存储库提供以下好处:

    • 具有细粒度访问控制的安全和私有本地CRAN存储库。

    • 代理远程CRAN资源和缓存下载的CRAN包的能力，使您独立于网络和2022世界杯阿根廷预选赛赛程远程资源。

    • 支持单个URL的虚拟CRAN存储库，通过该URL可以管理所有CRAN包的解析和部署。

    • 托管在Artifactory本地存储库中的CRAN包的元数据计算。

    • 版本管理:存档上传到本地存储库的软件包的旧版本。

    • 管理源代码和二进制文件。

    CRAN版本支持

    Artifactory支持CRAN 3.4.0及以上版本。

    页面内容



    配置

    局部存储库

    开启CRAN元数据计算功能，在“Administration”模块中，执行存储库|存储库|当地的并选择凹口随着包类型创建本地存储库时。

    本地存储库布局

    你需要维护特定的路径结构以便管理上传到CRAN本地存储库的CRAN包。

    CRAN包上传到以下位置:

    • 默认情况下，源包会自动上传到相对路径:src /普通发布版。例如:src / contrib / ArtifactoryRDS_0.1.0.tar.gz。
    • 二进制包根据发行版和R版本上传到相对路径。例如:/ myfirstpkg_1.2.tgz。

    Artifactory将通过执行属性搜索来查找包，从而使文件夹层次结构不会对性能产生影响。

    将源包放置在推荐的路径中

    当通过UI上传一个CRAN包时，默认的部署路径是不强制的，但是推荐使用，因为它允许Artifactory管理CRAN包。将包上传到不同的路径将导致包不被识别为CRAN包。

    远程存储库

    您可以创建CRAN远程存储库来代理和缓存远程存储库或其他Artifactory实例。

    请注意，远程CRAN存储库的索引文件是根据检索缓存周期设置。


    虚拟存储库

    Artifactory中的虚拟存储库聚合来自本地和远程存储库的包。这允许您从为虚拟存储库定义的单个URL访问本地托管的CRAN包和远程代理的CRAN库。

    要创建虚拟CRAN存储库，请设置凹口随着包类型，并选择要包含的基础本地和远程CRAN存储库存储库部分。

    解析CRAN包

    在UI中解析CRAN包

    当在Artifacts模块Tree Browser中选择了CRAN存储库时，单击帮我介绍查看可用于发布CRAN包的代码片段，或配置R客户端以使用所选的组件解析工件存储库。

    使用R命令行解析CRAN包

    1.运行帮我介绍凹口。

    2.到s从当前存储库切换到不同分辨率的CRAN存储库。

    setRepositories ()

    3.查看所选C的所有可用包运行库。

    available.packages ()

    4.从CRAN存储库安装一个包。

    install.packages() -从列表中选择，在支持的客户端上install.packages("package") -按包名安装


    部署CRAN包

    将包部署到本地或虚拟CRAN存储库部署UI特性或者使用POST请求。

    元数据更新

    当添加、删除、复制或移动CRAN包时，会自动计算和更新CRAN元数据。只有在完成与包相关的操作后才调用计算。
    有时可能需要30秒才能完成由于该进程是异步的，其性能取决于整个系统负载。
    还可以通过选择调用整个存储库上的元数据计算重建索引包。

    设置默认部署存储库

    要将CRAN包部署到虚拟CRAN存储库，请确保设置了默认部署存储库。


    使用UI部署包

    您可以在UI中的Deploy中拖放或选择要上传的CRAN包。Artifactory将识别它是源代码还是二进制包。

    Artifactory支持两种类型的包:二进制文件和源代码。它们在UI中的部署是不同的。

    部署源包

    在部署源deploy时，会自动显示“Target Path”，我们建议这样做不改变路径。改变了src /普通发布版路径将导致Artifactory不能将包标识为CRAN包，因为Artifactory将无法对其进行索引。

    目标路径

    Target路径会自动更新，更改它可能会使Artifactory无法调用元数据计算，并且该包不会被索引。

    部署二进制包

    在二进制部署中，您需要填充CRAN Artifact部分。

    在CRAN Artifact部分中，在部署CRAN包时配置这些字段。必须设置这些字段，并用于创建目标部署的二进制包路径。

    • 发行版:指定操作系统。
    • R Version:版本号R版本使用。

    目标路径

    完成目标路径的更新后该文件已部署，无需更改

    使用cURL部署包


    部署源包 
    curl -XPOST "http://localhost:8080/artifactory/api/cran/cran-local/sources" -T package_1.0.tar.gz



    部署二进制包 
    curl -XPOST "http://localhost:8080/artifactory/api/cran/cran-local/binaries?distribution=macosx/el-capitan&rVersion=3.5" -T package_1.0。-XPOST "http://localhost:8080/artifactory/api/cran/cran-local/binaries?distribution=windows&rVersion=3.5" -T package_1.0.zip

    在部署CRAN二进制包时，需要像以前一样指定发行版和R版本。

    当直接部署时(PUT请求到特定路径)，确保目标路径是有效的CRAN路径:

    • / src /普通发布版的来源
    • /bin /{分布}/ contrib / {r-version}对二进制文件。

    将包部署到不同的路径将不会将包标识为CRAN包，也不会调用元数据索引。

    在本地CRAN存储库上应用CRAN官方规范

    从Artifactory版本7.41.1开始，您可以将存储在本地CRAN存储库中的工件设置为限于官方CRAN规范需求。

    设置以下内容系统属性。yml文件将CRAN档案保存在正确的层次结构中。

    “cran.archiveMover.enabled”

    您可以使用以下命令将现有的archive移动到正确的路径移动CRAN档案REST API。要求cran.archiveMover.enabled待启用。

    查看单个CRAN包信息


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

    在工件存储库浏览器，选择您的虚拟CRAN存储库，向下滚动以查找并选择您想要检查的包。元数据显示在凹口信息选项卡。

    重新建立一个CRAN存储库

    您可以通过UI或使用REST API触发本地CRAN存储库的异步重新索引。

    通过UI，在Tree Browser中选择CRAN存储库，然后从右键菜单中选择Recalculate Index，如下所示(需要管理员权限)

    要通过REST API重新索引CRAN存储库，请参考计算CRAN存储库元数据。

    版权所有©2023 JFrog Ltd.