Aktivera eller inaktivera underhållsläge

Följande guide hänvisar till en standardsida för underhållsläge. Om du behöver använda en anpassad underhållssida kan du läsa Skapa det anpassade underhållsavsnittet.

Adobe Commerce använder underhållsläge för att inaktivera startkomponenten. Det är praktiskt att inaktivera startfunktionen när du underhåller, uppgraderar eller konfigurerar om platsen.

Programmet identifierar underhållsläge enligt följande:

  • Om var/.maintenance.flag finns är underhållsläget aktiverat och programmet returnerar en underhållssida på 503.
  • Om var/.maintenance.ip finns och klient-IP motsvarar en av IP-adressposterna i den här filen, ignoreras underhållssidan för begäran.

Installera programmet

Innan du använder det här kommandot för att aktivera eller inaktivera underhållsläget måste du installera programmet.

Aktivera eller inaktivera underhållsläge

Använd CLI-kommandot magento maintenance för att aktivera eller inaktivera underhållsläge.

Kommandoanvändning:

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

Alternativet --ip=<ip address> är en IP-adress som ska undantas från underhållsläge (till exempel utvecklare som utför underhållet). Om du vill undanta mer än en IP-adress i samma kommando använder du alternativet flera gånger.

NOTE
Om du använder --ip=<ip address> med magento maintenance:disable sparas listan över IP-adresser för senare bruk. Om du vill rensa listan över undantagna IP-adresser använder du magento maintenance:enable --ip=none eller läser Underhåll listan över undantagna IP-adresser.

Kommandot bin/magento maintenance:status visar status för underhållsläge.

Om du till exempel vill aktivera underhållsläge utan undantag för IP-adresser:

bin/magento maintenance:enable

Så här aktiverar du underhållsläge för alla klienter utom 192.0.2.10 och 192.0.2.11:

bin/magento maintenance:enable --ip=192.0.2.10 --ip=192.0.2.11

När du har placerat programmet i underhållsläge måste du stoppa alla konsumentprocesser i meddelandekön.
Ett sätt att hitta dessa processer är att köra kommandot ps -ef | grep queue:consumers:start och sedan köra kommandot kill <process_id> för varje konsument. I en miljö med flera noder upprepar du den här uppgiften på varje nod.

Underhåll listan över undantagna IP-adresser

Om du vill behålla listan över undantagna IP-adresser kan du antingen använda alternativet [--ip=<ip list>] i de föregående kommandona eller så kan du använda följande:

bin/magento maintenance:allow-ips <ip address> .. <ip address> [--none]

Syntaxen <ip address> .. <ip address> är en valfri, utrymmesavgränsad lista över IP-adresser som ska undantas.

Alternativet --none rensar listan.

Inställningar för flera butiker

Om du vill konfigurera flera arkiv, där vart och ett har olika layout och lokaliserat innehåll, skickar du parametern $_GET['skin'] till den avsedda processorn.

I följande exempel använder vi en 503-typfelsmallfil som kräver lokaliserat innehåll.

Konstruktorn för klassen Error_Processor accepterar en skin GET-parameter för att ändra layouten:

if (isset($_GET['skin'])) {
    $this->_setSkin($_GET['skin']);
}

Detta kan också läggas till i en omskrivningsregel i filen .htaccess som lägger till en skin -parameter i URL:en.

$_GET['skin'] parameter

Så här använder du parametern skin:

  1. Kontrollera om .maintenance.flag finns.

  2. Observera värdadressen, som refererar till HTTP_HOST, eller någon annan variabel som ENV-variabler.

  3. Kontrollera om parametern skin finns.

  4. Ange parametern med hjälp av reglerna för omskrivning nedan.

    Här är några exempel på skrivregler:

    • 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]
  5. Kopiera följande filer:

    • pub/errors/default/503.phtml till pub/errors/sub/503.phtml
    • pub/errors/default/css/styles.css till pub/errors/sub/styles.css
  6. Redigera de här filerna för att tillhandahålla lokaliserat innehåll i filen 503.phtml och anpassad formatering i filen styles.css.

    Kontrollera att sökvägarna pekar på din errors-katalog. Katalognamnet måste matcha URL-parametern som anges i RewriteRule. I föregående exempel används katalogen sub, som anges som en parameter i RewriteRule (skin=sub)

NOTE
Inställningen nginx måste läggas till för flerlagringsinställningar.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995