S3 Direct Upload Template (Recommended)

This template uploads binaries directly to the S3 bucket. This mechanism generally allows for faster uploads, since there is less contention for disk IO, particularly when Artifactory is hosted on AWS. The direct template can be used for both single-node and high-availability (HA) configurations. A shared mount is not needed for HA. For more information, see Configure Artifactory to Use S3 Storage.

The S3 direct <chain="s3-storage-v3-direct"/> (or eventual-less) template shown below allows directly uploading to S3, bypassing the eventual upload mechanism.

<config version="2">
    <chain template="s3-storage-v3-direct"/>    
    <provider id="s3-storage-v3" type="s3-storage-v3">
       <endpoint>s3.amazonaws.com</endpoint>
       <bucketName>bucketName</bucketName>
       <path>pathPrefix</path>
       <region>s3Region</region>
       <identity>yourIdentity</identity>
       <credential>yourCredentials</credential>
       <awsSdkV2>true</awsSdkV2> <!-- Supported from Artifactory version 7.125.4 -->
    </provider>
</config>

While you don't need to configure anything else in your binarystore.xml, the following example shows what the s3-storage-v3 template looks like under the hood. This example sets S3 with your credentials. The default settings for maxConnections, connectionTimeout, and cache-fs maxCacheSize configuration are also shown in this example.

<config version="2">
   <chain>
        <provider id="cache-fs" type="cache-fs">
            <provider id="s3-storage-v3" type="s3-storage-v3"/>
        </provider>
   </chain>
   <provider id="s3-storage-v3" type="s3-storage-v3">
       <endpoint>s3.amazonaws.com</endpoint>
       <bucketName>bucketName</bucketName>
       <path>pathPrefix</path>
       <region>s3Region</region>
       <identity>yourIdentity</identity>
       <credential>yourCredentials</credential>
       <maxConnections>50</maxConnections>
       <connectionTimeout>10000</connectionTimeout>
       <awsSdkV2>true</awsSdkV2> <!-- Supported from Artifactory version 7.125.4 -->
   </provider>
   <provider type="cache-fs" id="cache-fs">
       <maxCacheSize>5000000000</maxCacheSize>
   </provider>
</config>