Red Hat Training

A Red Hat training course is available for Red Hat Fuse

Chapter 25. Working with Versions

Versioning provides the means for safely rolling out upgrades of the profiles deployed and running in containers across a fabric. Using versioning, you can make incremental updates to existing profiles, and then test them out on small groups of containers. When you've completed and tested the final versions, you can confidently deploy them to their target containers in the fabric.

25.1. Creating a new version of a profile

Overview

A version is simply the collection of all profiles associated with a fabric. When you create a new version, you are copying all of the profiles from the most recent version—the base version—into the new version. Once that's done, you can upgrade the profiles in the new version by modifying them.

Creating a new version

To create a new version:
  1. In Fabric Explorer, select the fabric in which you want to create a new version.
  2. Expand the fabric's tree to the level of Versions, shown in Section 24.1, “Creating a new profile”.
  3. Select a version, and then right-click it to open the context menu.
  4. Select Create Version.
  5. In the Create Version wizard, enter a new version or accept the default value.
    The default version is always a minor increment of the highest-numbered version. So, if the highest-numbered version is 1.3, the new version will default to 1.4, and all of the profiles in version 1.3 will be copied into version 1.4.
    Important
    Version names are important! The tooling sorts version names based on the numeric version string, according to major.minor numbering, to determine the version on which to base a new one. You can safely add a text description to a version name as long as you append it to the end of the generated default name like this: 1.3<.description>. If you abandon the default naming convention and use a textual name instead (for example, Patch051312), the next version you create will be based, not on the last version (Patch051312), but on the highest-numbered version determined by dot syntax.
  6. Click OK.
    The tooling copies all of the base version's profiles into the new version and displays the new version in Fabric Explorer, directly under the base version.

Modifying profiles in the new version

To modify a profile in the new version:
  1. In Fabric Explorer, expand the newly created version.
  2. Select a profile that you want to modify.
    The tooling populates the Properties editor with the profile's details for you to edit.
  3. In the Properties editor, click the Details tab to access the Profiles page.
  4. Make the changes you want to the new profile to configure it.
    Changes are automatically saved as you make them.
    Note
    In Fuse Integration perspective, you can easily add a Fuse project to the new profile by dragging it from Project Explorer and dropping it onto the new profile in Fabric Explorer. When you do, the tooling builds the project, runs all tests, installs the project in the new profile, and uploads the profile into the fabric's internal Maven repository. Because profiles are stored in a fabric's internal repository, they cannot be shared across other fabrics.

Related topics

Section 24.1, “Creating a new profile”