Fuse 7 アプリケーションの Red Hat build of Apache Camel for Quarkus への移行

手順

1. Web サイト code.quarkus.redhat.com を使用して、この例で使用する次のエクステンションを選択します。

   • camel-quarkus-xml-io-dsl
   • camel-quarkus-file
   • camel-quarkus-xpath
2. Generate your application を選択して選択内容を確認し、生成されたプロジェクトを含むアーカイブのダウンロードリンクが記載されたオーバーレイ画面を表示します。
3. Download the ZIP を選択して、生成されたプロジェクトファイルを含むアーカイブをマシンに保存します。
4. アーカイブの内容をデプロイメントします。

5. 直前の手順で生成されたプロジェクトファイルの展開先ディレクトリーに移動します。

   $ cd <directory_name>

   Copy to Clipboard Toggle word wrap
6. src/main/resources/routes/ ディレクトリーに camel-routes.xml という名前のファイルを作成します。

7. 次の例 blueprint-example.xml の <route> 要素とサブ要素を camel-routes.xml ファイルにコピーします。

   blueprint-example.xml

   <blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0">
       <camelContext id="cbr-example-context" xmlns="http://camel.apache.org/schema/blueprint">
           <route id="cbr-route">
               <from id="_from1" uri="file:work/cbr/input"/>
               <log id="_log1" message="Receiving order ${file:name}"/>
               <choice id="_choice1">
                   <when id="_when1">
                       <xpath id="_xpath1">/order/customer/country = 'UK'</xpath>
                       <log id="_log2" message="Sending order ${file:name} to the UK"/>
                       <to id="_to1" uri="file:work/cbr/output/uk"/>
                   </when>
                   <when id="_when2">
                       <xpath id="_xpath2">/order/customer/country = 'US'</xpath>
                       <log id="_log3" message="Sending order ${file:name} to the US"/>
                       <to id="_to2" uri="file:work/cbr/output/us"/>
                   </when>
                   <otherwise id="_otherwise1">
                       <log id="_log4" message="Sending order ${file:name} to another country"/>
                       <to id="_to3" uri="file:work/cbr/output/others"/>
                   </otherwise>
               </choice>
               <log id="_log5" message="Done processing ${file:name}"/>
           </route>
       </camelContext>
   </blueprint>

   Copy to Clipboard Toggle word wrap

   camel-routes.xml

   <route id="cbr-route">
       <from id="_from1" uri="file:work/cbr/input"/>
       <log id="_log1" message="Receiving order ${file:name}"/>
       <choice id="_choice1">
           <when id="_when1">
               <xpath id="_xpath1">/order/customer/country = 'UK'</xpath>
               <log id="_log2" message="Sending order ${file:name} to the UK"/>
               <to id="_to1" uri="file:work/cbr/output/uk"/>
           </when>
           <when id="_when2">
               <xpath id="_xpath2">/order/customer/country = 'US'</xpath>
               <log id="_log3" message="Sending order ${file:name} to the US"/>
               <to id="_to2" uri="file:work/cbr/output/us"/>
           </when>
           <otherwise id="_otherwise1">
               <log id="_log4" message="Sending order ${file:name} to another country"/>
               <to id="_to3" uri="file:work/cbr/output/others"/>
           </otherwise>
       </choice>
       <log id="_log5" message="Done processing ${file:name}"/>
   </route>

   Copy to Clipboard Toggle word wrap

8. application.properties を修正します。

   # Camel
   #
   camel.context.name = camel-quarkus-xml-io-dsl-example
   camel.main.routes-include-pattern = file:src/main/resources/routes/camel-routes.xml

   Copy to Clipboard Toggle word wrap

9. CEQ アプリケーションをコンパイルします。

   mvn clean compile quarkus:dev

   Copy to Clipboard Toggle word wrap
   注記

   このコマンドでは、プロジェクトのコンパイル、アプリケーションの起動、Quarkus ツールでのワークスペースの変更監視などを行います。プロジェクトの変更は自動的に実行中のアプリケーションに適用されます。

1. Quarkus Getting Started ガイドの Quarkus エクステンションレジストリークライアントの設定 セクションで説明されているとおり、エクステンションレジストリークライアントを設定します。

2. Maven を使用して更新します。

   プロジェクトディレクトリーに移動し、プロジェクトを最新のストリームに更新します。

   1. Quarkus Maven プラグインのバージョンが、サポートされている最新の Red Hat build of Quarkus バージョンと一致していることを確認してください。

   2. 次のコマンドを使用して更新を実行します。

      mvn io.quarkus.platform:quarkus-maven-plugin:3.5.2:update -N

      Copy to Clipboard Toggle word wrap

      マルチモジュールプロジェクト の場合は、次のコマンドを使用します。

      find . -type f -name "pom.xml" -execdir sh -c 'mvn io.quarkus.platform:quarkus-maven-plugin:3.5.2:update -N'  \;

      Copy to Clipboard Toggle word wrap

      オプション

      デフォルトでは、このコマンドは最新の現行バージョンに更新します。最新の現行バージョンではなく特定のストリームに更新するには、このコマンドに stream オプションを追加し、その後にバージョンを追加します (例: --Dstream=3.2)。

      注記

      マルチモジュールプロジェクトを更新すると、更新ツールが <packaging>pom</packaging> を使用してモジュールを更新できないため、多くのエラーが表示される場合があります。

      そのようなモジュールが存在する場合 (通常は複数のバージョンが含まれています)、手動で更新します。

3. 考えられる指示の更新コマンド出力を分析し、必要に応じて提案されたタスクを実行します。
4. diff ツールを使用してすべての変更を検査します。
5. 更新コマンドで更新されなかった項目については、移行ガイドを確認してください。プロジェクトにそのような項目がある場合は、これらのトピックでアドバイスされている追加の手順を実行ます。
6. 実稼働環境にデプロイする前に、プロジェクトがエラーなくビルドされ、すべてのテストが合格し、アプリケーションが求められるとおりに機能することを確認します。

7. 更新後の Quarkus アプリケーションを実稼働環境にデプロイする前に、以下を確認します。

   • プロジェクトはエラーなしでビルドされる。
   • すべてのテストに合格する。
   • アプリケーションが求められるとおりに機能する。