Distribute a Release Bundle (v2) using the Platform UI

JFrog Artifactory Documentation

Products
JFrog Artifactory
Content Type
User Guide
ft:sourceType
Paligo

Release Bundle v2 versions are distributed from the version timeline.

Subscription Information

This feature is supported with the Enterprise+ license.

To distribute a Release Bundle v2:

  1. In the Application module, select Artifactory > Release Lifecycle. The Release Lifecycle dashboard is displayed.

    Note

    Distributing Release Bundles v2 using the dashboard requires Distribution 2.22.1 or above.

  2. Click the name of the relevant Release Bundle to open the kanban board.

  3. Click the kanban card for the relevant Release Bundle version to open its timeline.

  4. Find the Release Bundle version you wish to distribute and from the Actions menu, select Distribute. The Distribute window is displayed.

    Dashboard_Actions-menu_distribute.png
  5. In the Distribution Targets tab, select the desired distribution targets (e.g. Edge nodes).

    2_23_x_Distribute-RBv2-targets-tab.png

    Tip

    If no distribution targets are displayed, click the link provided in the window to see suggestions about the possible cause.Distribution Target Troubleshooting

  6. (optional) Select the Auto create missing repositories checkbox to have any missing repositories in the distribution targets created automatically. If this option is not selected and a missing repository is detected, distribution will fail.

  7. (optional) In the Additional Properties tab, specify a list of input and output regex mapping pairs that define where the queried artifact is located and where it should be placed. 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 of a particular Release Bundle version.

    GA_distribute_path-mapping.png

    You can define custom mappings of your own or 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.

  8. Click Distribute. The status of the distribution operation is displayed in the version timeline. There will be an entry in the timeline for each distribution target. For example, if you distribute the Release Bundle to 3 Edge nodes, three entries will be added to the timeline (one for each target).

    In addition, a new card will appear on the distribution board beneath each distribution target.

    Warning

    When JFrog Xray is used to scan Release Bundles for potential vulnerabilities and license violations, Xray will block promotion if the Release Bundle violates a Policy that has a blocking action defined. Scan results are shown in the timeline event, as shown below.

    Dashboard_distribution-scan-results.png

    For more information, see Scan Release Bundles (v2) with Xray.

    Tip

    To view distribution details after the operation is complete, click the relevant event in the timeline. Click the link in the Target field to view the distribution results in the Received tab of the Edge node.

    Dashboard_distribution-event-details.png