Ativar ou desativar modo de manutenção
O guia a seguir se refere a uma página de modo de manutenção padrão. Se precisar usar uma página de manutenção personalizada, consulte Criar a página de manutenção personalizada tópico.
O Adobe Commerce usa modo de manutenção para desativar a inicialização. Desativar a inicialização é útil enquanto você mantém, atualiza ou reconfigura o site.
O aplicativo detecta o modo de manutenção da seguinte maneira:
-
Se
var/.maintenance.flagnão existir, o modo de manutenção estiver desativado e o aplicativo funcionar normalmente. -
Caso contrário, o modo de manutenção será ativado, a menos que
var/.maintenance.ipexiste.var/.maintenance.ippode conter uma lista de endereços IP. Se um ponto de entrada for acessado usando HTTP e o endereço IP do cliente corresponder a uma das entradas nessa lista, o modo de manutenção estará desativado.
Instalar o aplicativo
Antes de usar este comando para ativar ou desativar o modo de manutenção, você deve instalar o aplicativo.
Ativar ou desativar modo de manutenção
Use o magento maintenance Comando da CLI para ativar ou desativar o modo de manutenção.
Uso do comando:
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
A variável --ip=<ip address> é um endereço IP para isentar do modo de manutenção (por exemplo, desenvolvedores que estão fazendo a manutenção). Para isentar mais de um endereço IP no mesmo comando, use a opção várias vezes.
--ip=<ip address> com magento maintenance:disable O salva a lista de IPs para uso posterior. Para limpar a lista de IPs isentos, use magento maintenance:enable --ip=none ou consulte Manter a lista de endereços IP isentos.A variável bin/magento maintenance:status exibe o status do modo de manutenção.
Por exemplo, para ativar o modo de manutenção sem isenções de endereço IP:
bin/magento maintenance:enable
Para ativar o modo de manutenção para todos os clientes, exceto 192.0.2.10 e 192.0.2.11:
bin/magento maintenance:enable --ip=192.0.2.10 --ip=192.0.2.11
Depois de colocar a aplicação no modo de manutenção, você deve interromper todos os processos do consumidor da fila de mensagens.
Uma maneira de encontrar esses processos é executar o ps -ef | grep queue:consumers:start e execute o kill <process_id> comando para cada consumidor. Em um ambiente com vários nós, repita essa tarefa em cada nó.
Manter a lista de endereços IP isentos
Para manter a lista de endereços IP isentos, você pode usar o [--ip=<ip list>] nos comandos anteriores ou você pode usar o seguinte:
bin/magento maintenance:allow-ips <ip address> .. <ip address> [--none]
A variável <ip address> .. <ip address> A sintaxe é uma lista opcional delimitada por espaços de endereços IP para isentar.
A variável --none A opção limpa a lista.
Configurações de várias lojas
Se quiser configurar vários armazenamentos, cada um com um layout diferente e conteúdo localizado, passe a $_GET['skin'] ao processador pretendido.
No exemplo a seguir, estamos usando uma variável 503 arquivo de modelo de erro do tipo, que requer conteúdo localizado.
O construtor do Error_Processor classe aceita um skin Parâmetro GET para alterar o layout:
if (isset($_GET['skin'])) {
$this->_setSkin($_GET['skin']);
}
Isso também pode ser adicionado a uma regra de regravação no .htaccess arquivo que anexa um skin para o URL.
$_GET['skin'] parâmetro
Para usar o skin parâmetro:
-
Verifique se
.maintenance.flagexiste. -
Observe o endereço do host, que se refere ao
HTTP_HOSTou qualquer outra variável, como variáveis ENV. -
Verifique se
skinO parâmetro existe. -
Defina o parâmetro usando as regras de regravação abaixo.
Estes são alguns exemplos de regras de regravação:
- 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 os seguintes arquivos:
pub/errors/default/503.phtmlparapub/errors/sub/503.phtmlpub/errors/default/css/styles.cssparapub/errors/sub/styles.css
-
Edite esses arquivos para fornecer conteúdo localizado no
503.phtmlestilo de arquivo e personalizado nostyles.cssarquivo.Certifique-se de que os caminhos apontem para a
errorsdiretório. O nome do diretório deve corresponder ao parâmetro de URL indicado noRewriteRule. No exemplo anterior, a variávelsubque é especificado como um parâmetro na variávelRewriteRule(skin=sub)