POMファイルの再生成、パッチのインストール、カスタムスクリプトの作成
プロジェクトを新しいバージョンに移行したい場合は、ビルド時に-Dpatch.pathオプションによるパッチ(Talend Studioマンスリーリリースパッチ、マニュアルパッチ、コンポーネントパッチなど)のインストールが必要になることがあります。
POMファイルをすべて再生成できるオプションは、org.talend.ci:builder-maven-pluginの7.3.3 (R2020-08から追加)以降のバージョンで利用できます。
このオプションの主な利点は、パッチをTalend Studioに適用する前に、継続的インテグレーションを使って1つ(または複数)の既存プロジェクトでバージョンをアップグレードしたり、パッチをテストしたりできることです。
適用の前にまず以下のステップを行うことをお勧めします。
- Gitプロジェクトをチェックアウトします。git checkout (英語のみ)コマンドについてはGitのドキュメンテーションをお読みください。
- このドキュメンテーションに従ってパッチを手動でダウンロードします。
- プロジェクトのワークスペースのPOMファイルをすべて再生成し、テストしたいパッチをインストールします。 情報メモ注: Gitプロジェクトがチェックアウトされたディレクトリーでコマンドを実行し、Talend CommandLineアプリケーションが起動していることを確認します。
ローカルにインストールされた2つのパッチの例:
# To re-generate all pom files and install a patch mvn org.talend.ci:builder-maven-plugin:7.3.4:generateAllPoms -Dproduct.path=/home/talend/talend_studio -Dlicense.path=/home/talend/talend_studio/license -Dupdatesite.path=/home/talend/talend_studio/Talend_Full_Studio_p2_repository-V7.x.x/ -Dpatch.path=D:/patches/Patch_TPS-2222.zip,D:/patches/Patch_TPS-3333.zip
情報メモヒント: 移行の場合、全プロジェクトについてPOMファイルを再生成したいことがありますが、特定のアーティファクトでフィルタリングしたい場合は-DitemFilterコマンドを使用できます。例: 名前にCI_Jobsが含まれているアーティファクトでフィルタリングする場合は、-DitemFilter="label=CI_Jobs"を使います。
異なるインストールパスを使用したいTalend Installerユーザーのための例です。この方法では、-Dproduct.path値で定義されたパスに従って個別のインストールが実行されます。
# To patch the product of your choice using different product paths mvn org.talend.ci:builder-maven-plugin:7.3.x:generateAllPoms -Dproduct.path=/home/installation/commandline_R202109 -Dp2Installer.path=/home/.installation/.p2Installer -Dpatch.path=/home/patches/R202109.zip
また、POMファイルをすべて再生成するカスタムスクリプトを作成することもできます:
-
名前がCIで始まるプロジェクトにあるPOMファイルをすべて再生成するスクリプトの例:
# To create the custom script cat /home/talend/talend_studio/script.txt regenerateAllPoms # To execute the custom script mvn org.talend.ci:builder-maven-plugin:<version>:executeScript -Dproduct.path=/home/talend/talend_studio -Dlicense.path=/home/talend/talend_studio/license -Dupdatesite.path=/home/talend/talend_studio/Talend_Full_Studio_p2_repository-V7.x.x/ -DscriptFile=/home/talend/talend_studio/script.txt
情報メモヒント: 移行の場合、全プロジェクトについてPOMファイルを再生成したいことがありますが、特定のプロジェクトでフィルタリングしたい場合は-DprojectFilterコマンドを使用できます。例: 名前がCI.で始まるプロジェクトでフィルタリングする場合は、-DprojectFilter="CI.*"を使います。
-
changeMavenVersionコマンドを使用し、Mavenバージョンを変更して、項目ファイルとPOMファイルを一度にアップデートするスクリプトの例:
# The content of the script named upgrade_version.txt logonProject -pn gitProject -ul 'jobbuilder@talend.com' -gt changeMavenVersion 1.0.5 --item-filter 'label%*test5_pere*' --subjobs --snapshot regenerateAllPoms # To execute the custom script mvn org.talend.ci:builder-maven-plugin:<version>:executeScript -s ./maven_settings.xml -Dgeneration.type=local -Dproduct.path=/opt/Talend/studio -Dlicense.path=/opt/Talend/studio/license -DscriptFile=/home/talend/upgrade_version.txt
-
- 既存のプロジェクトやジョブの生成をテストします。パッケージMavenフェーズによる生成の例:
# To test projects/Jobs generation mvn clean package -Dproduct.path=/home/talend/talend_studio/ -Dlicense.path=/home/talend/talend_studio/license -Dupdatesite.path=/home/talend/talend_studio/Talend_Full_Studio_p2_repository-V7.x.x/
- プロジェクトの生成が成功した場合は、このドキュメンテーションに従ってテスト済みパッチをTalend Studioに適用します。テストが成功しなかった場合は、Qlikサポートにご連絡ください。