Chapter 12. Generating assets for application deployment in user interface


Starting with 8.0.0, asset generation in MTA user interface allows you to create different assets (manifests) required to deploy applications from Cloud Foundry (CF) instances to Red Hat OpenShift Container Platform or Kubernetes.

To generate assets, you must become familiar with the following entities:

  • Archetypes - Archetypes contain one or more criteria tags to identify technologies such as EAP 6. An archetype helps you to classify applications based on technologies common to them. For asset generation, you can plan your migration paths by archetypes because you configure the other asset generation entities in the archetype (for example, target profiles that contain the generators).
  • Generators - A generator takes a templating engine, such as Helm, along with a set of templates as input configuration. Generators use the templates that are defined for a target platform and a migration path to generate deployment assets. When you run an asset generation process, the generator parses the application discovery manifest to create deployment assets.

    For example, the migration path for an EAP 6 application is EAP 8 and the target platform is Kubernetes. A generator can generate the required assets to migrate the EAP 6 application to EAP 8 that is to be deployed on Kubernetes. The assets are generated by parsing the discovery manifest of the EAP 6 application.

  • Target profiles - A target profile represents the target platform to which you want to migrate. It contains a seqeuence of generators. Through target profiles, you can run more than one generator, with each generator creating assets for a specific migration path. Thus, a target profile enables you to generate assets for multiple migration path-target platform combinations at the same time for a given Archetype.

    For example, if you want to create assets to migrate an EAP 6 application as an OpenJDK 21 application and as an EAP 8 application in OpenShift Container Platform (target platform), you can achieve this through a target profile that has two generators, one for each migration path.

  • Application - The application includes the discovery manifest, tags, and the asset repository.

    The configuration retrieval process generates a discovery manifest that contains the platform and runtime configurations of an application deployed in the source platform (CF) instances. During asset generation, the discovery manifest is parsed by generator templates that produce the final assets for deployment.

    The application also contains tags that you must configure as criteria tags in an Archetype.

    The asset repository is where you find the generated assets for deployment in the target platform.

You can reuse generators in different archetypes.

12.1. Configuring a generator

Generators contain a repository of templates that are required to generate different asset manifests.

To create a generator:

Prerequisites

  • You installed MTA 8.0.0 operator to access the web console.
  • You are an administrator with access to the Administration mode in the MTA user interface.
  • As an administrator, you configured a source control credential for the template repository (if applicable).

Procedure

  1. In the Administration view, click Generators.

    On the Generators page, you can create, edit, and delete generators.

  2. Click Create new generator.
  3. Configure the following fields:

    1. In the Name field in the opened dialogue, enter a unique name for the generator.
    2. Select Helm as the generator.
    3. Click Template repository to expand the section.

      1. Select a Repository type from Git and Subversion.
      2. (Optional) Enter the URL of your repository that contains the Helm templates.
      3. (Optional) Enter the Branch of your repository.
      4. (Optional) Enter the Root path of your repository.
      5. Select the credentials to access your repository if it is private.
    4. (Optional) Click Values and enter the new value for an attribute in the discovery manifest as a key-value pair.

      During asset generation, the generator overrides the value of the matching attribute in the discovery manifest with the value you enter.

    5. (Optional) Click Parameters to enter parameters and their default values as a key-value pair.

      Parameter fields will require user inputs before the template generates the assets.

      Note

      During template instantiation, parameters take precedence over value and values take precedence over the configurations present in the discovery manifest.

  4. Click Save. You can click anywhere on the generator row to open the details view that shows the generator configuration details, parameters, and values.

12.2. Configuring a target profile

A target profile contains one or more generators, with each generator generating assets for different migration paths. A migrator can create and track the target profiles for a specific archetype on the Archetypes page. You can configure more than one target profiles for an archetype based on the target platforms to which you want to migrate applications of the specific archetype.

The generators are run in a priority order, in which manifests generated by lower priority generators do not override manifests generated by other generators.

Procedure

  1. In the Migration view, click Archetypes.
  2. Click the Options menu ( kebab ) of an archetype, and select Manage target profiles.

    The Target profiles for <archetype-name> appears.

  3. Click Create new target profile.
  4. In the Name field in the opened dialogue, enter a unique name for the target profile.
  5. Click the Tag category field and select the category tag to associate with the tag.
  6. Select specific generators and click the right arrow to move the generator from the Available generators list to the Chosen generators list.
  7. Click Create.

You can click on the archetype row to open the archetype detail view where the target profiles for the archetype are listed.

12.3. Configuring an asset repository

Migration Toolkit for Applications (MTA) generates assets and publishes them to an asset repository that you configure. If you do not configure an asset repository, the application repository is taken as the default to publish the generated assets.

When you configure the asset repository for an application, you can also associate the Source Control credentials of the asset repository before generating assets. If you do not configure a Source Control credential for the asset repository, MTA considers the source code repository credential as the default Source Control credential for the asset repository.

Procedure

  1. In the Migration view, click Applications.
  2. Click the edit icon ( icon edit ) to update an imported application.
  3. In the Update application dialog, click Asset repository and configure the following details:

    1. Select the Asset repository type from Git or Subversion.
    2. Enter the asset repository URL in the Asset repository field.
    3. Enter the Branch of your repository.
    4. Enter the Root path of your repository.
  4. Click Save and close the Update application dialog.
  5. Click Manage Credentials from the Options menu ( kebab ) of the application.
  6. Select the asset repository credential on the Manage Credentials dialog and close the dialog.

12.4. Generating deployment assets

When you generate assets for an application, the generators render manifests for all the migration paths associated with the archetype of the application.

Prerequisites

  1. You generated the discovery manifest.
  2. You configured the application tags in an archetype.
  3. You configured generators and target profile in the archetype.

Procedure

  1. In the Migration view, click Applications.
  2. Click the Options menu ( kebab ) of an application.
  3. Click Generate assets to open the Generate assets dialog.
  4. Select a target profile and click Next.
  5. Click the toggle button to open the JSON view where you can enter the parameter values.
  6. Click Next to review the configurations to generate assets.
  7. Click Generate assets.

You can view the generated assets in the asset respository that you configured.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat