開発者ポータルを Drupal 11 にアップグレードするための準備

アップグレードプロセスを開始する前に、開発者ポータル内のすべてのカスタムモジュールとテーマが Drupal 11 と互換性があることを確認してください。

開発者ポータルに、自分で作成した、または他からダウンロードしたカスタムモジュールやテーマが含まれている場合は、アップグレードプロセスを開始する前に、それらが Drupal 11 と互換性があることを確認してください。このアクションは、シームレスな IBM® API Connect アップグレードの経験を作成するのに役立ちます。モジュールとテーマの互換性についての詳細は、 Drupal ドキュメントの Upgrade status から Upgrade status モジュールをダウンロードしてください。

注意: アップグレードを開始する前に、モジュールとテーマのステータスと、それらが使用中かどうかを確認してください。使わないものは取り除く。

Drupal 11 アップグレードのために開発者ポータルを準備する方法の詳細については、以下の手順を参照してください：

アップグレード・ステータス・モジュールのインストール
モジュールをアップグレードして Drupal 11 と互換性を持たせる
開発者ポータルにモジュールをインポートする
モジュールが Drupal 11 と互換性があることを確認する。

アップグレード・ステータス・モジュールのインストール

管理者として開発者ポータルにログインします。
Upgrade Status モジュールをインストールする。アップグレードステータスのインストール方法の詳細については、カスタムモジュールのインストールを参照してください。
アップグレードステータスのインストールが完了したら、管理 > レポート > アップグレードステータスをクリックします。

この領域は IBM API Connect によって管理され、アップグレードが完了した時点で解決されるため、 Drupal コアとホスティング環境のセクションは無視してかまいません。
重要: Drupal 11 にアップグレードする前に、カスタムモジュールとテーマを PHP 8.3 に対応させる必要があります。 Drupal のアップグレードに関連する問題のトラブルシューティングについては、「アップグレードの問題は Drupal のカスタムモジュールやテーマに関連していますか？

Drupal 11 アップグレードステータスページに表示されるプロジェクトのリストは、 Drupal 11 と互換性のないものです。 Upgrade status モジュールは、これらのプロジェクトをさまざまなセクションに分類する。例えば、削除、更新、メンテナとの共同作業。

注意: IBM API Connect をアップグレードすると、手動で作成またはインストールしていないモジュールとテーマに Drupal 11 の互換性が自動的に与えられます。
Drupal 11 アップグレードステータスページでカスタムモジュールとテーマを見つけたら、カスタムモジュールとテーマを選択し、[ 選択したものをスキャン] をクリックすると、 Drupal 11 と互換性を持たせるために必要な変更が表示されます。カスタムモジュールまたはテーマのアップデートが必要な場合、スキャンが完了すると、対応するテーマまたはカスタムモジュールへのリンクが表示されます。例えば、次の画像は、 Masonry API という名前のインストールされたカスタムモジュールをスキャンするプロセスを示しています。
注意: Upgrade status モジュールがカスタムモジュールとテーマの Drupal 11 互換性の問題をすべて識別するためには、スキャンする前にカスタムモジュールとテーマを有効にする必要があります。
HTMLとしてエクスポートをクリックすると、見やすくなります。
info.yml ファイルに新しいバージョンを追加し、非推奨関数のコードを変更してモジュールをアップグレードし、 Drupal 11 と互換性を持たせます。
モジュールが Drupal 11 と互換性を持つようになったら、 Developer Portal UI を使用してモジュールを再インストールし、更新されたモジュールをインポートします。カスタムモジュールのインストール方法の詳細については、カスタムモジュールのインストールを参照してください。
アップグレード・ステータス・レポート・ページに戻り、モジュールを再スキャンして、お使いのモジュールが Drupal 11 と互換性があることを確認します。

モジュールをアップグレードして Drupal 11 と互換性を持たせる

このモジュールは、レポートを読み、コードを修正して Drupal 11 と互換性を持たせる方法の例です。

新しいバージョンを info.yml ファイルに追加する。 Drupal 9と Drupal 10に存在する Drupal/Core/Extension/Extension List はそのままに、 Drupal 11のサポートを追加する。
注意: Drupal 11 と互換性のない非推奨 API を使用しているカスタム・モジュールがある場合、 Drupal 11 と互換性を持たせるのはあなたの責任です。 Drupal のアップグレードに関するトラブルシューティングについては、「アップグレードの問題は Drupal のカスタムモジュールやテーマに関連していますか？

モジュールに変更を加える場合は、次の例のようにバージョン番号を変更します。

Before

 name: 'IBM APIC Portal - custom icons'
type: module
description: 'IBM API Connect Developer Portal tutorial - Example of custom product icons'
package: 'Custom'
core_version_requirement: ^9 || ^10
version: 1.0.1
project: 'custom_icons'
dependencies:
  - ibm_apim

After

name: 'IBM APIC Portal - custom icons'
type: module
description: 'IBM API Connect Developer Portal tutorial - Example of custom product icons'
package: 'Custom'
core_version_requirement: ^9 || ^10 || ^11
version: 1.0.2
project: 'custom_icons'
dependencies:
  - ibm_apim

開発者ポータルにモジュールをインポートする

Developer Portal Toolkit CLI を使用してモジュールをインポートします。 Developer Portal CLI の使用方法の詳細については、「 Getting started with Portal CLI commands 」を参照してください。

例:

❯ apic login -s $SERVER -r provider/default-idp-2 -u steve Warning: Using default toolkit credentials. Enter your API Connect credentials Password? Logged into api.fyre-ci-134466-master.fyre.ibm.com successfully ❯ apic -s $SERVER -m portaladmin custom-module:create-import -o ibm -c api-connect-catalog-2 /tmp/custom_icons.zip Loading File (Large files may take a while)... 201 CREATED - Task ID: wp5fhmm9l74pmkw1 Response Code - 202: Message(s) - The status of this task is: QUEUED Response Code - 202: Message(s) - The status of this task is: RUNNING Response Code - 200: Message(s) - 2023-02-27 14:39:38: CLI task (custom_module:import) starting. 2023-02-27 14:39:40: Deleting existing custom module /var/aegir/platforms/devportal-9.x-10.0.5.2-20230105-1720/sites/ibm.api-connect-catalog-2.portal.fyre-ci-134466-master.fyre.ibm.com/modules/custom_icons 2023-02-27 14:39:40: Importing custom module custom_icons 2023-02-27 14:40:25: CLI task (custom_module:import) completed successfully.

または、 Developer Portal UI を使用してモジュールを再度インストールし、更新したモジュールをインポートします。カスタムモジュールのインストール方法の詳細については、カスタムモジュールのインストールを参照してください。

モジュールが Drupal 11 と互換性があることを確認する

更新されたモジュールが開発者ポータルにインポートされました。アップグレードステータスレポートページに戻り、モジュールを再スキャンします。 Drupal 11に対応するようになると、ページの最後に表示される。

Drupal 10と互換性を持つように更新されたモジュールのスクリーンキャプチャ。

結果

Upgrade status モジュールを使用して、カスタムモジュールとテーマとの Drupal 11 互換性の問題を特定し、修正しました。しかし、このプロセスでは、 Drupal 11 へのアップグレードに必要なすべてをカバーできないかもしれません。 Drupal 11にはPHP が必要なので、カスタムモジュールやテーマを変更して対応する必要があるかもしれません。 8.3 カスタムモジュールやテーマを最新の状態に保ち、自分で書いたカスタムモジュールやテーマの中で非推奨のコードを削除することを忘れないでください。