Habilitar o deshabilitar el modo de mantenimiento
La siguiente guía hace referencia a una página de modo de mantenimiento estándar. Si necesita utilizar una página de mantenimiento personalizada, consulte Creación de la página de mantenimiento personalizada tema.
Adobe Commerce utiliza modo de mantenimiento para deshabilitar el bootstrapping. Deshabilitar el arranque resulta útil mientras mantiene, actualiza o vuelve a configurar el sitio.
La aplicación detecta el modo de mantenimiento de la siguiente manera:
-
If
var/.maintenance.flagno existe, el modo de mantenimiento está desactivado y la aplicación funciona normalmente. -
De lo contrario, el modo de mantenimiento está activado a menos que
var/.maintenance.ipexiste.var/.maintenance.ippuede contener una lista de direcciones IP. Si se accede a un punto de entrada mediante HTTP y la dirección IP del cliente corresponde a una de las entradas de esa lista, el modo de mantenimiento está desactivado.
Instalación de la aplicación
Antes de utilizar este comando para activar o desactivar el modo de mantenimiento, debe instalar la aplicación.
Habilitar o deshabilitar el modo de mantenimiento
Utilice el magento maintenance Comando CLI para habilitar o deshabilitar el modo de mantenimiento.
Uso de comandos:
bin/magento maintenance:enable [--ip=<ip address> ... --ip=<ip address>] | [ip=none]
bin/magento maintenance:disable [--ip=<ip address> ... --ip=<ip address>] | [ip=none]
bin/magento maintenance:status
El --ip=<ip address> es una dirección IP que se excluirá del modo de mantenimiento (por ejemplo, los desarrolladores que realizan el mantenimiento). Para eximir más de una dirección IP en el mismo comando, utilice la opción varias veces.
--ip=<ip address> con magento maintenance:disable guarda la lista de direcciones IP para su uso posterior. Para borrar la lista de direcciones IP exentas, utilice magento maintenance:enable --ip=none o consulte Mantener la lista de direcciones IP exentas.El bin/magento maintenance:status muestra el estado del modo de mantenimiento.
Por ejemplo, para habilitar el modo de mantenimiento sin excepciones de dirección IP:
bin/magento maintenance:enable
Para habilitar el modo de mantenimiento para todos los clientes excepto 192.0.2.10 y 192.0.2.11:
bin/magento maintenance:enable --ip=192.0.2.10 --ip=192.0.2.11
Después de colocar la aplicación en modo de mantenimiento, debe detener todos los procesos del consumidor de la cola de mensajes.
Una forma de encontrar estos procesos es ejecutar el ps -ef | grep queue:consumers:start y, a continuación, ejecute el kill <process_id> para cada consumidor. En un entorno de varios nodos, repita esta tarea en cada nodo.
Mantener la lista de direcciones IP exentas
Para mantener la lista de direcciones IP exentas, puede utilizar el complemento [--ip=<ip list>] en los comandos anteriores o puede utilizar lo siguiente:
bin/magento maintenance:allow-ips <ip address> .. <ip address> [--none]
El <ip address> .. <ip address> La sintaxis es una lista opcional delimitada por espacios de direcciones IP que se deben eximir.
El --none borra la lista.
Configuraciones de varias tiendas
Si desea configurar varias tiendas, cada una con un diseño y contenido localizados diferentes, pase el $_GET['skin'] al procesador deseado.
En el siguiente ejemplo, se utiliza un 503 escriba el archivo de plantilla de error, que requiere contenido localizado.
El constructor de Error_Processor La clase acepta un skin Parámetro de GET para cambiar el diseño:
if (isset($_GET['skin'])) {
$this->_setSkin($_GET['skin']);
}
Esto también se puede añadir a una regla de reescritura en .htaccess archivo que anexa un skin a la dirección URL.
$_GET['piel'] parámetro
Para usar la variable skin parámetro:
-
Compruebe si la variable
.maintenance.flagexiste. -
Tenga en cuenta la dirección de host que hace referencia a
HTTP_HOSTo cualquier otra variable, como las variables ENV. -
Compruebe si la variable
skinel parámetro existe. -
Defina el parámetro utilizando las reglas de reescritura a continuación.
Estos son algunos ejemplos de reglas de reescritura:
- RewriteCond
%{DOCUMENT_ROOT}/var/.maintenance.flag -f - RewriteCond
%{HTTP_HOST} ^sub.example.com$ - RewriteCond
%{QUERY_STRING} !(^|&)skin=sub(&|$)[NC] - RewriteRule
^ %{REQUEST_URI}?skin=sub[L]
- RewriteCond
-
Copie los siguientes archivos:
pub/errors/default/503.phtmlhastapub/errors/sub/503.phtmlpub/errors/default/css/styles.csshastapub/errors/sub/styles.css
-
Edite estos archivos para proporcionar contenido localizado en
503.phtmlarchivo y estilo personalizado en lastyles.cssarchivo.Asegúrese de que las rutas apuntan a su
errorsdirectorio. El nombre de directorio debe coincidir con el parámetro de URL indicado en la variableRewriteRule. En el ejemplo anterior, la variablesubse utiliza, que se especifica como parámetro en la variableRewriteRule(skin=sub)