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.

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 groups 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 works 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

To install additional pre-builts on Platform 6, connect the Pre-Builts Catalog to a Git repository:

1. Verify that the pre-built's dependencies are installed and running in your deployment.
2. 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 setting to point to the required repository, such as the the Itential pre-builts automation repository or your own.
4. Browse and install pre-builts from the Pre-Builts Catalog in Admin Essentials.

Option 2: Import pre-built artifact file

To import a pre-built:

1. Download the artifact.json file associated with the pre-built. Artifact is a mandatory file contained in the pre-built’s Git repository file structure.
2. Import the file using Admin Essentials.

For more details, see Installing 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.json file associated with the pre-built.
2. Import the file using Admin Essentials.

For more details, see manually install a pre-built.

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