# プロモーションのルール

ソースからターゲット環境へのオブジェクトのプロモーションは、事前設定済みのルールに基づいて行います。

パーソナルスペースはプロモートできません。

Webhookが含まれているオブジェクトをプロモートしている場合は、ソースとターゲットの環境名に特殊文字が含まれず、英数字とアンダースコアのみが使用されるようにしてください。

オブジェクトは通常名前で照合され、ルールによって一致した各オブジェクトがターゲット環境に作成、更新、上書き、または保持するかどうかが決定されます。

次のリストでは、オブジェクトタイプ別のプロモーションルールについて説明します。

## ジョブアーティファクトとタスク

* ジョブアーティファクトまたはタスクは、ターゲット環境に存在しない場合に作成されます。
  * ターゲットの環境名がTalend Studioのコンテキスト環境名と同じ場合は、Talend Studioに由来するデザインのコンテキストパラメーター値でアーティファクトまたはタスクが作成されます。
  * ターゲットタスクはソースタスクと同じタグを持ちます。
  * アーティファクトの最新バージョンへ自動的にアップデートされるオプションがソースタスクで使用されている場合、このオプションはターゲットタスクでは有効になりません。
* ジョブアーティファクトまたはタスクは、ターゲット環境に存在する場合にアップデートされます。
  * 既存のパラメーター値は変更されません。新しいバージョンのアーティファクトまたはタスクに新しいパラメーターが存在する場合、[Parameters] (パラメーター)に追加されます。
  * ターゲットの環境名がTalend Studioのコンテキスト環境名と同じ場合、新しいパラメーターの値はTalend Studioから取られます。それ以外の場合は、ソース環境で設定された値になります。
  * ターゲットタスクはソースタスクのタグでアップデートされます。
  * アーティファクトのプロモーションの場合、最新のアーティファクトのバージョンを使用するよう設定されていても、タスクはプロモートされたアーティファクトを使用しません。これは、この最新のアーティファクトのバージョンが公開済みのアーティファクトのバージョンしか参照しないためです。タスクがこのアーティファクトを使用できるようにするためには、最終的にこのアーティファクトを公開する前に、プロモートされたアーティファクトをテストする必要があります。
  * ターゲットタスクでアーティファクトの特定のバージョンが使用されている場合は、そのバージョンが使用され続け、自動的にアップデートするオプションは選択されません。ターゲットタスクでアーティファクトのバージョンを自動的にアップデートするオプションが使用されている場合は、ソースタスクで使われているバージョンへアップデートされ、このオプションも有効のままとなります。

情報メモ注: プロモーションワークフローは、タスクのプロモーション時にアーティファクトが意図せずにアップデートされないようデザインされています。

このため、プロモーションタスクがターゲット環境で初めて作成される場合、自動アップデートオプションの[Always use the latest available artifact version] (アーティファクトの最新バージョンを常に使用)は自動的に無効になります。

これにより、プロモートされたタスクを確認およびテストし、使用するアーティファクトの正しいバージョンを確定する前に、タスクが新しいアーティファクトのバージョンに誤ってアップデートされることはありません。

## パイプラインアーティファクトとタスク

Dynamic Engine環境ではまだサポートされていないため、パイプラインアーティファクトとパイプラインタスクはプロモートできません。

## プラン

* プランは、ターゲット環境に存在しない場合に作成されます。
* プランは、ターゲット環境に存在する場合にアップデートされます。

情報メモ注:

プラン自体、またはそのハンドラーのチェーン内にパイプラインタスクが含まれているプランはプロモートできず、プロモーション分析に警告メッセージが表示されます。パイプラインタスクは、Dynamic Engine環境ではまだサポートされていません。

## Studio接続

* Studio接続がターゲット環境に存在しない場合、同じ名前とタイプで接続が作成されます。
* Studio接続がターゲット環境に存在する場合、同じ名前とタイプで接続がアップデートされます。
  * パラメーターは変更されません。
  * 同じ名前の異なるタイプのStudio接続がターゲット環境に存在する場合、プロモーション分析にエラーが表示されます。プロモーションレポートにエラーが表示され、タスクがプロモートされません。
  * セキュリティ上の理由により、ターゲット環境では保護されているパラメーターの値が <change me>にリセットされます。手動で再入力する必要があります。

## Studioリソース

* Studioリソースは、ターゲット環境に存在しない場合に作成されます。
* オーバーライドまたはターゲットの維持:
  * リソースがターゲット環境に存在する場合、ソース環境の値で上書き(オーバーライド)されます 。

  * ターゲット環境にリソースが存在する場合、そのリソースは変更されずに維持され、割り当てられているタスクへの関連付けも保持されます(ターゲットの維持)。

  情報メモヒント: プロモーションにAPIを使用する場合、ターゲットリソースを上書きするには keepTargetResources=falseを設定し、既存のターゲットリソースを維持するには keepTargetResources=trueを設定してください。詳細は、[プロモーションを実行](https://talend.qlik.dev/apis/processing/2021-03/#operation_execute-a-promotion)をご覧ください。

## タスクスケジューラー

* タスクスケジューラーは、ターゲット環境に存在しない場合に作成されます。
* タスクスケジューラーは、ターゲット環境に存在する場合にアップデートされます。

## スペース

* ターゲット環境にスペースが存在しない場合は、空のロールを持つスペースが作成されます。

  管理者はターゲット環境でロールを作成する必要があります。

* スペースは、ターゲット環境に存在する場合にアップデートされます。

  スペース内のオブジェクトは、各オブジェクトタイプに固有のプロモーションルールに従ってアップデートされます。

情報メモ注:

Dynamic Engine環境でまだサポートされていないオブジェクトが含まれているスペースはプロモートできます。

* プロモートされたスペースの一部であるパイプラインのアーティファクト、タスク、プランはプロモートできず、プロモーション分析に警告メッセージが表示されます。

* プロモートされたスペースの一部であるデータサービス、およびルートのアーティファクトとタスクは、Remote Engine環境からプロモートできます。ただし、Dynamic Engine環境でそのようなアーティファクトを公開したり、データサービスやルートタスクを作成してデプロイしたりすることはできません。

## タスク/スペース/環境のRemote EngineまたはRemote Engine Gen2部分がプロモート済み

Talend Remote Engine (Gen1とも呼ばれる)とRemote Engine Gen2はプロモートできず、プロモーション分析に警告メッセージが表示されます。

## Remote Engineクラスター

Remote Engineクラスターはプロモートできず、プロモーション分析に警告メッセージが表示されます。

## [Run profile] (実行プロファイル)

* 実行プロファイルは、ターゲット環境に存在しない場合に作成されます。

  ターゲット環境内の関連タスクに、異なる名前の実行プロファイルがすでに割り当てられている場合、このソース環境から新規作成された実行プロファイルがをの割り当てを置き換えます。ターゲット実行プロファイルは割り当て解除されますが、保持されます。

* オーバーライドまたはターゲットの維持:

  * 実行プロファイルがターゲット環境に存在する場合、ソース環境の値で上書き(オーバーライド)されます 。

  * ターゲット環境に実行プロファイルが存在する場合、そのリソースは変更されずに維持され、割り当てられているタスクへの関連付けも保持されます(ターゲットの維持)。

  情報メモヒント: プロモーションにAPIを使用する場合、ターゲット実行プロファイルを上書きするには keepTargetRunProfiles=falseを設定し、既存のターゲット実行プロファイルを維持するにはkeepTargetRunProfiles=trueを設定してください。詳細は、[プロモーションを実行](https://talend.qlik.dev/apis/processing/2021-03/#operation_execute-a-promotion)をご覧ください。

* 選択したオプションにかかわらず、ターゲット環境にすでに存在する実行プロファイルは、プロモーション時に削除されません。

  * 上書きの場合、同じ名前の既存のターゲット実行プロファイルは割り当て解除されますが保持されます。そのため、孤立した実行プロファイルが環境内に蓄積されていく可能性があります。
  * 維持の場合、既存のターゲット実行プロファイルは、引き続きタスクに割り当てられたままとなります。

情報メモ注:

Remote Enginesとクラスターにリンクされている実行プロファイル:

* Remote Engineやクラスターにリンクされている実行プロファイルはプロモート可能です。新しい実行プロファイルが作成され、Dynamic Engine環境にリンクされます。ターゲット環境では、実行プロファイルはRemote Engineまたはクラスターにリンクされません。

* Remote Engine Gen2にリンクされている実行プロファイルはプロモートできず、プロモーション分析に警告メッセージが表示されます。