Skip to main content Skip to complementary content

Promoting to a Dynamic Engine environment

You can promote all the objects of a Remote Engine or Dynamic Engine environment at once to a Dynamic Engine environment.

Personal workspaces cannot be promoted.

Artifacts that cause errors and cannot be promoted are ignored.

Pipeline artifacts, tasks, and plans cannot be promoted as they are not yet supported by Dynamic Engine environments.

To preserve ownership and control of environments, the promotion should be executed by the owner of the target Dynamic Engine environment.

Before you begin

  • You must be assigned to the promotion.
  • Ensure that no other promotion is running at the same time on the same source and target environments.
  • You need the Promotion - Start (TMC_PROMOTION_EXECUTION) user permission to execute a promotion.
  • Plans must be run at least once before they can be promoted.

About this task

It is the responsibility of the target environment owner to promote artifacts. In this case, no additional rights are required for users of the target environment to interact with the promoted artifacts.

The promotion analysis provides a preview of the promotion before it is executed; it helps you find warnings or conflicts. Conflicts prevent the promotion.

When a promotion is over, you can refer to the Promotion Report that lists the artifacts and workspaces promoted and the required user actions in the target environment (specify task parameters, configure new connections and so on).

Procedure

  1. Open the Promotions page.
  2. Hover over the promotion you want to use and click the Promote icon.
  3. On the Promote page in the Configuration step, select Environment as the scope of the promotion.
  4. Specify how to handle resources during the promotion.
    Action Description
    Override Promoted resources take precedence over the target environment's resources.
    Keep target Existing resources are not affected by the promotion.
  5. Specify how to handle run profiles during the promotion.
    Action Description
    Override Promoted run profiles take precedence over the target environment's run profiles.
    Keep target Existing run profiles are not affected by the promotion.
  6. Optionally, type in any information about the promotion in the Notes field.
  7. Click Analyze.

    The promotion analysis is displayed.

    The object is in one of the following promotion states:
    State Description
    Created The object does not exist in the target environment and will be created.
    Reused The object exists in the target environment with the same version.
    Replaced The object exists in the target environment and will be replaced by the source environment version.
    Failed The object cannot be promoted because of a conflict.
  8. If you agree with the promotion analysis, click Promote.

Results

Depending on the amount of objects to promote, a promotion can take up to 30 minutes.

If the promotion takes more than 20 seconds, the promotion will continue to run in background. You can continue working in Talend Management Console while the promotion is being executed.

You can view its progress from the Status column in the promotion list or from the Promotion run history page.

Once the promotion is done, either successfully or with warnings, you can open the Promotion details panel by clicking the promotion name. In the Overview tab, you can see the details of your last promotion. You can also access the full promotion history by clicking View history.

If the promotion fails, a notification appears on the Promotion analysis page to show the promotion errors.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!