Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

Apicurio Registry 3.1 リリースノート

Red Hat build of Apicurio Registry 3.1

Red Hat build of Apicurio Registry の新機能

Red Hat build of Apicurio Registry Documentation Team

概要

Red Hat build of Apicurio Registry 製品を説明し、このリリースの新機能に関する最新の詳細を提供します。

はじめに
リンクのコピー

Red Hat ドキュメントへのフィードバック

Red Hat ドキュメントに関するご意見やご感想をお寄せください。

改善を提案するには、Jira 課題を作成し、変更案を説明してください。ご要望に迅速に対応できるよう、できるだけ詳細にご記入ください。

前提条件

  • Red Hat カスタマーポータルのアカウントがある。このアカウントを使用すると、Red Hat Jira Software インスタンスにログインできます。
    アカウントをお持ちでない場合は、アカウントを作成するように求められます。

手順

  1. Create issue にアクセスします。
  2. Summary テキストボックスに、問題の簡単な説明を入力します。

  3. Description テキストボックスに、次の情報を入力します。

    • 問題が見つかったページの URL。
    • 問題の詳細情報。
      他のフィールドの情報はデフォルト値のままにすることができます。
  4. Create をクリックして、Jira 課題をドキュメントチームに送信します。

フィードバックをご提供いただきありがとうございました。

第1章 Apicurio Registry 3.1 リリースノート
リンクのコピー

Red Hat build of Apicurio Registry は、Apicurio Registry オープンソースコミュニティープロジェクトをベースとする標準イベントスキーマおよび API デザインのデータストアです。

Apicurio Registry を使用して、Web コンソール、REST API、Maven プラグイン、または Java クライアントを使用してデータの構造を管理および共有できます。たとえば、クライアントアプリケーションは、再デプロイせずに最新のスキーマ更新を Apicurio Registry に動的にプッシュまたはプルできます。オプションのルールを作成して、Apicurio Registry のコンテンツが時間とともにどのように進化するかを管理することもできます。このルールには、コンテンツの検証、アーティファクト参照の整合性、スキーマまたは API バージョンの下位互換性または上位互換性が含まれます。

1.1. Apicurio Registry のインストールオプション
リンクのコピー

次のデータストレージオプションのいずれかを使用して、OpenShift に Apicurio Registry をインストールできます。

  • PostgreSQL データベース
  • Red Hat Streams for Apache Kafka

詳細は、OpenShift への Red Hat build of Apicurio Registry のインストールとデプロイ を参照してください。

1.2. Apicurio Registry がサポートするプラットフォーム
リンクのコピー

Apicurio Registry 3.1 は、次のコアプラットフォームをサポートしています。

  • Red Hat OpenShift Container Platform: 4.19、4.18、4.17、4.16
  • Red Hat OpenShift Service on AWS: 4.18
  • Microsoft Azure Red Hat OpenShift: 4.17
  • PostgreSQL: 17、17、16、15、14、13
  • Red Hat Streams for Apache Kafka: 2.9、2.8
  • OpenJDK: 17、11

詳細は、次の記事を参照してください。

1.2.1. 他の製品とのインテグレーションをサポート
リンクのコピー

Apicurio Registry 3.1 は、次の製品との統合もサポートしています。

  • Red Hat build of Keycloak 26、24
  • Red Hat Single Sign-On (RH-SSO) 7.6
  • Red Hat build of Debezium 2.7

1.3. Apicurio Registry の新機能
リンクのコピー

Apicurio Registry 3 リリースでは、重大な変更を含むいくつかの重要な更新、機能拡張、新機能が導入されています。Apicurio Registry 3.1 には、次の新機能が含まれています。

プレースホルダーアーティファクト
このリリースでは、初期コンテンツなしでプレースホルダーとしてアーティファクトを作成する機能が導入されました。プレースホルダーアーティファクトを使用すると、ユーザーは作成時に検証およびガバナンスルールをすぐに適用できるため、コンテンツが追加される前からコンプライアンスを確保できます。この機能により、事前にルールを設定し、後からコンテンツを追加できるようになることで、ライフサイクル管理が強化されます。
ブランチサポート
このリリースでは、アーティファクトブランチが導入されています。ユーザーは、システムによって生成された latest ブランチを含むアーティファクトブランチを作成、管理、および変更できるようになりました。ブランチを使用すると、バージョンの分離と制御が可能になり、ユーザーは個別のブランチでアーティファクトの異なるバージョンを追跡できるようになります。latest の概念は、削除または変更できないシステム生成ブランチとして正式に定義されるようになりました。
Semantic Versioning
このリリースでは、アーティファクトの Semantic Versioning をオプトインできます。このオプションを設定すると、Apicurio Registry は Semantic Versioning 規則に基づいて、ブランチを自動的に生成および管理します。たとえば、バージョン 1.0.0 のアーティファクトを作成すると、1.x や 1.0.x などのブランチが作成されます。これらのブランチは、新しいバージョンが作成されると自動的に更新され、ユーザーが削除または変更することはできません。
デプロイメント
2.x では、各永続性オプションは独自のコンテナーを使用してデプロイされます。バージョン 3.x では、すべての永続性オプションが単一の Apicurio Registry バックエンドコンテナーとして使用できるため、環境変数を使用して永続性オプションを設定できます。
オプションの UI デプロイメント
アプリケーションは、オプションの UI コンテナーの有無にかかわらず、デプロイメントをサポートするようになりました。UI がデプロイされていない場合でも、インタラクティブな API ドキュメントを利用できるため、API には完全にアクセス可能です。
Core API
バージョン 3 API は新しい機能を提供します。バージョン 2 の Core Registry API は引き続きサポートされていますが、新しい機能を利用するにはバージョン 3 に移行する必要があります。
複数言語のクライアント SDK
このリリースには、Java、Python、Golang、TypeScript などの複数の言語用の Kiota ツールを使用して生成されたクライアント SDK のサポートが含まれています。
コンテンツルール階層
2.x では、コンテンツルールはグローバルレベルとアーティファクトレベルでのみ適用できました。バージョン 3.x では 3 番目のレイヤーが導入され、グループレベルでルールを定義できるようになりました。この階層型ルールシステムにより、よりきめ細かい制御と柔軟性が可能になります。
Pulsar および Nats のシリアライザー/デシリアライザーのサポート
シリアライザー/デシリアライザーはプラットフォームに依存しないようにリファクタリングされ、バージョン 3 では Apache Pulsar と Nats という 2 つの新しいプラットフォームが追加されました。
制御された削除
Apicurio Registry には、グループ、アーティファクト、バージョンを削除する機能を制御する環境変数が含まれるようになりました。これにより、管理者は必要に応じて削除機能を有効または無効にすることができます。
UI の改善
ユーザーインターフェイスは、空のアーティファクトの作成、バージョンの管理、ラベルとプロパティーの統合されたラベル付けシステムへのマージなどの新しいデータモデルの変更を反映するように更新されました。ラベルとグループによるフィルタリングが強化され、ユーザーエクスペリエンスが向上しました。
グループの管理
グループの編集、グループによるフィルタリング、グループの表示、グループルールの作成を行う機能。
拡張 API サポート
Apicurio Registry は、最新の API 仕様との互換性を求めるユーザーの要求に応えて、AsyncAPI 3.0 をサポートするようになりました。
読み取り専用モード
Apicurio Registry を読み取り専用モードに設定して、すべてのバックエンド書き込み操作を無効にできます。このモードは動的に有効および無効にできます。
UI 設定
UI は、バックエンドとは独立して読み取り専用モードに設定できるため、ユーザーはバックエンドの操作を許可しながら UI を介した変更を制限できます。
ドライランモード
以前のテスト用エンドポイントは、ドライランオプションに置き換えられました。ユーザーは、永続的な変更を加えずに、アーティファクトとバージョンの作成をシミュレートして、既存のルールと設定に対して検証できます。
Kafka ストレージ
Kafka SQL ストレージ実装は、安定性とパフォーマンスを向上させ、Kafka ログ圧縮への依存を排除するために完全に更新されました。
Snapshotting
Kafka SQL バックエンドは、内部レジストリー状態のスナップショットを定期的に取得できるようになり、レジストリーのサイズが拡大しても Pod の起動時間が短縮されます。
任意の SQL 実行
Kafka SQL バックエンドでは、ユーザーがカスタム SQL クエリーを Kafka メッセージとして公開できるようになり、メッセージングシステムを通じてデータベースを変更できるようになりました。これは、一括更新やデータ修正に特に便利です。
ロギング
システムのモニタリングおよび監査機能を向上させるために、アクセスログがデフォルトで有効になりました。
強化された作成ワークフロー
アーティファクト作成プロセスがウィザードインターフェイスで刷新され、ユーザーが作成時に詳細なメタデータを入力し、バージョンを設定できるようになりました。
Red Hat build of Keycloak 24 のサポート
  • Red Hat Single Sign-On (RH-SSO) 7.6 は引き続きサポートされますが、新規名称 Red Hat build of Keycloak と呼ばれるようになりました。
Apicurio Registry Maven プラグインの改善
  • pom.xml ファイルの autoRef オプションを使用して、Maven プラグインの参照を自動で検出します。詳細は、Registry-3439 を参照してください。
Apicurio Registry ユーザーのドキュメントおよび例

オープンソースのデモンストレーションアプリケーションは、次の場所から入手できます。

1.4. Apicurio Registry の非推奨機能
リンクのコピー

Apicurio Registry コアの非推奨機能
  • Apicurio Registry Core API バージョン 2: Apicurio Registry Core API の元のバージョン 2 に対する Apicurio Registry のサポートは非推奨となりました。この v2 レガシー API は、次のメジャーリリースで削除される予定です。

1.5. Apicurio Registry デプロイメントのアップグレードと移行
リンクのコピー

Apicurio Registry 2.x から Apicurio Registry 3.x への自動アップグレードはなく、移行プロセスが必要です。

1.5.1. 2.x クライアントの依存関係の更新
リンクのコピー

このリリースでは、クライアントの依存関係の更新が必須ではありません。既存の Apicurio Registry 2.x クライアントアプリケーションは、引き続き Apicurio Registry 3.1 で動作します。

ただし、最新バージョンの Apicurio Registry を使用するには、すべてのクライアント依存関係をできるだけ早く更新する必要があります。クライアントの依存関係には、Apicurio Registry Kafka シリアライザー/デシリアライザー (SerDes)、Maven プラグイン、および Java クライアントアプリケーションの依存関係が含まれます。

たとえば、Java クライアントアプリケーションの Maven 依存関係を更新するには、次のように pom.xml ファイルでバージョンを指定します。 

<dependency>
    <groupId>io.apicurio</groupId>
    <artifactId>apicurio-registry-client</artifactId>
    <version>3.1.0.Final-redhat-00001</version>
</dependency>
Copy to Clipboard Toggle word wrap

1.6. Apicurio Registry の解決済みの問題
リンクのコピー

1.7. Apicurio Registry の解決済みの CVE
リンクのコピー

次の Common Vulnerabilities and Exposures (CVE) は Apicurio Registry 3.1 で解決されています。

Expand
表1.1 Apicurio Registry 3.1.0 の解決済みの CVE
CVE説明

CVE-2024-47561

Apache Avro に脆弱性が見つかりました。この脆弱性により、攻撃者は特殊な "java-class" 属性を使用してリモートコード実行をトリガーできます。

1.8. Apicurio Registry の既知の問題
リンクのコピー

Apicurio Registry 3.1 には次の既知の問題があります。

Apicurio Registry コアの既知の問題

#5732 - Kafkasql ストレージが所有者フィールドを適切に処理しません。

KafkaSQL ストレージの owner-only-authorization プロパティーの設定が期待どおりに機能しません。

この問題を回避するには、owner-only-authorization を設定しないでください。

IPT-1143 - ResultSet リソースの漏洩に関して誤解を招く "warning" ログメッセージが表示される

ログに次のようなメッセージが表示される場合があります。 

2024-07-24 08:33:53 WARN <> [io.quarkus.agroal.runtime.AgroalEventLoggingListener] (executor-thread-3) Datasource '<default>': JDBC resources leaked: 1 ResultSet(s) and 0 Statement(s)
Copy to Clipboard Toggle word wrap

JDBC リソースは漏洩されていないため、このメッセージは正しくありません。

これらのメッセージは無視しても問題ありません。

IPT-814: Apicurio Registry のログアウト機能が RH-SSO 7.6 と互換性がない

RH-SSO 7.6 では、ログアウトエンドポイントで使用される redirect_uri パラメーターが非推奨になりました。詳細は、RH-SSO 7.6 アップグレードガイド を参照してください。これは非推奨であるため、RH-SSO Operator を使用して Apicurio Registry のセキュリティー保護を行っている場合は、Logout ボタンをクリックすると、Invalid parameter: redirect_uri エラーが表示されます。

回避策は、https://access.redhat.com/solutions/6980926 を参照してください。

Apicurio Registry Operator の既知の問題

Operator-42: OpenShift ルートの自動生成では、間違ったベースホスト値が使用される可能性がある

複数の routerCanonicalHostname 値が指定されている場合は、Apicurio Registry OpenShift ルートの自動生成で間違ったベースホスト値が使用される可能性があります。

付録A サブスクリプションの使用
リンクのコピー

Apicurio Registry は、ソフトウェアサブスクリプションから提供されます。サブスクリプションを管理するには、Red Hat カスタマーポータルでアカウントにアクセスします。

アカウントへのアクセス

  1. access.redhat.com に移動します。
  2. アカウントがない場合は作成します。
  3. アカウントにログインします。

サブスクリプションのアクティベート

  1. access.redhat.com に移動します。
  2. My Subscriptions に移動します。
  3. Activate a subscription に移動し、16 桁のアクティベーション番号を入力します。

ZIP および TAR ファイルのダウンロード

ZIP または TAR ファイルにアクセスするには、カスタマーポータルを使用して、ダウンロードする関連ファイルを検索します。RPM パッケージを使用している場合、この手順は必要ありません。

  1. ブラウザーを開き、access.redhat.com/downloads で Red Hat カスタマーポータルの Product Downloads ページにログインします。
  2. Integration and Automation カテゴリーで Red Hat Integration エントリーを見つけます。
  3. 目的の Apicurio Registry 製品を選択します。Software Downloads ページが開きます。
  4. コンポーネントの Download リンクをクリックします。

改訂日時: 2025-10-24

法律上の通知
リンクのコピー

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat