OpenSearch 서비스 설정

다음 OpenSearch 서비스는 Elasticsearch에 대한 라이선스 변경 후 Elasticsearch 7.10.2의 오픈 소스 포크입니다. 다음을 참조하십시오. OpenSource 프로젝트 GitHub에서.

WARNING
Elasticsearch 7.11 이상 버전은 클라우드 인프라의 Adobe Commerce에서 지원되지 않습니다. Adobe Commerce 버전 2.3.7-p3, 2.4.3-p2 및 2.4.4 이상 버전은 OpenSearch 서비스를 지원합니다. 온-프레미스 설치는 Elasticsearch을 계속 지원합니다.

OpenSearch를 사용하면 모든 소스, 모든 형식에서 데이터를 가져와 실시간으로 검색하고 시각화할 수 있습니다.

  • 제품 카탈로그의 제품에 대한 빠른 검색 및 고급 검색
  • OpenSearch Analyzer는 여러 언어를 지원합니다
  • 정지어 및 동의어 지원
  • 색인 재지정 작업이 완료될 때까지 색인화는 고객에게 영향을 주지 않습니다

Pro 통합 환경 및 Starter 환경의 서비스 설정에 대해 다음 지침을 따르십시오. master 분기입니다.

NOTE
Adobe Commerce 지원 티켓 제출 Pro 프로덕션 및 스테이징 환경에서 서비스 구성을 변경합니다.
TIP
Adobe은 Adobe Commerce 애플리케이션에 대한 서드파티 검색 도구를 구성하려는 경우에도 항상 Adobe Commerce on cloud infrastructure 프로젝트에 대해 OpenSearch를 설정할 것을 권장합니다. OpenSearch 설정은 타사 검색 도구가 실패할 경우 대체 옵션을 제공합니다.

OpenSearch를 사용하려면:

  1. Starter 및 Pro 통합 환경의 경우 opensearch 에 대한 서비스 .magento/services.yaml 적절한 버전과 할당된 디스크 공간(MB)을 가진 파일. 이 경우 버전 2가 적절합니다. 클라우드 인프라에서 최신 버전의 OpenSearch를 사용하기 때문에 부 버전은 필요하지 않습니다.

    code language-yaml
    opensearch:
        type: opensearch:2
        disk: 1024
    

    Pro 프로젝트의 경우 다음을 수행해야 합니다. Adobe Commerce 지원 티켓 제출 를 사용하여 스테이징 및 프로덕션 환경에서 OpenSearch 버전을 변경할 수 있습니다.

  2. 설정 또는 확인 relationships 의 속성 .magento.app.yaml 파일.

    code language-yaml
    relationships:
        opensearch: "opensearch:opensearch"
    
  3. 코드 변경 사항을 추가, 커밋 및 푸시합니다.

    code language-bash
    git add .magento/services.yaml .magento.app.yaml
    
    code language-bash
    git commit -m "Enable OpenSearch"
    
    code language-bash
    git push origin <branch-name>
    

    이러한 변경 사항이 환경에 미치는 영향에 대한 자세한 내용은 서비스 구성.

  4. 배포 프로세스가 완료되면 SSH를 사용하여 원격 환경에 로그인합니다.

    code language-bash
    magento-cloud ssh
    
  5. 카탈로그 검색 색인을 다시 색인화합니다.

    code language-bash
    bin/magento indexer:reindex catalogsearch_fulltext
    
  6. 캐시를 정리합니다.

    code language-bash
    bin/magento cache:clean
    
TIP
서비스를 처음 설치한 후 설치된 서비스의 소프트웨어 버전을 변경하려면 services.yaml.magento.app.yaml 구성 파일입니다. 다음을 참조하십시오 서비스 버전 변경 서비스 업그레이드 또는 다운그레이드에 대한 지침을 제공합니다.

OpenSearch 소프트웨어 호환성

Adobe Commerce on cloud infrastructure 프로젝트를 설치하거나 업그레이드할 때 항상 OpenSearch 서비스 버전과 오픈서치 PHP Adobe Commerce용 클라이언트.

  • 최초 설정-에 OpenSearch 버전이 지정되었는지 확인합니다. services.yaml 파일은 Adobe Commerce용으로 구성된 OpenSearch PHP 클라이언트와 호환됩니다.

  • 프로젝트 업그레이드-새 애플리케이션 버전의 OpenSearch PHP 클라이언트가 클라우드 인프라에 설치된 OpenSearch 서비스 버전과 호환되는지 확인합니다.

서비스 버전 및 호환성 지원은 Cloud 인프라에서 테스트하고 배포한 버전에 따라 결정되며 Adobe Commerce 온프레미스 배포에서 지원하는 버전과 다른 경우가 있습니다. 다음을 참조하십시오 시스템 요구 사항 다음에서 설치 안내서 를 참조하십시오.

OpenSearch 소프트웨어 호환성을 확인하려면:

  1. 로컬 워크스테이션에서 프로젝트 디렉터리로 변경합니다.

  2. 활성 환경에 대한 OpenSearch 세부 정보를 표시합니다.

    code language-bash
    magento-cloud relationships --property=opensearch
    
  3. 또는 SSH를 사용하여 원격 환경에 로그인할 수 있습니다.

    code language-bash
    magento-cloud ssh
    
  4. OpenSearch 서비스 연결 세부 정보를 검색합니다.

    code language-bash
    vendor/bin/ece-tools env:config:show services
    

    응답에서 OpenSearch 서비스 끝점의 IP 주소와 포트를 찾습니다.

    code language-terminal
    +------------------------------------------+--------------------------------------------------------+
    | opensearch:                                                                                       |
    +------------------------------------------+--------------------------------------------------------+
    | username                                 | null                                                   |
    | scheme                                   | http                                                   |
    | service                                  | opensearch                                             |
    | fragment                                 | null                                                   |
    | ip                                       | 169.254.220.11                                         |
    | hostname                                 | hostf75wi3sd24l.opensearch.service._.magentosite.cloud |
    | port                                     | 9200                                                   |
    | cluster                                  | projectID-develop-4ranwui                              |
    | host                                     | opensearch.internal                                    |
    | rel                                      | opensearch                                             |
    | path                                     | null                                                   |
    | query                                    |                                                        |
    | password                                 | null                                                   |
    | type                                     | opensearch:2                                           |
    | public                                   | false                                                  |
    | host_mapped                              | false                                                  |
    
  5. 설치된 OpenSearch 서비스 검색 version:number 서비스 끝점에서 가져왔습니다.

    code language-bash
    curl -XGET <opensearch-service-endpoint-ip-address>:9200
    
    code language-terminal
    {
       "name" : "opensearch.0",
       "cluster_name" : "opensearch",
       "cluster_uuid" : "_yzaae6-ywSEW1MaAF8ZPWyQ",
       "version" : {
         "distribution" : "opensearch",
         "number" : "2.5.0",
         "build_type" : "deb",
         "build_hash" : "aaaaaaa",
         "build_date" : "2023-01-23T12:07:18.760675Z",
         "build_snapshot" : false,
         "lucene_version" : "9.4.2",
         "minimum_wire_compatibility_version" : "7.10.0",
         "minimum_index_compatibility_version" : "7.0.0"
    },
    "tagline" : "The OpenSearch Project: https://opensearch.org/"
    }
    
TIP
Pro 프로젝트의 경우 다음을 수행해야 합니다. Adobe Commerce 지원 티켓 제출 설치 또는 업데이트 서비스 위치: StagingProduction 환경만 해당됩니다.
필요한 서비스 변경 사항을 표시하고 업데이트된 내용을 포함합니다. .magento.app.yamlservices.yaml 파일을 참조하고 티켓에 PHP 버전을 명시합니다. PHP 버전, 확장, 환경 설정에 대한 셀프서비스 변경 내용은 PHP 설정 위치: 애플리케이션 구성.
에 대한 변경 사항 live 프로덕션 환경 (Pro 전용) 클라우드 인프라 팀이 리소스를 마샬링하고 보안 업그레이드를 수행하기에 충분한 시간을 허용하기 위해 최소 48시간 동안 알림을 제공해야 합니다.

OpenSearch 서비스 다시 시작

OpenSearch 서비스를 다시 시작해야 하는 경우에는 Adobe Commerce 지원 센터에 문의해야 합니다.

추가 검색 구성

  • 기본적으로 클라우드 환경에 대한 검색 구성은 배포할 때마다 다시 생성됩니다. 다음을 사용할 수 있습니다. SEARCH_CONFIGURATION 변수를 배포하여 배포 간 사용자 지정 검색 설정을 유지합니다. 다음을 참조하십시오 변수 배포.

  • 프로젝트에 대한 OpenSearch 서비스를 설정한 후 관리 UI를 사용하여 OpenSearch 연결을 테스트하고 Adobe Commerce에 대한 OpenSearch 설정을 사용자 지정합니다.

OpenSearch에 대한 플러그인 추가

필요한 경우 를 추가하여 OpenSearch에 대한 플러그인을 추가할 수 있습니다. configuration:plugins 섹션에 있는 OpenSearch 서비스에 대한 섹션을 추가했습니다. .magento/services.yaml 파일. 예를 들어 다음 코드는 ICU 분석 및 음성 분석 플러그인을 활성화합니다.

opensearch:
    type: opensearch:2
    disk: 1024
    configuration:
        plugins:
            - analysis-icu
            - analysis-phonetic

다음을 참조하십시오. OpenSearch 프로젝트 플러그인에 대한 자세한 정보입니다.

OpenSearch에 대한 플러그인 제거

에서 플러그인 항목 제거 opensearch: 의 섹션 .magento/services.yaml 파일이 아님 서비스를 제거하거나 비활성화합니다. 서비스를 완전히 비활성화하려면 플러그인을 제거한 후 OpenSearch 데이터를 다시 인덱싱해야 합니다. .magento/services.yaml 파일. 이 설계는 이러한 플러그인에 의존하는 데이터의 가능한 손실 또는 손상을 방지합니다.

OpenSearch 플러그인을 제거하려면:

  1. 에서 OpenSearch 플러그인 항목을 제거합니다 .magento/services.yaml 파일.

  2. 코드 변경 사항을 추가, 커밋 및 푸시합니다.

    code language-bash
    git add .magento/services.yaml
    
    code language-bash
    git commit -m "Remove OpenSearch plugin"
    
    code language-bash
    git push origin <branch-name>
    
  3. 커밋: .magento/services.yaml 클라우드 저장소에 대한 변경 사항입니다.

  4. 카탈로그 검색 색인을 다시 색인화합니다.

    code language-bash
    bin/magento indexer:reindex catalogsearch_fulltext
    
  5. 캐시를 정리합니다.

    code language-bash
    bin/magento cache:clean
    
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26