Commerce 관리자를 사용하여 검색 엔진을 변경할 수 없음(검색 엔진 메뉴에 액세스할 수 없음)
이 문서에서는 검색 엔진 필드가 표시되지 않거나 시스템 값 사용 확인란이 회색으로 표시되어 액세스할 수 없는 경우 Commerce 관리자를 사용하여 Adobe Commerce 검색 엔진을 변경하는 방법에 대한 해결 방법을 제공합니다.
이 문서에서:
영향을 받는 버전
-
Adobe Commerce 온-프레미스: 2.4.X
-
클라우드 인프라의 Adobe Commerce:
- 버전: 2.4.X
- Starter 및 Pro 플랜 아키텍처
-
MySQL, Elasticsearch, Opensearch, 라이브 검색: 지원되는 모든 버전
관리자를 사용하여 검색 엔진 변경(단계)
- Admin 에 관리자로 로그인합니다.
- Admin 사이드바의 왼쪽에서 Stores 을(를) 클릭합니다.
- Settings 에서 Configuration 을(를) 선택합니다.
- Catalog, 아래의 왼쪽 패널로 이동하여 Catalog 을(를) 선택합니다.
- Catalog Search 섹션을 확장합니다.
- Search Engine 필드로 이동하여 Use system value 확인란에서 선택 항목을 제거합니다.
- Search Engine 메뉴를 클릭하고 아래와 같이 사용 가능한 옵션 중 하나를 선택합니다.
- 페이지의 오른쪽 상단 모서리에서 Save Config 을(를) 클릭합니다.
Adobe Commerce 온-프레미스 문제
문제 1: 검색 엔진 필드가 표시되지 않음
카탈로그 검색 섹션에 액세스할 때 검색 엔진 메뉴가 전혀 표시되지 않습니다.
원인: 저장소 보기가 기본 구성이 아닙니다.
관리자의 스토어 보기가 기본 구성 이외의 값으로 설정되었습니다.
검색 엔진은 저장소 범위가 아니라 애플리케이션 수준에서 설정된 전역 구성입니다. Adobe Commerce 애플리케이션 내의 스토어는 다른 검색 엔진을 사용할 수 없습니다.
해결 방법: 저장소 보기를 기본 구성으로 설정
- Admin 에 관리자로 로그인합니다.
- Admin 사이드바의 왼쪽에서 Stores 을(를) 클릭합니다.
- Settings(으)로 이동하여 Configuration 을(를) 선택합니다.
- 왼쪽 상단 모서리에서 Store View 선택기를 클릭하고 기본 구성 을 선택합니다.
- 저장소 보기 변경 내용을 승인하려면 확인 대화 상자에서 OK 을(를) 클릭하십시오.
관련 설명서: 사용 안내서의 범위 변경.
문제 2: "시스템 값 사용"의 선택을 취소할 수 없음
관리자의 카탈로그 검색 섹션에 액세스할 때 시스템 값 사용 확인란이 회색으로 표시되어 나중에 검색 엔진을 변경하기 위해 확인란에서 선택 항목을 제거할 수 없습니다.
원인
기본 검색 엔진이 app/etc/env.php
또는 app/etc/config.php
파일의 응용 프로그램 구성 수준에서 구성되었으므로 관리자를 사용하여 변경할 수 없습니다.
기본 검색 엔진 구성이 있는 섹션의 예:
'system'=>
array (
'default'=>
array (
'catalog'=>
array (
'search'=>
array (
'engine'=>'mysql',
),
),
),
),
솔루션
app/etc/env.php
또는 app/etc/config.php
구성 파일에서 기본 검색 엔진 구성이 있는 섹션을 제거합니다.
개발자 설명서의 관련 문서
Adobe Commerce 구성 가이드의 Adobe Commerce 구성 파일
클라우드 인프라의 Adobe Commerce
클라우드 인프라가 구성된 방식으로 인해 클라우드 인프라의 Adobe Commerce에서는 관리를 사용하여 검색 엔진을 전환할 수 없습니다.
배포 프로세스 중에 Adobe Commerce on cloud infrastructure 배포 스크립트는 Elasticsearch이 MAGENTO_CLOUD_RELATIONSHIPS
변수에 선언되었는지 확인합니다. 선언하면 Elasticsearch이 활성 검색 엔진으로 선택되고 자동으로 구성됩니다. 관리에서는 MySQL 검색 엔진에 액세스할 수 없습니다. Elasticsearch 관계가 선언되지 않은 경우 MySQL이 활성으로 설정되고 Elasticsearch에 액세스할 수 없게 됩니다.
app/etc/env.php
또는 app/etc/config.php
구성 파일을 클라우드 환경에서 직접 편집하는 것은 권장되지 않습니다. 따라서 이러한 파일을 변경하여 Elasticsearch 엔진이 관리자(이전 섹션에서 권장하는 솔루션)에 표시되도록 하는 것은 클라우드 프로젝트에 적용할 수 없습니다.
스테이징 및 프로덕션 환경에서 검색 엔진 변경
MySQL에서 스테이징 및 프로덕션 환경의 Elasticsearch으로 검색 엔진을 전환하기 전에 이전에 환경에서 Elasticsearch을 사용하도록 요청하는 지원 티켓을 제출했으며 티켓이 성공적으로 해결되었는지 확인하십시오.
스테이징 및 프로덕션 환경에서 사용되는 검색 엔진을 변경하려면 로컬 환경에서 .magento.env.yaml
파일의 SEARCH_CONFIGURATION
환경 변수를 변경한 다음, 변경 사항을 적용하려면 통합 및 스테이징/프로덕션 환경에 변경 사항을 푸시합니다.
Elasticsearch 7로 전환하는 경우 결과 .magento.env.yaml
파일의 SEARCH_CONFIGURATION 변수는 다음과 같을 수 있습니다.
stage:
deploy:
SEARCH_CONFIGURATION:
engine: elasticsearch7
elasticsearch_server_hostname: hostname
elasticsearch_server_port: '12345'
elasticsearch_index_prefix: magento
elasticsearch_server_timeout: '15'
Opensearch(2.4.6 이상)(으)로 전환하는 경우 결과 .magento.env.yaml
파일의 SEARCH_CONFIGURATION 변수는 다음과 같을 수 있습니다.
stage:
deploy:
SEARCH_CONFIGURATION:
engine: opensearch
elasticsearch_server_hostname: hostname
elasticsearch_server_port: '12345'
elasticsearch_index_prefix: magento
elasticsearch_server_timeout: '15'
실시간 검색으로 전환하는 경우 결과 .magento.env.yaml
파일의 SEARCH_CONFIGURATION 변수는 다음과 같을 수 있습니다.
stage:
deploy:
SEARCH_CONFIGURATION:
engine: livesearch
관련 설명서
지원 기술 자료
개발자 설명서
- Elasticsearch 서비스 설정
- 빌드 및 배포(
.magento.env.yaml
구성 파일에 대한 설명서) - 변수 배포(SEARCH_CONFIGURATION 섹션)
- 서비스(
.magento/services.yaml
구성 파일에 대한 설명서) - 실시간 검색