10.0.5.x から 10.0.8.x へのアップグレード

10.0.5.xから IBM® API Connect 10.0.8.x にアップグレードする場合は、以前の 10.0.x リリースの 10.0.6.0 および 10.0.7.0で提供された以下の主要な更新をメモしておく必要があります。

以下のリストに、バージョン 10.0.6.0 および 10.0.7.0で API Connect に配信された主要な更新を示します。以前のバージョンで提供されていたすべての機能と更新の完全なリストについては、バージョン 10.0.6.0 、および 10.0.x IBM Documentationのバージョン 10.0.7.0 の新機能を参照してください。

10.0.7.0 で提供される主要な更新

管理データベース・オペレーターの置換

管理コンポーネントの新しい Postgres オペレーター: EDB。

EDB は、前の Postgres オペレーター Crunchyを置き換えます。

EDB を変更すると、以下の手順が変更されます。

インストールします。
アップグレード。
バックアップ、リストア、および災害復旧。
フォーム・ファクターのマイグレーション。
2 つのデータ・センターの災害復旧。

開発者ポータルのローカル・バックアップ・プロセスの更新

以下のコマンドを実行すると、開発者ポータルにローカル・バックアップとリモート・バックアップが表示されるようになりました。

kubectl get portalbackup

以前は、ローカル・バックアップはポータル・ポッド内でのみ表示されていました。

開発者ポータルは、ローカル・バックアップ用に、サイトごとに 3 つのシステム・バックアップと 3 つのバックアップのみを保持することに注意してください。新しいローカル・バックアップを実行すると、最も古いバックアップが削除されます。

新しいバックアップ、リストア、および災害復旧の資料

Kubernetes、 OpenShift、および Cloud Pak for Integrationの場合、災害復旧セクションはバックアップおよびリストア・セクションとマージされ、サブシステム YAML ファイルおよび Kubernetes シークレットをバックアップするための要件がより顕著になります。バックアップ、リストア、および災害復旧を参照してください。

VMwareの場合、 v10.0.7.0用の新しい管理サブシステム・バックアップ・セクションがあります。管理サブシステムのバックアップと復元を参照してください。

API 鍵で複数の使用がサポートされるようになりました

Cloud Manager で API キーのタイムアウトを定義するときに、アプリケーションがアクセス・トークンの API キーを複数回交換できるようにするかどうかを追加で選択できます。詳しくは、 API キーのタイムアウトの構成を参照してください。

OpenShift: API Connect クラスターでの FIPS 構成のサポート

新規デプロイメントの場合は、クラスターで連邦情報処理標準 (FIPS) プロトコルのサポートを構成できます。 OpenShift クラスターをインストールする前に、FIPS サポートを構成する必要があります。詳しくは、 FIPS サポートの構成を参照してください。

Cloud Pak for Integration は、OIDC プロバイダーとして IAM を Keycloak に置き換えるため、ユーザー・アカウントの更新が必要になる場合があります。

2023.4 (API Connect 10.0.7.0) 以降、 Cloud Pak for Integration は、IAM (ID およびアクセス管理) ではなく、OIDC プロバイダーとして Keycloak を使用してユーザーを認証します。 Keycloak と IAM がユーザー名を処理する方法が異なるため、アップグレード後にユーザーがログインできるように、重複するユーザー・アカウントを手動でマージする必要がある場合があります。詳しくは、 Cloud Pak for Integrationを参照してください。

Cloud Pak エンドポイントは、 API Connect

バージョン 10.0.7.0以降、 API Connect は、 Cloud Pak for Integrationのコンポーネントとしてデプロイされた場合に、エンドポイントの Cloud Pak cpd 経路を使用しなくなりました。代わりに、コンポーネントは標準的なデフォルトの API Connect 経路 (または CR で構成されたカスタム・エンドポイント) を使用します。この変更は、 Cloud Pak for Integrationの以前のバージョンの API Connect コンポーネントの新規インストールとアップグレードの両方に影響します。

API Connect コンポーネントを Cloud Pak エンドポイントと共にデプロイする場合、または既存のエンドポイントを保持する必要がある場合 (例えば、既存のブックマークや自動化機能をサポートする場合)、 Cloud Pak for Integration 2023.4.1 以降で API Connect コンポーネントをインストールまたはアップグレードするときに、 Cloud Pak エンドポイントの使用を有効にすることができます。詳しくは、 Deploying on OpenShift and Cloud Pak for Integration または Upgrading on OpenShift and Cloud Pak for Integrationを参照してください。

VMware: ローカル・マシンからノード状況を取得するための新しい apicup コマンド

新しい apicup subsys status コマンドをローカルで実行すると、最初にノードに SSH で接続することなく、ノードの状況を取得できます。

ブロックされた Drupal モジュールのリストの更新

以下の Drupal モジュールは現在サポートされておらず、開発者ポータルでインストールがブロックされています。

すべての拡張集約モジュール ( advagg、 advagg_mod、 advagg_js_minify、 advagg_css_minify、 advagg_ext_minify、 advagg_validator、および advagg_bundler)。これらのモジュールは、現行の Drupal バージョンとの互換性がないためにブロックされています。
statistics モジュール。このモジュールは、 Drupalによって非推奨になっています。
tfa モジュール。 2 要素認証は、開発者ポータル内では使用できません。多要素認証が必要な場合は、 OpenID Connect (OIDC) ユーザー・レジストリー内で構成できます。 OIDC ユーザー・レジストリーの作成を参照してください。

カスタム・モジュールについて詳しくは、カスタム・モジュールのインストールを参照してください。

主要な分析の更新

以下の主要な分析更新が提供されました。

分析の非アクティブ製品レポート。サブスクリプションがない製品、最近のトラフィックがない製品、またはトラフィックがまったくない製品を強調表示する、 API Manager UI の新規レポート。
Analytics API 呼び出しボリューム・リーダー・ボード。分析ビューのレポート・タブには、上位の API、製品、プラン、アプリケーション、およびコンシューマー組織のトップ・ボードが含まれています。
分析の消費者トレンド・レポート。分析ビューのレポート・タブには、時間の経過に伴うコンシューマー組織内のアプリケーションおよびサブスクリプションの数の変化を示す新しいコンシューマー・トレンド・レポートが含まれています。
詳細な API、製品、プラン、アプリケーション、およびコンシューマー組織の分析レポート。特定の API、製品、プラン、アプリケーション、およびコンシューマー組織に関する詳細な分析情報。例えば、API の場合、その API を使用するすべてのコンシューマー組織の詳細。詳細レポートには、レポート・ビューのリーダーシップ・ボードからアクセスできます。
分析永続キューは、デフォルトで有効になっています。永続キュー機能は、新しい 10.0.7.0 以降のインストール済み環境ではデフォルトで有効になっています。 10.0.5.x または 10.0.6.0からアップグレードする場合、この機能はアップグレード時に自動的に有効になります。
新しい分析 API イベント・フィールド。 API Gateway 10.5.3 以降を使用する場合、以下の 2 つの新規フィールドが API イベント・レコードに含まれます。
- api_resource_id: ゲートウェイで使用される API のリソース ID を含むストリング。形式はapi_name:api_version:method:pathです。
- gateway_service_name: Cloud Manager UI で構成されているゲートウェイ・サービスの名前。
分析の取り込みをモニターします。分析クラスター管理 API を使用して Logstash API を公開することで、分析取り込みをモニターできるようになりました。詳しくは、「 API for API Connect analytics subsystem 」資料の Resource: Clustermgmt (ingestion) を参照してください。

API エディターでのアセンブリー・オーサリング・エクスペリエンスの更新

API Manager および API Designer で API のアセンブリー・セクションを表示および編集するための API エディターが、新しいユーザー・エクスペリエンスで更新されました。全体的な機能は変わりませんが、フロー・キャンバス、ポリシー・パレット、およびポリシー・プロパティーを操作するためのビジュアル・コンポーネントが更新されます。詳しくは、 API アセンブリーへの要素の組み込みを参照してください。

10.0.6.0 で提供される主要な更新

v5-compatible API を DataPower API Gateway にマイグレーションします。

デプロイメントに v5-compatible API が含まれている場合、それらの API は DataPower v5-compatible ゲートウェイ ( v5c ゲートウェイとも呼ばれる) でのみ使用できます。 v5-compatible API を DataPower API Gatewayで使用するには、API を新しい形式にマイグレーションする必要があります。詳しくは、 Migrating v5-compatible APIs to API Gatewayを参照してください。

(Kubernetes、 Red Hat OpenShift) Kubernetes イベントを使用したプラットフォームの正常性状況のモニターの向上

Kubernetes および Red Hat OpenShift の IBM APIConnect オペレーターで新機能が有効になり、最上位の CR (APIConnectCluster) またはサブシステム CR (

ManagementCluster, GatewayCluster, AnalyticsCluster,
PortalCluster

) の状況条件が変更されるたびに CR イベントが生成されるようになりました。 CR 状況条件とともに、サード・パーティーのアラート・システムを使用して、これらのイベントをモニターできます。

詳しくは、 Kubernetes イベントを使用したプラットフォームの正常性のモニターまたは Kubernetes イベントを使用した Red Hat OpenShift でのプラットフォーム正常性のモニターを参照してください。

Red Hat OpenShiftベースのデプロイメントでは、 API Connect オペランドを使用して基本サービスを管理するようになりました。

以前のリリースの API Connectでは、 Red Hat OpenShift でのデプロイメント ( Cloud Pak for Integrationの機能としてのデプロイメントを含む) により、オペレーター・レベルで OLM によって強制される依存関係を介した IBM Cloud Pak 基本サービスの使用が管理されていました。 API Connect 10.0.6.0 以降では、基本サービスへの依存関係は OLMによってオペレーター・レベルで管理されなくなりましたが、代わりに API Connect オペレーターによってオペランド・レベルで処理されます。この変更により、APIC 演算子が実際にそれを必要とするオペランドにのみ依存関係を適用できるようにすることで、柔軟性が向上します。

この変更は、 10.0.5.3 以降の新規インストールおよびアップグレードにのみ適用されます。詳しくは、ご使用の Red Hat OpenShift 環境に応じたインストール手順を参照してください。

新しいガバナンス・オプション・アドオン・サービス

ガバナンス・サービスは、 IBM API Connect に対するオプションのアドオンであり、組織のガバナンス・ポリシーおよびベスト・プラクティスを検証して API 開発プロセスに適用するために使用できます。このアドオンを有効にする方法については、 Kubernetes でのガバナンスの有効化および VMware でのガバナンスの有効化を参照してください。

分析の長期データ

デフォルトでは、分析イベント・データは、デプロイメント・プロファイルに応じて最大 30 日間または 90 日間保持されます。新しい長期データ機能により、イベント・データが要約され、1 年間のデフォルト保存期間を持つ新しい要約データ索引に追加されます。要約データを使用すると、プロダクト・マネージャーは長期的な傾向を見ることができます。要約データを表示するために、UI には新しい「レポート」タブがあります。分析ダッシュボードを参照してください。 UI の「レポート」タブに表示される要約データにアクセスするために、新しい REST API およびツールキット CLI 操作も提供されています。

注: v10.0.5.xからアップグレードする場合、 10.0.6.0 以降へのアップグレードが完了した後に、すべての新規 API イベントの要約データが収集されます。 10.0.5.x からの既存の API イベント・データは、要約データ索引に追加されません。

API 定義のスキーマ・エディター設計の更新

API Manager および API Designer UI の API エディターの「定義」セクションが更新され、スキーマ定義の作成および編集時のユーザー・エクスペリエンスが向上しました。詳しくは、 API のスキーマの定義を参照してください。