Create an Application Version

An Application Version groups multiple sources into a single, composite release. You can include builds, release bundles, and other application versions -- from the same application or from different applications -- as sources within a single version.

You create an application version using the wizard in the JFrog AppTrust UI and you can choose the type of version to be created:

• Draft: A mutable version that you can return to later to add or remove sources before finalizing.
• Finalized: An immutable version that is signed with the selected signing key. Once finalized, the version composition cannot be changed.

This page describes how to create an application version using the AppTrust UI. You can also create an application version using the:

• AppTrust API
• AppTrust CLI

Prerequisites:

• An application exists in AppTrust. The application version is created within the context of an existing application.
• At least one source (a build, release bundle, or application version) exists and is available in your JFrog environment.
• You have the required permissions to view the sources you want to include.
• A GPG or RSA signing key is configured and available if you want to create a finalized (non-draft) version.

To create an application version:

1. In the JFrog Platform, go to Applications and choose an Application in the list.
2. Go to Lifecycle > Actions > Create Application Version.

3. In Step 1 of the Create Application Version wizard, complete the following:
   1. Version: Enter a semantic version number, for example, 3, 3.4, 3.5.6.
   2. Signing Key: Choose from the list of available GPG and RSA keys for signing the version. If you do not select a key, a default key is used. For information on supported keys, see Managing Keys.
   3. Tag: Add one or more tags.
   4. Create as Draft: When you mark this, the version will be unlocked and modifiable. When you promote the version, it will be automatically locked and signed.

4. In Step 2 of the wizard, complete the following:
   1. Source Type: Choose either Build, Release Bundle, or Application Version. If your source type is Build, you can choose to include the Dependencies.
   2. Name: Choose a name from the list.
   3. Version: Choose a version from the list.
   4. Add Source: Click this only if you want to add an additional source to the version. Complete the source information for each additional source you add.

5. When you have finished entering your information in the wizard, you can review a summary of the details in the right panel. Click Create Version.

The application version will now appear in the Stages Board and the Versions table, and the records of the version creation will appear in the Activity Log.