Release an Application Version in the Platform UI

The procedure to release an application version is very similar to the procedure for promotion. You can use the drap-and-drop method or the Actions menu, as described below.

Drag-and-drop on the Stages Board

The easiest way to release an application version manually in the platform UI is to simply drag it from its current stage and drop it in the PROD stage, as described below.

To release via drag-and-drop:

1. In the Platform module, select AppTrust > Applications.

2. In the Applications table, click the name of the relevant application.

3. In the sidebar, click Lifecycle. The Stages Board tab is displayed by default.

4. Locate the card for the relevant application version, then drag-and-drop it in the release stage (PROD). When you release the card, the New Promotion dialog box is displayed.

   

5. In the Promotion Stage 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 application version are deleted from the repositories in the source stage during release.

• Verify the selected target environment is PROD.

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 release.

   

📘

Note

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

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

   

Release from the Actions Menu

Another way to release an application version manually is to select the option from the Actions menu.

To release an application version:

1. In the Platform module, select AppTrust > Applications.

2. In the Applications table, click the name of the relevant application.

3. In the sidebar, click Lifecycle.

4. Click the Versions tab.

5. In the Versions table, click the name of the relevant version. The Version Timeline tab is displayed by default.

6. From the Actions menu, select Release Version.

   

7. Continue the release process, as described above.

Release with Governance

If your lifecycle includes governance, the application version is released to the PROD stage only if it passes the evaluations defined by the lifecycle policies configured on Release gate. The results of each evaluation can be viewed on the application Evaluation tab.

Version release will fail if the application version violates a policy containing a rule configured to fail upon violation. In such cases, an error message is displayed on the card and in the version timeline.

Click the error message to see details about why the release failed, including the name of the policy which failed. Click Full Evaluation to see complete details.