Pre-Builts deprecation

Pre-Built Wizard, Pre-Built Promotion, and App-Artifacts are no longer maintained by Itential as of Platform 6.

Pre-Built Wizard was an Itential pre-built that allowed users to discover and bundle the workflows, JSON forms, transformations, and other assets associated with an automation entry point. Pre-Built Promotion extended this workflow by committing the resulting pre-built to a Git repository, with variants available for GitLab, GitHub, Bitbucket Cloud, Bitbucket Server, and Azure DevOps. Both depended on App-Artifacts as a dependency.

Pre-builts that were already installed on your instance before upgrading to Platform 6 remain installed and continue to function. This deprecation affects only how you can install or import new pre-builts.

What should I do?

Itential recommends migrating your asset bundling and promotion workflows to projects.

If you need to continue using pre-builts, review the options below. The option you choose depends on your deployment type and migration timeline.

Migrate to projects

Itential recommends projects as the replacement for Pre-Built Wizard and Pre-Built Promotion. Projects natively group the workflows, JSON forms, transformations, and other assets associated with an automation into a single exportable and importable unit — without requiring additional pre-built applications or App-Artifacts.

For Git-based promotion pipelines previously handled by Pre-Built Promotion, projects work with community-maintained tooling such as ipctl and standard Git pipeline files. See Use pre-builts in Platform 6 for the recommended workflow.

Continue using pre-builts (on-premises only)

If you are an on-premises customer and are not yet ready to migrate to projects, you can continue installing pre-builts on Platform 6 as long as the necessary pre-built dependencies noted in each pre-built’s README are deployed in your environment. Pre-builts installed before upgrading to Platform 6 remain installed and continue to function.

Option 1: Connect Pre-Builts Catalog to Git

1

Verify dependencies

Verify that the pre-built’s dependencies are installed and running in your deployment.

2

Set the active profile

Set the active profile in your iap.properties file or as an environment variable to configure the repository connection. For instructions, see Use pre-builts in Platform 6.

3

Configure the repository

Configure the repository setting to point to the required repository, such as the Itential pre-builts automation repository or your own.

4

Install from the catalog

Browse and install pre-builts from the Pre-Builts Catalog in Admin Essentials.

Option 2: Import a pre-built artifact file

1

Download the artifact file

Download the artifact.json file associated with the pre-built. The artifact file is a mandatory file contained in the pre-built’s Git repository.

2

Import via Admin Essentials

Import the file using Admin Essentials.

For more details, see Install pre-builts manually.

Cloud customers on Platform 6

Cloud customers upgraded from 2023.2 to Platform 6 retain all pre-builts that were installed before the upgrade. You can view the Pre-Builts Catalog in Platform 6, but you cannot install pre-builts directly from it.

To import a pre-built:

1

Download the artifact file

Download the artifact.json file associated with the pre-built.

2

Import via Admin Essentials

Import the file using Admin Essentials. For more details, see Install pre-builts manually.

Contact your Customer Success Manager or the Product Support Team for assistance.