文档Commerce升级指南

用于升级的维护模式选项

Last update: Thu Jul 18 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的自定义维护页面

此部分讨论如何创建自定义维护页面以及如何将流量重定向到该页面。

此部分中的示例说明如何修改以下文件，这是设置维护页面的一种方法：

  • 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配置以执行以下操作：

    • 将所有流量重定向到维护页面
    • 允许列表特定IP，以便管理员可以升级Magento软件。

    以下示例列入允许列表192.0.2.110。

    在Apache配置文件的末尾添加以下内容：

    code language-none 
    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仅供参考；不要添加第二个服务器块）。

    以下允许列表在/var/www/html/magento2中安装了Magento的系统上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