Promote a Release Bundle v2 Version in the Platform UI

JFrog Artifactory Documentation
Products
JFrog Artifactory
Content Type
User Guide

The easiest way to promote a Release Bundle v2 version in the platform UI is by using the Stages Board, but it can also be performed from the Actions menu, as described below.

To promote a Release Bundle v2 in the platform UI:

  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 Stages Board tab. The tab displays a kanban board that provides a visual representation of the versions that exist for the selected Release Bundle and their current stage in your release lifecycle. Versions that have not been promoted yet are listed as Unassigned.

    RLM-redesign_Stages-Board_tab.png

  4. Do one of the following:

    • Click the kanban card for the relevant Release Bundle version to open the version timeline. Next, click Actions and select Promote.

      RLM-redesign_promote-RB-version_option.png

      Or,

    • Drag-and-drop the card representing the relevant Release Bundle version to the desired stage.

      RLM-redesign_Stages-Board_promote.png

    The New Promotion dialog box is displayed.

  5. In the Promotion Environment tab, do the following:

    • (optional) Change the signing key, if desired.

      Warning

      Make sure the signing key is valid. The operation will fail if the key has expired.

    • Choose the promotion type: Copy Artifacts or Move Artifacts.

      If you choose Move Artifacts, the artifacts contained in the Release Bundle are deleted from the repositories in the source environment during promotion.

      Note

      The Copy option is applied automatically (even if Move is selected) when promoting a Release Bundle version from Unassigned to a stage. The Copy promotion is also applied automatically if you promote a version to the same stage in which it already resides.

    • Verify the selected target stage.

  6. Click Next.

  7. In the Target Repositories tab, review the list of target repositories for each package type. To modify the list, open the relevant dropdown list and clear the checkmark next to each repository to exclude it from the promotion.

    Note

    There must be at least one repository defined for each package type.

  8. Click Promote. The relevant card moves to its new stage. The icon on the card indicates which type of promotion was performed. In addition, the promotion is added as an event on the timeline.

    promotion_icons.png
    RLM-redesign_timeline_rb-promoted.png

    Note

    If any artifact in the promotion has a different checksum than the same artifact in the target environment, the promotion stops, and an error message is displayed.

    Note

    You cannot modify or delete a file that belongs to a promoted Release Bundle. You must first delete the promotion or delete the Release Bundle version altogether before the files can be modified or deleted. This restriction protects the immutability of the Release Bundle.

    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. For more information, see Scan Release Bundles (v2) with Xray.