Drupal のアップグレード

Edge for Private Cloud v4.18.05

Developer Services ポータルで（または単にポータルで）Apigee Edge for Private Cloud をインストールしている場合、新しいバージョンの Drupal が利用可能である旨の通知が表示されることがあります。新しいバージョンとは、Drupal 機能リリース、パッチ、セキュリティ アップデート、その他の種類の Drupal アップデートを意味します。セキュリティ アップデートの場合は、サイトの安全性を維持するため、Drupal のインストールをすみやかにアップグレードしてください。

次の手順では、Drupal 7.xy の Private Cloud インストールを別のマイナー バージョン（Drupal 7.54〜7.56 など）にアップデートする方法について説明します。

以下の内容に注意してください。

  • この手順では、Drupal のインストールのみがアップデートされます。ポータルに付属の Apigee ソフトウェアはアップデートされません。Apigee ポータル ソフトウェアのアップグレードの詳細については、ポータルのアップグレードをご覧ください。

  • ポータルサイトのルート ディレクトリから Drush コマンドを実行する必要があります。デフォルトでは、ポータルは次の場所にインストールされます。
    • /opt/apigee/apigee-drupal/wwwroot（Nginx）
    • /var/www/html（Apache）
    以下の手順では、上記のデフォルトの場所に Nginx サーバーをインストールすることを想定しています。

現在の Drupal バージョンの確認

Drupal アップデートを開始する前に、次のコマンドを Drupal インストール フォルダから実行すると、現在の Drupal バージョンを確認できます。デフォルトでは、Drupal は /opt/apigee/apigee-drupal/wwwroot にインストールされています。

cd /opt/apigee/apigee-drupal/wwwroot
drush status | grep 'Drupal version'

出力は次のようになります。

    Drupal version          :  7.54

Drupal を /opt/apigee/apigee-drupal/wwwroot 以外のディレクトリにインストールした場合は、drush コマンドを実行する前に、ディレクトリを必ず変更してください。

Drupal バージョンのアップデート

このセクションでは、コマンドラインから Drush（Drupal Shell）を使用して、Drupal のバージョンをアップデートする方法について説明します。Drupal ドキュメントの Drupal を使用した Drush のアップデートもご覧ください。

Drupal インストールをアップデートするには、次のようにします。

  1. /opt/apigee/apigee-drupal/wwwroot ディレクトリ、またはポータルをインストールしたディレクトリに移動します。
  2. すべてのファイル、ディレクトリ、データベースの完全バックアップを作成します。Drupal 以外の場所にバックアップを保存します。詳細な手順については、ポータルのバックアップをご覧ください。

    .htaccess、robots.txt、defaults.settings.php（sites ディレクトリ内）などのファイルを変更した場合、アップデート後に変更を再適用する必要があります。sites/all ディレクトリで行われたカスタマイズも再適用する必要があります。

  3. サイトをメンテナンス モードにします。 
    drush vset --exact maintenance_mode 1
    drush cache-clear all
  4. 次のコマンドを使用して、必要なバージョンの Drupal をインストールします。 
    drush pm-update drupal-7.56

    あるいは、drush pm-update drupal を実行して最新の Drupal コアバージョンにアップデートすることもできます。drush pm-updatestatus を実行すると、Drupal コア プロジェクトと contrib プロジェクトに利用可能なマイナー アップデートを一覧表示できます。

  5. .htaccess、robots.txt、defaults.settings.php（sites ディレクトリ）の変更を再適用します。
  6. sites/all ディレクトリの変更を再適用します。
  7. サイトをメンテナンス モードから戻します。
    drush vset --exact maintenance_mode 0
    drush cache-clear all

アップデート中に問題が発生した場合

作成したバックアップ ファイルを使用して、サイトを元の状態に復元します。Apigee サポート担当者に連絡して、アップデート中に報告されたエラー メッセージを知らせます。