Create a release with a wizard

  • Release version: Washingtondc
  • Updated January 20, 2025
  • 2 minutes to read
  • Create a release for one or more products with the help of a wizard. The wizard guides you through the entire release creation process.

    Before you begin

    Role required: sn_dpr_model.product_manager

    About this task

    Releases can follow a timeline-oriented and stage-oriented release process. For more information, see Release for a product.

    Procedure

    1. Navigate to Workspaces > Digital Product Release Workspace.
    2. Select the releases icon (Releases icon.).
    3. Select Create release.
    4. In the Release details step, provide basic information about the release, including the release name, owner, and a brief description.
    5. In the Product and versions step, select a product and its version to include in the release.
      Any Included products associated with the selected products are listed.

      You can add more related products or remove any listed related products and their associated versions.

      • To add more products, perform the following steps:
        1. Select + Add product.
        2. Select one or more related products from the list as needed.
        3. Select Add.
        4. If there are Included products for any of the selected products, you can choose to include or exclude them from being added to the release.
          • To add the selected products and their Included products, select Yes, add Included products also.
          • To add only the selected products without Included products, select No, add selected products.
      • To remove an existing Included product from the list, select the remove included product icon (Remove included product icon.) against the product.
      Note:
      The number of Included products that can be added to a release depends on the system property sn_dpr.multi_product.included_products_limit. A release admin can update the value of this property to increase or decrease the limit.
    6. In the Release template step, select a release template to apply to the release.
      A release structure is generated based on the selected release template. For more information about a release template, see Create a release template.
    7. In the Release target step, select a release readiness target to determine when the release should be ready.
      A release target is needed for timeline-oriented releases, while it's not needed for stage-oriented releases.
      1. Select a release calendar and then select a date.
        If release targets are unavailable on the selected date, a new target is created and applied to the release.
      2. If release targets are available on the selected date, select a target to apply to the release.
    8. Select Create release.

    Result

    • One or more releases are created depending on the number of products selected:
      • If you selected a single product, a release is created. The release is opened in the Release Dashboard page.
      • If you selected multiple products, the releases are created based on the value set for the sn_dpr.multi_product.create_independent_releases system property:
        • When the property is set to false, a main release is created for the primary product and individual releases for each included product are created and added to the main release as dependents.
        • When the property is set to true, a release bundle containing all the individual releases created for the primary product and each included product is created. The release bundle is opened in the Release bundle's Overview page.
    • Any artifacts associated with the product are added to its release. For more information, see View and manage data from external tools.

      You can add or remove artifacts from a release as needed. For more information, see Manage artifacts in a release.