유지 관리 모드 활성화 또는 비활성화

다음 안내서는 표준 유지 관리 모드 페이지를 참조합니다. 사용자 지정 유지 관리 페이지를 사용해야 하는 경우 사용자 지정 유지 관리 페이지 만들기 항목을 참조하십시오.

Adobe Commerce은 유지 관리 모드를 사용하여 부트스트래핑을 비활성화합니다. 부트스트래핑을 비활성화하는 것은 사이트를 유지 관리, 업그레이드 또는 재구성하는 동안 유용합니다.

애플리케이션은 다음과 같이 유지 관리 모드를 감지합니다.

애플리케이션 설치

이 명령을 사용하여 유지 관리 모드를 활성화하거나 비활성화하려면 먼저 응용 프로그램을 설치해야 합니다.

유지 관리 모드 활성화 또는 비활성화

유지 관리 모드를 활성화하거나 비활성화하려면 magento maintenance CLI 명령을 사용하십시오.

명령 사용:

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

--ip=<ip address> 옵션은 유지 관리 모드에서 제외할 IP 주소입니다(예: 유지 관리를 수행하는 개발자). 동일한 명령에서 두 개 이상의 IP 주소를 제외하려면 옵션을 여러 번 사용합니다.

bin/magento maintenance:status 명령은 유지 관리 모드의 상태를 표시합니다.

예를 들어 IP 주소 면제가 없는 유지 관리 모드를 활성화하려면 다음을 수행합니다.

bin/magento maintenance:enable

192.0.2.10 및 192.0.2.11을 제외한 모든 클라이언트에 대해 유지 관리 모드를 활성화하려면 다음을 수행하십시오.

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

응용 프로그램을 유지 관리 모드로 설정한 후에는 모든 메시지 대기열 소비자 프로세스를 중지해야 합니다.
이러한 프로세스를 찾는 한 가지 방법은 ps -ef | grep queue:consumers:start 명령을 실행한 다음 각 소비자에 대해 kill <process_id> 명령을 실행하는 것입니다. 여러 노드 환경에서 각 노드에서 이 작업을 반복합니다.

제외 IP 주소 목록 유지

제외 IP 주소 목록을 유지 관리하기 위해 이전 명령에서 [--ip=<ip list>] 옵션을 사용하거나 다음을 사용할 수 있습니다.

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

<ip address> .. <ip address> 구문은 제외할 공백으로 구분된 선택적 IP 주소 목록입니다.

--none 옵션은 목록을 지웁니다.

다중 스토어 설정

각각 다른 레이아웃과 현지화된 콘텐츠를 가진 여러 저장소를 설정하려면 원하는 프로세서에 $_GET['skin'] 매개 변수를 전달하십시오.

다음 예제에서는 현지화된 콘텐츠가 필요한 503 형식 오류 템플릿 파일을 사용하고 있습니다.

Error_Processor 클래스의 생성자가 레이아웃을 변경하기 위해 skin GET 매개 변수를 허용합니다.

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

URL에 skin 매개 변수를 추가하는 .htaccess 파일의 다시 작성 규칙에도 추가할 수 있습니다.

$_GET['skin'] 매개 변수

skin 매개 변수를 사용하려면: