Red Hat Summit6.8. Red Hat build of Apache Camel for Quarkus へのエクスポート
Camel CLI 統合を従来の Java ベースのプロジェクトに export できます。Camel CLI を使用してプロトタイプをビルドした後、Java コーディングがさらに必要な従来の Java ベースのプロジェクトが必要な場合、または Quarkus もしくは vanilla Camel Main の強力なランタイムを使用する場合に、これを実行するとよいでしょう。
6.8.1. Red Hat build of Apache Camel for Quarkus へのエクスポート
コマンド export --runtime=quarkus は、現在の Camel CLI ファイルを、src/main/ フォルダー構造で編成されたファイルとともに Maven ベースのプロジェクトにエクスポートします。
たとえば、quarkus ランタイム、maven groupID com.foo、artifactId acme、およびバージョン 1.0-SNAPSHOT を使用して、camel-quarkus-jbang ディレクトリーにエクスポートするには、次を実行します。
例
camel export --runtime=quarkus --gav=com.foo:acme:1.0-SNAPSHOT --quarkus-group-id=com.redhat.quarkus.platform --quarkus-version=3.15.4.redhat-00001 --dep=org.apache.camel.quarkus:camel-quarkus-timer,org.apache.camel.quarkus:camel-quarkus-management,org.apache.camel.quarkus:camel-quarkus-cli-connector --repos=https://maven.repository.redhat.com/ga,https://packages.atlassian.com/maven-external --directory=camel-quarkus-jbang
これにより、current ディレクトリーにエクスポートされます。これは、ファイルが必要なフォルダー構造に移動されることを意味します。
別のディレクトリーにエクスポートするには、次を実行します。
camel export --runtime=quarkus --gav=com.foo:acme:1.0-SNAPSHOT --directory=../myproject
エクスポートする場合、pom.xml または build.gradle で定義された Camel バージョンは、Camel CLI が使用するバージョンと同じです。ただし、次のように別の Camel バージョンを指定できます。
camel export --runtime=quarkus --gav=com.foo:acme:1.0-SNAPSHOT --directory=../myproject --quarkus-version=3.15.4.redhat-00001
詳細は、camel export --help コマンドを実行して、使用可能なオプションを確認してください。
6.8.2. Camel CLI を含めたエクスポート
Quarkus または Camel Main にエクスポートする場合、Camel JBang CLI はそのままでは含まれません。Camel CLI (Camel) を引き続き使用するには、次のように --dep オプションに Camel:cli-connector を追加する必要があります。
camel export --runtime=quarkus --gav=com.foo:acme:1.0-SNAPSHOT --dep=camel:cli-connector --directory=../myproject6.8.3. エクスポートの設定
デフォルトでは、export コマンドは application.properties ファイルから設定をロードします。このファイルは、ランタイムや Java バージョンの選択などの特定のパラメーターをエクスポートするために使用されます。
exporting に関連する次のオプションは、application.properties ファイルで設定できます。
| オプション | 説明 |
|---|---|
|
|
ランタイム ( |
|
| Maven group:artifact:version |
|
| 追加の依存関係 (複数の依存関係を区切るにはコンマを使用します)。詳細は、カスタム JAR の追加 を参照してください。 |
|
| クラスパスに追加する追加ファイル (複数のファイルを区切るにはコンマを使用します)。詳細は、カスタム JAR の追加 を参照してください。 |
|
| Java バージョン (11 または 17) |
|
| Apache Camel Kamelets のバージョン |
|
| Kamelets をロードするためのローカルディレクトリー |
|
| Quarkus Platform Maven groupId |
|
| Quarkus Platform Maven artifactId |
|
| Quarkus Platform バージョン |
|
| エクスポートされたプロジェクトに Maven ラッパーファイルを含める |
|
| エクスポートされたプロジェクトに Gradle Wrapper ファイルを含める |
|
| 使用するビルドツール (maven または gradle) |
|
| オンデマンドでダウンロードするための追加の Maven リポジトリー (複数のリポジトリーを区切るにはコンマを使用します) |
|
| サーバー、リポジトリー、ミラー、プロキシーを設定するための Maven setting.xml ファイルのオプションの場所。false に設定すると、デフォルトの ~/.m2/settings.xml も使用されません。 |
|
| settings.xml を復号化するための Maven settings-security.xml ファイルのオプションの場所 |
|
| プロジェクトがエクスポートされるディレクトリー。 |
|
| --console が有効な場合など、スタンドアロン Camel を実行するときに使用する HTTP サーバーポート (デフォルトではポート 8080)。 |
|
| スタンドアロン Camel を実行している場合、ローカル HTTP サーバー (デフォルトではポート 8080) 上の /q/dev にある開発者コンソール。 |
|
| スタンドアロン Camel を実行している場合は、ローカル HTTP サーバー (デフォルトではポート 8080) の /q/health でヘルスチェックを行います。 |
これらは、export コマンドのオプションです。詳細とデフォルト値を表示するには、camel export --help を実行します。
6.8.4. 設定
Camel CLI の config コマンドは、ユーザー設定を保存および使用するために使用されます。これにより、毎回 CLI オプションを指定する必要がなくなります。たとえば、別の Camel バージョンを実行するには、次を使用します。
例
camel run * --camel-version=4.8
camel-version は次のようなユーザー設定に追加できます。
camel config set camel-version=4.8
run コマンドはユーザー設定を使用します。
camel run *
ユーザー設定ファイルは ~/.camel-jbang-user.properties に保存されます。
6.8.4.1. 設定と設定解除
すべての Camel CLI オプションはユーザー設定に追加されます。以下に例を示します。
例
camel config set gav=com.foo:acme:1.0-SNAPSHOT
camel config set runtime=quarkus
camel config set deps=org.apache.camel.quarkus:camel-timer,camel:management,camel:cli-connector
camel config set camel-version=4.8
camel config set camel-quarkus-version=3.15設定をエクスポートするには、以下を実行します。
camel exportcamel アプリケーションを初期化するには、以下を実行します。
camel init foo.yamlcamel アプリケーションを実行するには、以下を実行します。
camel run foo.yaml --https://maven.repository.redhat.com/ga,https://packages.atlassian.com/maven-externalユーザー設定キーを設定解除するには、以下を実行します。
camel config unset camel-quarkus-version6.8.4.2. 設定のリスト表示と取得
ユーザー設定キーをリスト表示するには、以下を使用します。
camel config list上記の設定では、次の出力が生成されます。
runtime = quarkus
deps = org.apache.camel.springboot:camel-timer-starter
gav = com.foo:acme:1.0-SNAPSHOT
特定のキーの値を取得するには、get コマンドを使用します。
camel config get gav
com.foo:acme:1.0-SNAPSHOT6.8.4.3. プレースホルダー置換
ユーザー設定値は、コマンドラインプロパティーのプレースホルダーとして使用できます。次に例を示します。
例
camel config set repos=https://maven.repository.redhat.com/ga
camel run 'Test.java' --logging-level=info --repos=#repos,https://packages.atlassian.com/maven-externalこの例では、ユーザー設定 (config set) でリポジトリーが設定されており、camel run コマンドでプレースホルダー #repos が宣言されているため、camel run によってプレースホルダーが置き換えられ、実行中に両方のリポジトリーが使用されます。設定値を参照する場合、構文は #optionName (例: #repos) であることに注意してください。
プレースホルダー置換は、特定の Camel コマンドが持つ各オプションに対してのみ機能します。camel run --help を使用すると、コマンドが持つすべてのオプションを確認できます。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}