Onderhoudsmodus in- of uitschakelen
De volgende handleiding verwijst naar een pagina voor de standaardonderhoudsmodus. Als u een pagina van het douaneonderhoud moet gebruiken, zie het onderwerp van de pagina van het douaneonderhoudcreëren.
Adobe Commerce gebruikt onderhoudswijzeom bootstrapping onbruikbaar te maken. Het uitschakelen van bootstrapping is handig als u uw site onderhoudt, bijwerkt of opnieuw configureert.
De toepassing detecteert de onderhoudsmodus als volgt:
-
Als
var/.maintenance.flag
niet bestaat, is de onderhoudsmodus uitgeschakeld en werkt de toepassing normaal. -
Anders is de onderhoudsmodus ingeschakeld, tenzij
var/.maintenance.ip
bestaat.var/.maintenance.ip
kan een lijst met IP-adressen bevatten. Als een ingangspunt wordt betreden gebruikend HTTP en het cliëntIP adres beantwoordt aan één van de ingangen in die lijst, dan is de onderhoudswijze weg.
De toepassing installeren
Alvorens u dit bevel gebruikt om onderhoudswijze toe te laten of onbruikbaar te maken, moet u de toepassinginstalleren.
Onderhoudsmodus in- of uitschakelen
Gebruik het magento maintenance
CLI bevel om onderhoudswijze in of onbruikbaar te maken.
Opdrachtgebruik:
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
De optie --ip=<ip address>
is een IP-adres dat wordt vrijgesteld van de onderhoudsmodus (bijvoorbeeld ontwikkelaars die het onderhoud uitvoeren). Om meer dan één IP adres in het zelfde bevel vrij te stellen, gebruik de optie veelvoudige tijden.
--ip=<ip address>
gebruikt met magento maintenance:disable
, wordt de lijst met IP's opgeslagen zodat u deze later kunt gebruiken. Om de lijst van vrijgestelde IPs te ontruimen, gebruik magento maintenance:enable --ip=none
of zie de lijst van vrijgestelde IP adressenhandhaven.De opdracht bin/magento maintenance:status
geeft de status van de onderhoudsmodus weer.
Bijvoorbeeld, om onderhoudswijze zonder IP adresvrijstellingen toe te laten:
bin/magento maintenance:enable
Onderhoudsmodus inschakelen voor alle clients behalve 192.0.2.10 en 192.0.2.11:
bin/magento maintenance:enable --ip=192.0.2.10 --ip=192.0.2.11
Nadat u de toepassing op onderhoudswijze plaatst, moet u alle processen van de berichtrij van de consument tegenhouden.
U kunt deze processen vinden door de opdracht ps -ef | grep queue:consumers:start
uit te voeren en vervolgens de opdracht kill <process_id>
voor elke consument uit te voeren. In een veelvoudige knoopmilieu, herhaal deze taak op elke knoop.
Handhaaf de lijst van vrijgestelde IP adressen
Als u de lijst met vrijgestelde IP-adressen wilt bijhouden, kunt u de optie [--ip=<ip list>]
in de voorafgaande opdrachten gebruiken of het volgende gebruiken:
bin/magento maintenance:allow-ips <ip address> .. <ip address> [--none]
De syntaxis van <ip address> .. <ip address>
is een optionele lijst met door spaties gescheiden IP-adressen die moet worden vrijgesteld.
Met de optie --none
wist u de lijst.
Instellingen voor meerdere winkels
Als u meerdere winkels wilt instellen, elk met een andere indeling en gelokaliseerde inhoud, geeft u de parameter $_GET['skin']
door aan de bedoelde processor.
In het volgende voorbeeld gebruiken we een 503
sjabloonbestand voor typefouten, waarvoor gelokaliseerde inhoud is vereist.
De constructor van de klasse Error_Processor
accepteert een parameter skin
GET om de lay-out te wijzigen:
if (isset($_GET['skin'])) {
$this->_setSkin($_GET['skin']);
}
Dit kan ook worden toegevoegd aan een herschrijfregel in het .htaccess
-bestand dat een skin
-parameter aan de URL toevoegt.
$_GET[ "skin"] parameter
De parameter skin
gebruiken:
-
Controleer of
.maintenance.flag
bestaat. -
Maak een notitie van het hostadres, dat verwijst naar
HTTP_HOST
of een andere variabele, zoals ENV-variabelen. -
Controleer of de parameter
skin
bestaat. -
Stel de parameter in met de onderstaande herschrijfregels.
Hier volgen enkele voorbeelden van herschrijfregels:
- 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
-
Kopieer de volgende bestanden:
pub/errors/default/503.phtml
t/mpub/errors/sub/503.phtml
pub/errors/default/css/styles.css
t/mpub/errors/sub/styles.css
-
Bewerk deze bestanden om gelokaliseerde inhoud in het
503.phtml
-bestand en aangepaste opmaak in hetstyles.css
-bestand te bieden.Zorg ervoor dat de paden naar de map
errors
verwijzen. De mapnaam moet overeenkomen met de URL-parameter die inRewriteRule
wordt aangegeven. In het vorige voorbeeld wordt de mapsub
gebruikt. Deze is opgegeven als een parameter in de mapRewriteRule
(skin=sub
)