1.3. Apicurio Registry の新機能

Apicurio Registry 2.5 には、次の新機能が含まれています。

Quarkus 3.x へのアップグレード

Apicurio Registry サーバーランタイムが Quarkus 2.x から Quarkus 3.x にアップグレードされました。このアップグレードにより、セキュリティー、パフォーマンス、メンテナンス性が向上します。詳細は、https://quarkus.io/quarkus3/ を参照してください。Apicurio Registry 2.5 は Quarkus 3.2 上にビルドされています。

Avro SerDes の改善

Apache Avro シリアライザー/デシリアライザーを使用する場合の、null フィールドを含むスキーマの生成をサポートします。詳細は、Registry-3862 を参照してください。

スキーマキャッシュのフォールトトレランス

スキーマキャッシュのロードが失敗した場合に、エラーを出力するのではなく、既存のスキーマキャッシュエントリーを使用するオプションを追加しました。詳細は、Registry-3807 を参照してください。

アーティファクトコンテンツの逆参照

参照されたコンテンツをインラインで含むアーティファクトコンテンツを返すと役立つ場合があります。このような場合に備えて、Core Registry API v2 では、特定の操作で dereference クエリーパラメーターのサポートが追加されています。詳細は、Apicurio Registry v2 コア REST API ドキュメントを参照してください。
2.5.11 より前では、このサポートは API 操作で dereference パラメーターが指定されている場合に、Avro および Protobuf アーティファクトに対してのみ実装されています。このパラメーターは、他のアーティファクトタイプではサポートされません。詳細は、Registry-2865 を参照してください。
注記
Protobuf アーティファクトの場合、コンテンツの逆参照は、すべてのスキーマが同じパッケージに属している場合にのみサポートされます。
2.5.11 以降では、サポートが JSON スキーマ、非同期 API、OpenAPI に拡張されています。
注記
JSON スキーマアーティファクトの場合、コンテンツの逆参照は、別のアーティファクトの完全なコンテンツを参照するアーティファクトに対してのみサポートされます。アーティファクトが 2 番目のアーティファクトの一部を参照する場合の逆参照は サポート対象外 です。

Apicurio Registry Maven プラグインの改善

Maven プラグインに register ゴールをスキップするオプションを追加します。詳細は、Registry-3817 を参照してください。
pom.xml ファイルの autoRef オプションを使用して、Maven プラグインの参照を自動で検出します。詳細は、Registry-3439 を参照してください。これはテクノロジープレビューの機能です。
重要
テクノロジープレビュー機能は、Red Hat 製品サポートのサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat では、実稼働環境での使用を推奨していません。テクノロジープレビューの機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行いフィードバックを提供していただくことを目的としています。
Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲を参照してください。

SQL データソース設定のサポートの改善

Apicurio Registry Operator は、spec.configuration.sql.dataSource フィールドの代わりに環境変数を使用した SQL データソースの設定をサポートします。ApicurioRegistry カスタムリソースでプレーンテキストの代わりに Kubernetes シークレットを使用して SQL 認証情報を提供できるようになりました。詳細は、https://access.redhat.com/solutions/7059053 を参照してください。
このバージョンでは、このユースケースをより適切にサポートするために Apicurio Registry Operator が改良されました。spec.configuration.sql.dataSource フィールドと spec.configuration.env フィールドの両方を使用して、設定の一部を定義できるようになりました。たとえば、次の設定が有効になりました。
```
apiVersion: registry.apicur.io/v1
kind: ApicurioRegistry
metadata:
  name: myregistry
spec:
  configuration:
    persistence: sql
  sql:
    dataSource:
      url: "jdbc:postgresql://..."
      userName: "postgres-user"
    env:
      - name: REGISTRY_DATASOURCE_PASSWORD
        valueFrom:
          secretKeyRef:
            name: postgres-secret
            key: password
```
また、Operator はこのタイプの設定を検出し、ユーザーの追加介入なしで即座に適用します。

ドキュメントライブラリーは、バージョン 2.5 で利用可能な新機能で更新されました。

オープンソースのデモンストレーションアプリケーションも更新されました。