ドキュメントCommerceアップグレードガイド

アップグレードのメンテナンスモードオプション

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 経験者
  • 管理者
  • 開発者

このトピックでは、Magentoアプリケーションのアップグレード中にユーザーに表示するカスタムメンテナンスページを作成する方法について説明します。 カスタムページの作成はオプションですが、アップグレードの一環としてサイトにアクセスできるので、推奨されます。

ユーザーをリダイレクトするカスタムページを作成すると、サイトへのアクセスができなくなり、サイトがメンテナンス中であることもユーザーに通知されます。

NOTE
この節で説明するタスクは、root 権限を持つユーザーとして実行する必要があります。 開発者モードでは、カスタムメンテナンスページを設定できません。

カスタムメンテナンスページの作成

メンテナンスページを作成し、そのページにリダイレクトするには、まず、次の名前のメンテナンスページを作成します。

  • Apache:<web server docroot>/maintenance.html
  • nginx: <magento_root>/maintenance.html

次の内容を追加します。

<!DOCTYPE html>
<html>
<head>
<title>Temporarily Offline</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<style>
h1
{ font-size: 50px; }

body
{ text-align:center; font: 20px Helvetica, sans-serif; color: #333; }

</style>
</head>
<body>

# Temporarily offline

<p>We're down for a short time to perform maintenance on our site to give you the best possible experience. Check back soon!</p>
</body>
</html>

Apache のカスタムメンテナンスページ

この節では、カスタムメンテナンスページを作成する方法と、そのページにトラフィックをリダイレクトする方法について説明します。

この節の例では、メンテナンスページを設定する 1 つの方法である次のファイルの変更方法を示します。

  • Apache 2.4: /etc/apache2/sites-available/000-default.conf
  • Apache 2.2:/etc/apache2/sites-available/default （Ubuntu）、/etc/httpd/conf/httpd.conf （CentOS）

カスタムメンテナンスページにトラフィックをリダイレクトするには：

  1. 以下を行うように Apache 設定を更新します。

    • すべてのトラフィックをメンテナンスページにリダイレクト
    • 管理者がMagentoソフトウェアをアップグレードできるように、特定の IP を許可リストに加えるします。

    次の例は 192.0.2.110 を許可リストに加えるします。

    Apache 設定ファイルの末尾に次のコードを追加します。

    code language-terminal 
    RewriteEngine On
RewriteCond %{REMOTE_ADDR} !^192\.0\.2\.110
RewriteCond %{DOCUMENT_ROOT}/maintenance.html -f
RewriteCond %{DOCUMENT_ROOT}/maintenance.enable -f
RewriteCond %{SCRIPT_FILENAME} !maintenance.html
RewriteRule ^.*$ /maintenance.html [R=503,L]
ErrorDocument 503 /maintenance.html
Header Set Cache-Control "max-age=0, no-store"

  2. Apache を再起動します。

    • CentOS: service httpd restart
    • Ubuntu: service apache2 restart

  3. 次のコマンドを入力します。

    code language-bash 
    touch <web server docroot>/maintenance.enable

  4. システムをアップグレードします。

  5. サイトをテストし、正しく機能することを確認します。

  6. アップグレードが完了したら、maintenance.enable を削除します。

nginx のカスタムメンテナンスページ

この節では、カスタムメンテナンスページを作成する方法と、そのページにトラフィックをリダイレクトする方法について説明します。

カスタムメンテナンスページにトラフィックをリダイレクトするには：

  1. テキストエディターを使用して、サーバーブロックを含む nginx 設定ファイルを開きます。

  2. サーバーブロックに次の内容を追加します（server の内容が明確になるように表示されています。2 つ目のサーバーブロックは追加しないでください）。

    次の許可リストは、Magentoが /var/www/html/magento2 にインストールされているシステムの IP アドレス 192.0.2.110 と 192.0.2.115 です。

    code language-conf 
    server {
     listen 80;
     set $MAGE_ROOT /var/www/html/magento2;

     set $maintenance off;

     if (-f $MAGE_ROOT/maintenance.enable) {
         set $maintenance on;
     }

     if ($remote_addr ~ (192.0.2.110|192.0.2.115)) {
         set $maintenance off;
     }

     if ($maintenance = on) {
         return 503;
     }

     location /maintenance {
     }

     error_page 503 @maintenance;

     location @maintenance {
     root $MAGE_ROOT;
     rewrite ^(.*)$ /maintenance.html break;
 }

     include /var/www/html/magento2/nginx.conf;
}

  3. 次のコマンドを入力します。

    code language-bash 
    touch <magento_root>/maintenance.enable

  4. nginx 設定をリロードします。

    code language-bash 
    service nginx reload

  5. システムをアップグレードします。

  6. サイトをテストし、正しく機能することを確認します。

  7. アップグレードが完了したら、maintenance.enable を削除するか、名前を変更します。

  8. nginx 設定をリロードします。

    code language-bash 
    service nginx reload
recommendation-more-help
83a60e0e-8849-4685-a8cd-c129ecd795ea