JFrog

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






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

    概述

    JFrog对云存储的支持提供了大规模可伸缩性的所有好处，并允许您的二进制存储有效地增长到所需的任何规模，并容纳任何大小的二进制文件。JFrog平台可以进一步优化从云存储下载大型二进制文件(如Docker映像)，方法是将其功能委托为注册表，这样它就可以用一个链接来响应下载请求，通过该链接，请求客户端可以直接从相应的云存储下载二进制文件。

    当将存储库配置为重定向下载时，为该存储库中托管的工件请求Artifactory的客户机将收到一个HTTP 302回应和位置头中包含签署的URL到云存储位置直接下载。然后，客户端可以使用该签名URL直接从云存储下载二进制文件，而不必先通过Artifactory。

    直接从云存储下载二进制文件:

    • 提高了效率并减少了下载延迟，因为二进制对象是在单个阶段直接从云端获得的，而不必首先经过Artifactory的缓存。
    • 减少了对本地存储的需求，因为Artifactory的本地缓存不需要容纳来自云的大型二进制对象。
    • 增加了Artifactory的注册表操作时间，因为更多的计算能力可以用于计算元数据，而不是等待下载请求完成的线程

    需求

    版本和平台

    以下JFrog订阅用户可直接下载云存储:

    • 当您的Artifactory二进制存储配置了AWS S3或Google Cloud storage时，自托管Enterprise+或Edge许可证。
    • 所有云订阅

    支持的包格式

    JFrog Artifactory正式支持直接云存储下载以下类型的本地存储库:Generic、Helm、Docker、Maven、RPM、Npm、Debian(从Client version 9开始支持)、PyPI、Bower、CRAN、Composer、Conan、Gradle、Vagrant和Git LFS．

    要使用curl、wget和Gradle客户端，请确保有一个支持的客户端版本。参考这个知识库文章了解更多信息。

    页面内容

    配置

    按照以下步骤配置Artifactory，以便直接下载云存储:

    1. 配置工件文件存储库允许直接下载。
    2. 指定存储库应该重定向请求直接下载。
    3. 微调配置带有直接下载参数。
    4. 控制您的签名URL下载．
    5. 配置防火墙允许直接下载。
    6. 添加要使用的必要配置CloudFront(对于AWS S3可选)。


    1.配置工件文件存储库

    如下所述配置文件存储，可以控制Artifactory如何存储二进制文件JFROG_HOME美元/ artifactory / var / etc / artifactory / binarystore.xml文件。

    要启用直接云存储下载，请使用设置以下参数S3二进制提供程序或谷歌云存储二进制提供商binarstore .xml文件的。

    enableSignedUrlRedirect
    		 将该值设置为true以启用该特性。
    signedUrlExpirySeconds

    默认值:30(可选)

    指定向请求客户端提供用于从云存储直接下载的签名URL的有效秒数。

    下面的代码片段展示了这些参数在你的binarystore.xml文件:

    true 30 300

    2.指定用于直接下载的存储库

    Artifactory可以配置为在存储库级别重定向直接下载的请求(没有全局配置来自动重定向所有请求)。这允许您既支持支持下载重定向响应(HTTP 302)的客户端，也支持不支持的客户端。下载重定向支持所有存储库类型—本地、远程、虚拟和通用存储库。对于配置为重定向的本地和远程存储库，将重定向所有请求。对于虚拟存储库，这取决于聚合的本地或远程存储库最终提供所请求的工件。如果存储库配置为重定向，那么请求客户端将接收相应的重定向响应，否则，Artifactory将获取被请求的工件，并像往常一样将其提供给客户端，而不需要重定向。

    远程存储库必须配置为在本地存储构件

    如果所请求的工件在本地可用，Artifactory只能将请求重定向到直接云存储下载。对于本地存储库，这是自然的状态，然而，对于远程存储库，您可以通过取消选择，将存储库配置为不在本地缓存工件本地存储工件复选框中的存储库配置(或通过设置storeArtifactsLocally = false当创建或更新使用REST API的存储库)。因此，对于远程存储库，您需要确保将存储库配置为在本地存储工件(例如，本地存储工件复选框被选中，或者storeArtifactsLocally = true）.如果不这样做，将产生一个错误。

    您可以配置Artifactory来使用UI、REST API和YAML配置文件重定向直接下载请求。

    使用UI

    要将本地或远程存储库配置为重定向请求以进行直接下载，请设置启用“云存储直接下载”复选框中的存储库配置的高级选项卡。

    使用REST API

    要配置本地或远程存储库以使用REST API重定向直接下载请求，请设置downloadRedirect属性为真正的(默认情况下,假）.例如:

    curl -u admin:password -X POST -H "Content-Type: application/json" -d '{"rclass":"local"， "downloadRedirect": true}' http://localhost:8080/artifactory/api/repositories/s3-generic

    或者，您可以设置downloadRedirect的参数。存储库配置JSON这是真的。

    使用YAML配置文件

    如果你是使用YAML文件配置存储库，你可以使用downloadRedirect属性。

    例如，配置一个名为generic-remote直接下载:

    curl -u admin:password -X PATCH -H "Content-Type: application/yaml" "http://localhost:8080/artifactory/api/system/configuration" -T remote.yaml

    在哪里remote.yaml是:

    remoterepository: generic-remote: downloadRedirect: enabled: true

    3.微调直接下载

    直接云存储下载特性的好处之一是，当必须同时为大型工件提供多个下载请求时，它减少了人工注册中心的负载。当下载的构件确实很大时，就会实现这个好处。要微调此特性，请设置最小工件大小，以便下载请求可以重定向为直接云存储下载最小直接云存储下载大小参数(自托管客户的默认值是1 MB)。

    4.控制已签名URL下载(适用于S3)

    你可以通过配置下面的头来控制下载:X-JFrog-Download-Redirect-To．

    支持以下方法来控制签名URL重定向:

    • 没有一个:直接下载，不需要重定向。
    • S3:即使存在CloudFront，也会从S3下载。
    • CF (CloudFront):从CloudFront下载，如果它是可用的。默认情况下，如果配置了CloudFront，并且它是一个有效的二进制提供程序，它应该从它下载。

    5.穿越防火墙

    当直接云存储下载被启用时，这意味着所请求的工件实际上将从S3或CloudFront域提供，而不是从Artifactory的域。由于这些域在Artifactory提供的签名url中是恒定的，因此您应该将它们添加到组织的防火墙中，以实现顺利且不受阻碍的下载。您应该添加的域名是:

    S3:https:// < bucketName >。s3.amazonaws.com/…

    其中是您的S3二进制提供程序中指定的相应属性的值binarystore.xml文件。例如,

    https://data1234.s3.amazonaws.com/myStoreOfBinaries/60/60b27f004e454aca92b0958209cck4829ec52430?response-content-disposition=attachment%3Bfilename%3D%22connector-java-5.1.4.txt%22&AWSAccessKeyId=AKIAPLS9HS&Expires=1539374539&Signature=lPDrAHlf

    对于谷歌云存储:https://storage.googleapis.com/ < bucketName > / <路径>……

    在哪里< bucketName >在您的Google Cloud storage二进制提供程序中指定的相应属性的值是binarystore.xml文件。例如,

    https://storage.googleapis.com/data1234/myStoreOfBinaries/c12/c12cb08521fd46bc25894fbbc3559fd95e90b2c3?GoogleAccessId= < accessid >到期= 1664801501签名= <签名> &response-content-disposition =附件% 3 bfilename % 3 d % 2 b % 221% 25281% 2529. jpg % 22 &response-content-type = % 2 foctet-stream&x-jf-traceid = 4 acd13bc745dfa36应用

    CloudFront:https:// < cloudFrontDomainName >。cloudfront.net/…

    其中是您的S3二进制提供程序中指定的相应属性的值binarystore.xml文件。例如,

    https://d2h935dfm2pkds.cloudfront.net/myStoreOfBinaries/60/60b27f004e454aca92b0958209cck4829ec52430?response-content-disposition=attachment%3Bfilename%3Djava.jar&Policy=eyJTdGF0ZW1uMzM2ZGZtNnB&Signature=NVmUyUTG~930ub3~mr6~&Key-Pair-Id=APPFSI9VDAF

    6.使用CloudFront(可选)

    为了进一步优化S3中的直接云存储下载，Artifactory允许您指定CloudFront设置，该设置将决定您的工件物理驻留的位置，这意味着从S3存储桶下载将通过快速CDN进行。

    要将CloudFront与直接云存储下载一起使用，请遵循以下步骤:

    1. 创建CloudFront发行版，如开始使用CloudFront请参阅AWS文档。
    2. 生成密钥对，如为您的可信签名者创建CloudFront密钥对请参阅AWS文档。

    3. 在AWS控制台中，在CloudFront >行为>缓存密钥和原始请求下，选择Legacy缓存设置并应用以下设置:

      • 标题:没有
      • 查询字符串:All
      • 饼干:所有

    4. 将您的发行版与S3存储桶匹配起来。

      确保该发行版指向的S3存储桶与您的S3二进制提供程序在你的JFROG_HOME美元/ artifactory / var / etc / artifactory / binarystore.xml文件。

    5. 在你的binarystore.xml文件,设置enableSignedUrlRedirect来真正的．

    6. 配置如下CloudFront参数S3二进制提供程序你的binarystore.xml文件:

      cloudFrontDomainName
      		 AWS提供的唯一域
      cloudFrontKeyPairId
      		 在上面的步骤2中创建的密钥对的唯一标识符
      cloudFrontPrivateKey
      		 在上面的步骤2中创建的私钥，格式如下:

      ---- begin rsa私钥----

      ……

      ----- end rsa私钥-----

      方法中这些参数的外观示例如下S3二进制提供程序你的binarystore.xml文件:

      true d2n9783dfm6kdoq.cloudfront.net APKPDIVCZ4OS2GY6VMGS -----BEGIN RSA私钥----- MIIEowIBAAKCAQEAmVbCi33YzIyQMGJkNJN7NbRAEzZIxHv43nmq0b+tDM2CKX+f ........................... ...........................----- RSA私钥-----


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