Red Hat SummitRed Hat Camel K is deprecated
Red Hat Camel K is deprecated and the End of Life date for this product is June 30, 2025. For help migrating to the current go-to solution, Red Hat build of Apache Camel, see the Migration Guide.Apache Camel K 1.6 の Red Hat ビルドのリリースノート
Apache Camel K の Red Hat ビルドの新機能
概要
第1章 Camel K リリースノート
Camel K は、OpenShift のクラウドでネイティブで実行される Apache Camel K からビルドされる軽量のインテグレーションフレームワークです。Camel K は、サーバーレスおよびマイクロサービスアーキテクチャー向けに特別に設計されています。Camel K を使用すると、Camel Domain Specific Language (DSL) で書かれたインテグレーションコードを直接 OpenShift で即座に実行することができます。
Camel K を OpenShift Serverless および Knative とともに使用すると、コンテナーは必要な場合のみ自動的に作成され、負荷時の自動スケーリングやゼロへのスケーリングが行われます。これにより、サーバーのプロビジョニングとメンテナーンスのオーバーヘッドがなくなり、アプリケーションの開発に集中することができます。
Camel K を OpenShift Serverless および Knative Eventing とともに使用すると、システムのコンポーネントがサーバーレスアプリケーションのイベント駆動型アーキテクチャーで通信する方法を管理できます。これにより、イベントプロデューサーとコンシューマー間の関係が切り離されたパブリッシュ/サブスクライブモデルまたはイベントストリーミングモデルを使用すると、柔軟性を提供し、効率化を実現できます。
1.1. Camel K の機能
Camel K は、以下の主要機能でクラウドネイティブインテグレーションを提供します。
- 自動スケーリングおよびゼロへのスケーリングを行うための Knative Serving
- イベント駆動型アーキテクチャーのための Knative Eventing
- デフォルトで Quarkus ランタイムを使用するパフォーマンスの最適化
- Java または YAML DSL で書かれた Camel インテグレーション
- OpenShift で Prometheus を使用したインテグレーションのモニターリング
- クイックスタートチュートリアル
- AWS、Jira、Salesforce などの外部システムへのコネクター用の Kamelet Catalog
- Timer および Log Kamelets のサポート
- Camel K オペレーターと Pod の計測
- IBM MQ コネクターのサポート
- Oracle19 データベースのサポート
1.2. サポートされる設定
Camel K でサポートされる設定、標準仕様、およびコンポーネントに関する詳細は、以下のカスタマーポータルの記事を参照してください。
1.2.1. Camel K Operator のメタデータ
Camel K には、OpenShift OperatorHub から Camel K をインストールするために使用される更新された Operator メタデータが含まれています。この Operator メタデータには、OpenShift Container Platform 4.6 以降との使用を目的に設計されたリリースパッケージの Operator バンドル形式が含まれます。
1.3. 重要事項
Red Hat Integration - Camel K リリースにおける重要事項
- Camel K での IBM MQ ソースコネクターのサポート
- IBM MQ ソースコネクター kamelet が最新の Camel K に追加されました。
- Oracle 19 のサポート
- Oracle 19 は、Camel K でサポートされるようになりました。詳細は、Camel K でサポートされる設定 ページを参照してください。
1.4. サポートされる Camel Quarkus エクステンション
ここでは、本リリースの Camel K でサポートされる Camel Quarkus エクステンションを一覧表示します (Camel K アプリケーション内で使用する場合のみ)。
これらの Camel Quarkus エクステンションは、Camel K アプリケーション内で使用される場合にのみサポートされます。これらの Camel Quarkus エクステンションは、スタンドアロンモード (Camel K なし) での使用はサポートされていません。
1.4.1. サポートされる Camel Quarkus コネクターエクステンション
以下の表は、本リリースの Camel K でサポートされる Camel Quarkus コネクターエクステンションを示しています (Camel K アプリケーション内で使用する場合のみ)。
| 名前 | パッケージ |
|---|---|
| AWS 2 Kinesis |
|
| AWS 2 Lambda |
|
| AWS 2 S3 Storage Service |
|
| AWS 2 Simple Notification System (SNS) |
|
| AWS 2 Simple Queue Service (SQS) |
|
| File |
|
| FTP |
|
| FTPS |
|
| SFTP |
|
| HTTP |
|
| JMS |
|
| Kafka |
|
| Kamelets |
|
| メトリクス |
|
| MongoDB |
|
| Salesforce |
|
| SQL |
|
| Timer |
|
1.4.2. サポートされる Camel Quarkus データフォーマットエクステンション
以下の表は、本リリースの Camel K でサポートされる Camel Quarkus データフォーマットエクステンションを示しています (Camel K アプリケーション内で使用する場合のみ)。
| 名前 | パッケージ |
|---|---|
| Avro |
|
| Bindy (CSV 用) |
|
| JSON Jackson |
|
| Jackson Avro |
|
1.4.3. サポートされる Camel Quarkus 言語エクステンション
本リリースでは、Camel K は以下の Camel Quarkus 言語エクステンションをサポートします (Camel 式および述語での使用)。
- Constant
- ExchangeProperty
- File
- Header
- Ref
- Simple
- Tokenize
- JsonPath
1.4.4. サポートされる Camel K トレイト
本リリースでは、Camel K は以下の Camel K トレイトをサポートします。
- Builder トレイト
- Camel トレイト
- Container トレイト
- Dependencies トレイト
- Deployer トレイト
- Deployment トレイト
- Environment トレイト
- JVM トレイト
- Kamelets トレイト
- Owner トレイト
- Platform トレイト
- Pull Secret トレイト
- Prometheus トレイト
- Quarkus トレイト
- Route トレイト
- Service トレイト
- Error Handler トレイト
1.5. サポート対象の Kamelets
以下の表には、Camel K Operator をインストールする際に OpenShift リソースとして提供される kamelets が記載されています。
これらの kamelets の詳細は、https://github.com/openshift-integration/kamelet-catalog/tree/kamelet-catalog-1.6 を参照してください。
kamelets を使用してアプリケーションおよびサービスを接続する方法の詳細は、https://access.redhat.com/documentation/ja-jp/red_hat_integration/2022.q1/html-single/integrating_applications_with_kamelets を参照してください。
テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は実稼働環境でこれらを使用することを推奨していません。
テクノロジープレビューの機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。
| Kamelet | ファイル名 | タイプ (シンク、ソース、アクション) |
|---|---|---|
| Avro デシリアライズアクション |
| アクション (データ変換) |
| Avro シリアライズアクション |
| アクション (データ変換) |
| AWS Redshift シンク |
| シンク |
| AWS 2 Kinesis シンク |
| シンク |
| AWS 2 Kinesis ソース |
| Source |
| AWS 2 Lambda シンク |
| シンク |
| AWS 2 Simple Notification System シンク |
| シンク |
| AWS 2 Simple Queue Service シンク |
| シンク |
| AWS 2 Simple Queue Service ソース |
| Source |
| AWS 2 Simple Queue Service FIFO シンク |
| シンク |
| AWS 2 S3 シンク |
| シンク |
| AWS 2 S3 ソース |
| Source |
| AWS 2 S3 ストリーミングアップロードシンク |
| シンク |
| Cassandra シンク (テクノロジープレビュー) |
| シンク |
| Cassandra ソース (テクノロジープレビュー) |
| Source |
| Elasticsearch インデックスシンク (テクノロジープレビュー) |
| シンク |
| フィールドアクションの抽出 |
| アクション |
| FTP シンク |
| シンク |
| FTP ソース |
| Source |
| ヘッダーフィルターアクションあり |
| Action(データ変換) |
| Hoist フィールドアクション |
| アクション |
| HTTP シンク |
| シンク |
| フィールドアクションの挿入 |
| Action(データ変換) |
| Header アクションの挿入 |
| Action(データ変換) |
| Tombstone Filter アクション |
| Action(データ変換) |
| JIRA ソース (テクノロジープレビュー) |
| Source |
| JMS シンク |
| シンク |
| JMS ソース |
| Source |
| JMS IBM MQ シンク |
| シンク |
| JMS IBM MQ ソース |
| Source |
| JSON デシリアライズアクション |
| アクション (データ変換) |
| JSON シリアライズアクション |
| アクション (データ変換) |
| Kafka シンクコ |
| シンク |
| Kafka ソース |
| Source |
| Kafka トピック名フィルターアクション |
| Action(データ変換) |
| ログシンク (開発およびテスト用) |
| シンク |
| MariaDB シンク |
| シンク |
| mask フィールドアクション |
| Action(データ変換) |
| メッセージタイムスタンプルーターアクション |
| アクション (ルーター) |
| MongoDB シンク |
| シンク |
| MongoDB ソース |
| Source |
| MySQL シンクコネクター |
| シンク |
| PostgreSQL シンクコネクター |
| シンク |
| 述語フィルターアクション |
| アクション (ルーター/フィルター) |
| Protobuf デシリアライズアクション |
| アクション (データ変換) |
| Protobuf シリアライズアクション |
| アクション (データ変換) |
| regex ルーターのアクション |
| アクション (ルーター) |
| フィールドアクションの置き換え |
| アクション |
| Salesforce ソース |
| Source |
| SFTP シンク |
| シンク |
| SFTP ソース |
| Source |
| Slack ソース |
| Source |
| SQL サーバーデータベースシンク |
| シンク |
| Telegram ソース (テクノロジープレビュー) |
| Source |
| タイマーソース (開発およびテスト用) |
| Source |
| ルーターアクションのタイムスタンプ |
| アクション (ルーター) |
| キーアクションに対する値 |
| Action(データ変換) |
1.6. Camel K の既知の問題
以下の既知の問題は Camel K に適用されます。
ENTESB-15306 - CRD conflicts between Camel K and Fuse Online
古いバージョンの Camel K が同じ OpenShift クラスターにインストールされたことがある場合、カスタムリソース定義との競合により、OperatorHub から Camel K のインストールに失敗します。たとえば、これには Fuse Online で以前使用できた古いバージョンの Camel K が含まれます。
この問題を回避するには、Camel K を別の OpenShift クラスターにインストールするか、Camel K をインストールする前に以下のコマンドを入力します。
$ oc get crds -l app=camel-k -o json | oc delete -f -
ENTESB-15858 - Added ability to package and run Camel integrations locally or as container images
ローカルでの Camel インテグレーションのパッケージ化および実行、またはコンテナーイメージとしての Camel インテグレーションのパッケージ化および実行は、現在 Camel K には含まれておらず、コミュニティーのみによるサポートの対象となります。
詳細は Apache Camel K community を参照してください。
ENTESB-16477 - Unable to download jira client dependency with productized build
Camel K Operator を使用する場合、インテグレーションは jira クライアントの依存関係を見つけることができません。回避策として、atlassian リポジトリーを手動で追加します。
apiVersion: camel.apache.org/v1
kind: IntegrationPlatform
metadata:
labels:
app: camel-k
name: camel-k
spec:
configuration:
- type: repository
value: <atlassian repo here>ENTESB-17033 - Camel-K ElasticsearchComponent options ignored
Elasticsearch コンポーネントを設定する場合、Camel K ElasticsearchComponent オプションは無視されます。回避策として、Elasticsearch コンポーネントの使用時に getContext().setAutowiredEnabled(false) を追加します。
ENTESB-17061 - Can't run mongo-db-source kamelet route with non-admin user - Failed to start route mongodb-source-1 because of null
管理者でないユーザー認証情報で mongo-db-source kamelet ルートを実行することはできません。コンポーネントの一部には管理者の認証情報が必要なため、管理者以外のユーザーとしてルートを実行することはできません。
1.7. Camel K の修正された問題
以下のセクションには、Camel K 1.6.6 で修正された問題が記載されています。
1.7.1. Camel K 1.6.6 で改良された機能
以下の表には、Camel K 1.6.6 で改良された機能が記載されています。
| 問題 | 説明 |
|---|---|
| Camel-K pov から KNative ドキュメントを再確認する | |
| Quickstarts と Kamelets のテストストラテジーを考案する | |
| AWS Redshift シンク Kamelet の追加 | |
| Openjdk と Zlib の新しいベースレイヤーイメージを取り込むための Camel K 1.6.x。 |
1.7.2. Camel K 1.6.6 で解決されたバグ
以下の表には、Camel K 1.6.6 で解決されたバグが記載されています。
| 問題 | 説明 |
|---|---|
| 最初のメッセージが送信された後、camel -slack プロデューサーが失敗する | |
| eventstreaming quickstart: yaks のテストに失敗する | |
| kamel get は、Pod が実行されていないときに実行ステータスを報告する | |
| kameletBinding GoogleSheetsSource 遅延パラメーターの誤動作 | |
| Kamelets: null 用の Elasticsearch インデックスシンク indexId ランダムジェネレーター | |
| Cassandra シンク kamelet が不明なプロパティーで失敗する | |
| Cassandra ソースの Consistency のデフォルト値は使用できない | |
| kamel のインストールでの間違ったイメージ --olm=false | |
| クイックスタート camel-k-example-event-streaming は無効な kafka インスタンスを作成する | |
| クイックスタート Camel K の yaks test OpenAQConsumer.feature のタイポ: イベントストリーミングの例 | |
| XML イニシャライザーで生成された間違った XSD url | |
| Camel-k Operator イメージグレード B |
第2章 Apache Camel K Operator の Red Hat ビルド
Apache Camel K 1.6 の Red Hat ビルドには、Apache Camel K Operator 1.3 の Red Hat ビルドが導入されています。
Red Hat ビルドの Apache Camel K は、OpenShift での Red Hat ビルドApache Camel K コンポーネントのデプロイを自動化する Operator を提供します。Red Hat ビルドの Apache Camel K Operator を使用して、これらの Operator を管理できます。
そのため、各コンポーネント operator を個別に管理できます。このセクションでは、Operator を紹介し、Operator を使用して Red Hat ビルドの Apache Camel K コンポーネントをデプロイする方法に関する詳細情報へのリンクを提供します。
2.1. Operator とは
Operator は、Kubernetes アプリケーションのパッケージ化、デプロイメント、および管理を行う方法です。operator は運用上の人間の知識を仕様し、これをコンシューマーと簡単に共有できるソフトウェアにエンコードして、一般的なタスクや複雑なタスクを自動化します。
OpenShift Container Platform 4.x では、Operator Lifecycle Manager (OLM) を使用すると、ユーザーはすべての Operator とクラスター全体で実行される関連サービスをインストールおよび更新することができ、それらの Operator と関連サービスのライフサイクルを管理できます。これは、Kubernetes のネイティブアプリケーション (Operator) を効果的かつ自動化されたスケーラブルな方法で管理するために設計されたオープンソースツールキットである Operator Framework の一部です。
OLM は OpenShift Container Platform 4.x でデフォルトで実行されます。これは、クラスター管理者がクラスターで実行している Operator をインストールおよびアップグレードし、アクセスを付与するのに役立ちます。OpenShift Container Platform Web コンソールは、クラスター管理者が Operator をインストールし、クラスターで利用可能な Operator のカタログを使用するために特定のプロジェクトにアクセスを付与するための管理画面を提供します。
OperatorHub は、OpenShift クラスター管理者が Operator を検出、インストール、およびアップグレードするために使用するグラフィカルインターフェイスです。1 回クリックするだけで、これらの Operator を OpenHub からプルし、クラスターにインストールすることができ、OLM で Operator を管理することで、開発、テスト、および実稼働環境のソフトウェアをエンジニアリングチームが独自に管理することが可能です。
関連情報
- Operator に関する詳細は、OpenShift のドキュメント を参照してください。
2.2. Red Hat ビルドの Apache Camel K コンポーネント Operator
たとえば、3scale Operator、Camel K Operator などを使用して、Apache Camel K コンポーネント Operator の各 Red Hat ビルドを個別にインストールおよびアップグレードできます。
2.2.1. 3scale Operators
2.2.2. AMQ Operator
2.2.3. Camel K Operator
2.2.4. Fuse Operator
2.2.5. Service Registry Operator
2.3. Apache Camel K Operator の Red Hat ビルド (非推奨)
Red Hat Integration Operator 1.3 を使用して、Apache Camel K コンポーネント Operator の複数の Red Hat ビルドをインストールおよびアップグレードできます。
- 3scale
- 3scale APIcast
- AMQ Broker
- AMQ Interconnect
- AMQ Streams
- API Designer
- Camel K
- Fuse Console
- Fuse Online
- Service Registry
Red Hat Integration Operator は非推奨となり、今後削除予定です。OpenShift 4.6 から 4.10 では、OperatorHub で利用できる予定です。個々の Red Hat Integration コンポーネント Operator は引き続きサポートされ、個別にインストールできます。
2.3.1. サポートされるコンポーネント
Red Hat Integration Operator 1.3 を使用して Operator をインストールする前に、コンポーネントのリリースノートで更新を確認します。サポートされるバージョンのリリースノートには、追加のアップグレード要件が記載されています。
- オンプレミス型 Red Hat 3scale API Management 2.10 向けリリースノート
- Red Hat AMQ Broker 7.8 のリリースノート
- Red Hat AMQ Interconnect 1.10 のリリースノート
- Red Hat AMQ Streams 2.0 on OpenShift リリースノート
- Red Hat Fuse 7.10 リリースノート (Fuse および API Designer)
- Release Notes for Red Hat Integration 2021.Q3 (Red Hat Integration - Service Registry 2.0 release notes)
- Red Hat Integration 2021.Q4 リリースノート (Camel K リリースノート)
AMQ Streams の新しい API バージョン
Red Hat Integration Operator 1.3 は、AMQ Streams 2.0 の Operator をインストールします。
AMQ Streams バージョン 1.8 以降にアップグレードする前に、API バージョン v1beta2 を使用するようにカスタムリソースをアップグレードする必要があります。
AMQ Streams 1.7 では、AMQ Streams カスタムリソースのスキーマを更新する v1beta2 API バージョンが導入されました。古い API バージョンは非推奨になりました。AMQ Streams 1.7 にアップグレードした後、AMQ Streams 2.0 にアップグレードする前に、API バージョン v1beta2 を使用するようにカスタムリソースをアップグレードする必要があります。
バージョン 1.7 より前の AMQ Streams バージョンからアップグレードする場合は、以下を行います。
- AMQ Streams 1.7 へのアップグレード
- カスタムリソースを v1beta2 に変換します。
- AMQ Streams 2.0 へのアップグレード
詳細は、以下のドキュメントを参照してください。
カスタムリソースおよび CRD がバージョン v1beta2 に変換されていない場合、AMQ Streams Operator をバージョン 2.0 にアップグレードすると、クラスターに失敗します。アップグレードは Pending で停止します。この場合は、以下を実行します。
- Red Hat ソリューション (Forever pending cluster operator upgrade) で説明されている手順を実行します。
- Integration Operator をゼロにスケーリングしてから 1 に戻し、AMQ Streams 2.0 Operator のインストールをトリガーします。
Service Registry 2.0 の移行
Red Hat Integration Operator は Red Hat Integration - Service Registry 2.0 をインストールします。
Service Registry 2.0 は、手動でアンインストールする必要がある Service Registry 1.x インストールを置き換えません。
Service Registry バージョン 1.x から 2.0 への移行に関する詳細は、Service Registry 2.0 release notes を参照してください。
2.3.2. サポートライフサイクル
サポートされている設定を維持するには、Apache Camel K Operator バージョンの最新の Red Hat ビルドをデプロイする必要があります。Apache Camel K Operator リリースバージョンの各 Red Hat ビルドは、3 か月間のみサポートされます。
2.3.3. 修正された問題
Red Hat Integration Operator 1.3 で修正された問題はありません。
関連情報
- Apache Camel K コンポーネント Operator の複数の Red Hat ビルドの管理の詳細は、OpenShift への Red Hat Integration Operator のインストール を参照してください。
