Drupal バージョンの Private Cloud インストールをアップグレードする

Edge for Private Cloud バージョン 4.17.09

Developer Services ポータルの Edge for Private Cloud インストール環境に、新しいバージョンの Drupal が利用可能であるという通知が表示されることがあります。新しいバージョンとは、Drupal 機能リリース、パッチ、セキュリティ アップデート、その他の種類の Drupal アップデートを指します。セキュリティ アップデートを行う場合は、サイトの安全性を保つために、できるだけ早く Drupal をアップグレードする必要があります。

次の手順では、Private Cloud の Drupal 7.x.y を別のマイナー バージョン(Drupal 7.54 ~ 7.56 など)に更新する方法について説明します。

次の点を考慮してください。

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

  • 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 ドキュメントの Drush を使用した Drupal のアップデートもご覧ください。

Drupal インストールをアップデートするには:

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

    .htaccessrobots.txtdefaults.settings.phpsites ディレクトリ内)などのファイルを変更した場合は、アップデート後に変更を再適用する必要があります。また、sites/all ディレクトリで行ったカスタマイズをすべて再適用する必要があります。

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

    > drush pm-update drupal-7.56

    注: 7.56 を目的のバージョンに置き換えます。
    または、drush pm-update drupal を実行して Drupal のコア バージョンを最新のものに更新することもできます。drush pm-updatestatus を実行して、Drupal のコアプロジェクトと contrib プロジェクトで使用可能なマイナー アップデートを一覧表示できます。
  5. .htaccessrobots.txt、または defaults.settings.phpsites ディレクトリ内)に加えた変更を再適用します。
  6. sites/all ディレクトリの変更を再適用します。
  7. サイトのメンテナンス モードを終了します。
    > drush vset --exact maintenance_mode 0 
    > drush cache-clear all
    

アップデート中に問題が発生した場合はどうすればよいですか?

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