Export Release Bundle v2 Versions in the Platform UI

JFrog Artifactory Documentation

Products
JFrog Artifactory
Content Type
User Guide

The procedure below describes how to export a Release Bundle v2 version to a .zip file that can be transferred to a different Artifactory instance in an Air Gap environment.

To export a Release Bundle v2 version:

  1. In the Platform module, select Artifactory > Release Lifecycle.

  2. Click the name of the relevant Release Bundle. The Versions tab is displayed by default.

  3. Click the name of the relevant Release Bundle version. The Version Timeline tab is displayed by default.

  4. Click Actions and then select Export.

  5. (optional) In the Path Mappings field, specify a list of input and output regex mapping pairs that define where the queried artifact is located and where it should be placed after it is imported. Use this option if the path on the target is different than the source path.

    Important

    Path mapping can be performed only during the first distribution or export of a particular Release Bundle version. The following message is displayed during subsequent operations.

    path-mapping-already-defined.png

    There are several options for defining path mappings:

    • You can define custom mapping pairs manually and click Add.

    • You can click Use Template to use one of the provided Path Mapping templates:

      Template

      Description

      Change Repository

      All files in a specific repository on the source Artifactory service are mapped to a different repository on the target.

      Change Folder

      All files are moved to a specific folder in the target.

      Rename Folder

      All files in a specific folder on the source Artifactory service are mapped to a different folder on the target.

    • If the Default Path Mapping by Last Promotion feature is enabled (requires Distribution 2.26.1 or higher), the repositories used for the most recent promotion of this Release Bundle version are provided as the default path mapping. If you do not want this path mapping definition, click the X to remove it.

      default-path-mapping_distribute.png

    Important

    See Path Mapping Guidelines for Release Bundles v2 for important instructions and limitations regarding path mapping.

  6. Click Export. When the process is complete, a new event is added to the version timeline.

    Warning

    When JFrog Xray is used to scan Release Bundles for potential vulnerabilities and license violations, Xray will block the distribution if the License Bundle violates a Policy that has a blocking action defined. For more information, see Scan Release Bundle v2 Versions with Xray .

Additional Export Actions

Click the export event in the timeline to view the list of artifacts included in the exported archive. Use the icons to perform the following actions on the archive: