Cloud Services

Enterprise Marketplace

Version catalogs
Published On Oct 07, 2024 - 11:29 AM

Version catalogs

Creating different versions of a catalog.
You can set up your system so that separate organizations use different versions of a catalog. For example, your production teams might use catalog version 1.0.0.0, while QA teams use catalog version 1.0.1.0, and developers use catalog version 1.1.1.0. These four numbers in a version represent the standard Version, Release, Modification, Fix (VRMF) versioning scheme.
Catalog versioning enables you to provision the latest and previous versions of a catalog. Versioned catalogs enable you to edit catalogs, revert your edits, and provision orders for existing older versions. If you are using older catalog versions, you can also upgrade to newer versions.
Catalog versioning information is available in multiple pages across Enterprise Marketplace, including the
Catalog Details
pages, the
Catalog Admin
page, and the
Inventory
page. Enterprise Marketplace versioning carries across Kyndryl Modern Operations Applications. Each catalog version in Enterprise Marketplace follows its own service life cycle and is available for use until it is retired.
Most catalogs pulled into the Enterprise Marketplace Catalog come from providers with their own versioning mechanisms. Kyndryl Modern Operations Applications applies a single versioning format across providers so that all catalogs and stacks in Enterprise Marketplace use the same versioning.

What determines a stack version number?

When a catalog is imported into Enterprise Marketplace, it displays in the
Catalog Admin
page as a Draft catalog, version 1.0.0.0. When the Catalog Admin modifies the Draft catalog, it becomes a Work In Progress catalog, version 1.0.0.0. When the Catalog Admin publishes the catalog, it becomes a Published catalog, version 1.0.0.0. Published catalogs are available for provisioning on the Enterprise Marketplace
Catalog
page.
The Enterprise Marketplace
Catalog Details
page displays both the Enterprise Marketplace and IBM Cloud Automation Manager versions of the catalog. The current Enterprise Marketplace release displays only IBM Cloud Automation Manager provider version information. Provider version details support is being added to future Enterprise Marketplace releases.
The catalog version can only be changed by updating a catalog on the provider site and bringing the update into Enterprise Marketplace. For example, a Service Designer updates an IBM Cloud Automation Manager service template in the IBM Cloud Automation Manager application. Next, the Service Designer pushes the updated template to Enterprise Marketplace. The version 1.0.0.0 catalog already on Enterprise Marketplace changes to version 2.0.0.0.

Who can work with catalog versioning?

Catalog Admins can edit catalog versions in Draft and Work In Progress statuses on the
Catalog Admin
page. They can make the following changes:
  • Group different versions of the same catalog by group names. This information helps Buyers, Purchasers, and Operators know if different versions that are being sent belong to the same catalog based on the group name. Group names must be unique.
  • Set different catalog personalization policies for different catalog versions.
  • Edit description details, logos, categories, and group names.
  • Create or update labels, pricing, and pricing rules for new catalog versions.
  • Make new catalog versions available for use, along with existing versions.
  • Delete catalog versions when those catalogs have no provisioned stacks.
  • Designate a particular catalog version as the default version used for provisioning.
The Buyer, Purchaser, Service Designer, and Operator roles can see existing and new versions of a catalog in the catalog's
Details
page. They can also see what has changed in each catalog version in the
Details
page.
Buyer and Purchaser roles can select any Published catalog version, past or present, to provision. After selecting a catalog version, these roles configure the selected catalog version for provisioning as described in Catalog ordering.
Approver roles see only the version of the catalog submitted for provisioning in the Approve Orders
Catalog Details
page.
Do you have two minutes for a quick survey?
Take Survey