콘텐츠 검색 및 색인화 indexing

AEM as a Cloud Service의 변경 내용 changes-in-aem-as-a-cloud-service

AEM as a Cloud Service를 통해 Adobe는 AEM 인스턴스 중심 모델에서 Cloud Manager의 CI/CD 파이프라인 기반 n-x AEM 컨테이너를 사용하는 서비스 중심 보기로 이전하는 중입니다. 단일 AEM 인스턴스에서 색인을 구성 및 유지 관리하는 대신 배포 전에 색인 구성을 지정해야 합니다. 프로덕션의 구성 변경으로 CI/CD 정책이 손상되고 있습니다. 프로덕션으로 가져오기 전에 지정, 테스트 및 색인 재지정을 하지 않을 경우 시스템 안정성과 성능에 영향을 줄 수 있으므로 색인 변경에도 동일하게 적용됩니다.

다음은 AEM 6.5 및 이전 버전과 비교한 주요 변경 사항 목록입니다.

제한 사항:

사용 방법 how-to-use

색인 정의는 다음과 같이 세 가지 주요 사용 사례로 분류할 수 있습니다.

위의 1번과 2번은 각각 Cloud Manager 릴리스 일정에서 사용자 지정 코드 기반의 일부로 색인 정의를 생성해야 합니다. 자세한 내용은 AEM as a Cloud Service에 배포 설명서를 참조하십시오.

색인 이름 index-names

색인 정의는 다음 범주 중 하나에 속할 수 있습니다.

새 색인 정의 준비 preparing-the-new-index-definition

OOTB 색인의 사용자 정의의 경우 사용자 정의 또는 사용자 정의 색인 정의가 포함된 새 패키지를 준비합니다. 인덱스 이름은 이름 지정 패턴을 따라야 합니다.

<indexName>-<productVersion>-custom-<customVersion>

완전히 맞춤화된 색인의 경우 이 이름 지정 패턴을 따르는 색인 정의가 포함된 새 색인 정의 패키지를 준비합니다.

<prefix>.<indexName>-<productVersion>-custom-<customVersion>

제한 섹션에서 언급한 바와 같이 패키지 관리자를 사용하여 추출된 색인 정의가 다른 유형(예: elasticsearch)인 경우에도 사용자 지정된 색인 정의의 type을(를) 항상 lucene(으)로 설정해야 합니다.
추출된 색인 정의가 elastic-async(으)로 설정된 경우에도 async 속성을 변경해야 합니다. 사용자 지정된 인덱스 정의에 대해 async 속성을 [async], [async,nrt] 또는 [fulltext-async] 중 하나로 설정해야 합니다.

사용자 정의 색인 정의 배포 deploying-custom-index-definitions

기본 제공 인덱스 damAssetLucene-8의 사용자 지정 버전의 배포를 설명하기 위해 단계별 안내서를 제공합니다. 이 예제에서는 이름을 damAssetLucene-8-custom-1(으)로 바꿉니다. 그런 다음 프로세스는 다음과 같습니다.

프로젝트 구성

Jackrabbit filevault-package-maven-plugin의 버전 >= 1.3.2을(를) 사용하는 것이 좋습니다. 이를 프로젝트에 통합하는 단계는 다음과 같습니다.

새 색인 정의를 추가한 후 Cloud Manager을 사용하여 새 애플리케이션을 배포합니다. 이 배포는 두 개의 작업을 시작하고, 각각 작성 및 게시를 위해 MongoDB 및 Azure 세그먼트 저장소에 인덱스 정의를 추가(및 필요한 경우 병합)합니다. 전환 전에 기본 저장소는 업데이트된 색인 정의로 리인덱싱됩니다.

순환 배포를 사용한 색인 관리 index-management-using-rolling-deployments

색인 관리 개요 what-is-index-management

색인 관리는 색인을 추가, 삭제 및 변경하는 것을 의미합니다. 색인의 정의 변경은 빠르게 진행되지만 변경(“색인 작성”, 기존 색인의 경우, “색인 재지정”) 적용은 시간이 소요됩니다. 즉시 확인할 수 없으며 저장소에서 데이터를 색인화하기 위해 스캔해야 합니다.

롤링 배포 개요 what-are-rolling-deployments

지속적인 배포를 통해 다운타임 없이 업그레이드할 수 있으며 빠른 롤백도 가능합니다. 애플리케이션의 이전 버전은 애플리케이션의 새 버전과 동시에 실행됩니다.

읽기 전용 및 읽기-쓰기 영역 read-only-and-read-write-areas

저장소의 특정 영역(저장소의 읽기 전용 부분)은 애플리케이션의 이전 버전과 새 버전에서 다를 수 있습니다. 저장소의 읽기 전용 영역은 일반적으로 /app 및 /libs입니다. 다음의 예처럼 이탤릭체는 읽기 전용 영역을 표시할 때, 볼드체는 읽기-쓰기 영역에 사용됩니다.

저장소의 읽기-쓰기 영역은 애플리케이션의 모든 버전에서 공유되지만 애플리케이션의 각 버전에 대해 /apps 및 /libs의 특정 세트가 있습니다.

순환 배포를 통한 색인 관리 index-management-without-rolling-deployments

개발 중에 또는 온프레미스 설치를 사용할 때 런타임 시 색인을 추가, 제거 또는 변경할 수 있습니다. 색인은 사용 가능한 경우 사용됩니다. 색인이 애플리케이션의 이전 버전에서 아직 사용되지 않는 경우 색인은 일반적으로 예약된 가동 중지 시간 동안 작성됩니다. 색인 삭제나 기존의 색인 변경 시에도 마찬가지입니다. 색인을 삭제하면 삭제할 때 사용할 수 없게 됩니다.

연속 배포를 통한 색인 관리 index-management-with-rolling-deployments

연속 배포를 사용하면 중단 시간이 없습니다. 업데이트하는 동안 잠시 동안 애플리케이션의 이전 버전(예: 버전 1)과 새 버전(버전 2)이 동일한 저장소에서 동시에 실행됩니다. 버전 1에서 특정 색인을 사용해야 하는 경우 이 색인을 버전 2에서 제거해야 합니다. 색인은 나중에(예: 버전 3에서) 제거해야 하며, 이 시점에서 애플리케이션의 버전 1이 더 이상 실행되지 않는 것이 보장됩니다. 또한 애플리케이션은 버전 2가 수행되고 버전 2의 색인이 사용 가능한 상태여도 버전 1이 잘 작동되는 것처럼 작성되어야 합니다.

새 버전으로 업그레이드가 완료되면 이전 버전은 시스템에서 수집된 불필요한 정보가 될 수 있습니다. 이전 색인은 일반적으로 1주 동안 유지되어 롤백 속도를 높입니다(롤백이 필요한 경우).

다음 테이블은 다섯 개의 색인 정의를 나타냅니다. 색인 cqPageLucene는 두 버전 모두에서 사용되지만 색인 damAssetLucene-custom-1은 버전 2에서만 사용됩니다.

버전 번호는 색인이 변경될 때마다 증가합니다. 사용자 지정 색인 이름이 제품 자체의 색인 이름과 충돌하는 것을 방지하려면 사용자 지정 색인 및 기본 제공 색인에 대한 변경 내용이 -custom-<number>(으)로 끝나야 합니다.

기본 제공 색인 변경 changes-to-out-of-the-box-indexes

Adobe에서 damAssetLucene 또는 cqPageLucene과(와) 같은 기본 제공 색인을 변경하면 damAssetLucene-2 또는 cqPageLucene-2이라는 이름의 새 색인이 만들어집니다. 또는 색인이 이미 맞춤화된 경우 맞춤화된 색인 정의가 아래와 같이 기본 제공 색인의 변경 사항과 병합됩니다. 변경 사항의 병합은 자동으로 진행됩니다. 즉, 기본 제공 색인이 변경되는 경우에는 아무 작업도 수행하지 않아도 됩니다. 하지만 나중에 색인을 다시 맞춤화할 수 있습니다. 이 경우 최신(병합된) 버전을 기준으로 사용하는 것이 중요합니다.

환경은 서로 다른 AEM 버전에 있을 수 있습니다. 예를 들어 dev에 필요한 테스트를 수행한 후 스테이징 및 프로덕션이 아직 릴리스 X에 있고 릴리스 X+1(으)로 업그레이드되기를 기다리는 동안 dev 환경이 릴리스 X+1에 있습니다. 릴리스 X+1이(가) 사용자 지정된 새 버전의 제품 색인과 함께 제공되며 해당 색인의 새 사용자 지정이 필요한 경우 다음 표에서 AEM 릴리스를 기반으로 하는 환경에 설정해야 하는 버전을 설명합니다.

현재 제한 사항 current-limitations

색인 관리는 compatVersion이(가) 2(으)로 설정된 lucene 유형의 색인에 대해서만 지원됩니다. 내부적으로 다른 색인을 구성하고 쿼리에 사용할 수 있습니다(예: Elasticsearch 색인). damAssetLucene 색인에 대해 작성된 쿼리는 AEM as a Cloud Service에서 이 색인의 Elasticsearch 버전에 대해 실행될 수 있습니다. 이 차이는 응용 프로그램 사용자에게는 보이지 않지만 explain 기능과 같은 특정 도구에서는 다른 색인을 보고합니다. Lucene 색인과 Elasticsearch 색인의 차이에 대해서는 Apache Jackrabbit Oak의 Elasticsearch 설명서를 참조하십시오. 고객은 Elasticsearch 색인을 직접 구성할 수 없으며 구성할 필요가 없습니다.

기본 제공 분석기 (즉, 제품과 함께 제공되는 분석기)만 지원됩니다. 사용자 정의 분석기는 지원되지 않습니다.

현재 /oak:index의 콘텐츠 인덱싱은 지원되지 않습니다.

최상의 운영 성능을 위해서는 인덱스가 너무 커서는 안 됩니다. 모든 인덱스의 총 크기를 안내서로 사용할 수 있습니다. 사용자 정의 색인이 추가된 후 이 크기가 100% 이상 증가하고 개발 환경에서 표준 색인을 조정한 경우 사용자 정의 색인 정의를 조정해야 합니다. AEM as a Cloud Service은 시스템 안정성 및 성능에 부정적인 영향을 주는 색인의 배포를 방지하거나 제거할 수 있습니다.

색인 추가 adding-an-index

응용 프로그램의 새 버전 이상에서 사용할 수 있도록 /oak:index/acme.product-1-custom-1(이)라는 이름의 완전히 맞춤화된 색인을 추가하려면 다음과 같이 색인을 구성해야 합니다.

acme.product-1-custom-1

이 구성은 색인 이름 앞에 사용자 지정 식별자를 추가하고 뒤에 점(.)을 넣으면 작동합니다. 식별자는 2~5자 사이여야 합니다.

위와 같이 이 구성은 색인이 애플리케이션의 새 버전에서만 사용되도록 합니다.

색인 변경 changing-an-index

기존 색인을 변경할 때 새 색인을 변경된 색인 정의와 함께 추가해야 합니다. 기존 색인 /oak:index/acme.product-1-custom-1이 변경되는 경우로 예를 들어 보겠습니다. 기존 색인은 /oak:index/acme.product-1-custom-1에 저장되며 새 색인은 /oak:index/acme.product-1-custom-2에 저장됩니다.

애플리케이션의 기존 버전은 다음의 구성을 사용합니다.

/oak:index/acme.product-1-custom-1

애플리케이션의 새 버전은 (변경된) 다음 구성을 사용합니다.

/oak:index/acme.product-1-custom-2

변경 실행 취소 undoing-a-change

경우에 따라 오류 또는 더 이상 수정할 필요가 없기 때문에 색인 정의에서 수정을 실행 취소해야 할 수도 있습니다. 예를 들어 인덱스 정의 damAssetLucene-8-custom-3에 오류가 있는 경우 이전 정의 damAssetLucene-8-custom-2(으)로 되돌릴 수 있습니다. 이렇게 하려면 이전 색인 damAssetLucene-8-custom-2.의 복사본인 damAssetLucene-8-custom-4(이)라는 새 색인을 만듭니다

색인 삭제 removing-an-index

다음은 기본 제공(OOTB) 인덱스의 사용자 지정 및 완전히 사용자 지정된 인덱스에만 적용됩니다. 원래 OOTB 인덱스는 AEM에서 사용되므로 제거할 수 없습니다.

시스템 무결성과 안정성을 보장하기 위해 인덱스 정의는 배포되면 변경할 수 없는 것으로 처리되어야 합니다. 사용자 지정 인덱스 또는 사용자 지정을 제거해야 하는 경우 제거를 효과적으로 시뮬레이션하는 정의를 사용하여 해당 인덱스의 새 버전을 만듭니다
(아래 예 참조)

색인의 새 버전이 배포되면 동일한 색인의 이전 버전은 더 이상 쿼리에서 사용되지 않습니다.
이전 버전은 환경에서 즉시 삭제되지 않습니다.
그러나 주기적으로 실행되는 정리 메커니즘에 의해 가비지 수집이 가능합니다.
실수 발생 시 복구를 허용하도록 설계된 유예 기간 이후
(현재는 색인화가 제거된 시점부터 7일까지이지만 변경될 수 있음),
이 정리 메커니즘은 사용되지 않은 인덱스 데이터를 삭제합니다.
및 은 환경에서 색인의 이전 버전을 비활성화하거나 제거합니다.

아래에서는 OOTB 인덱스의 사용자 지정 항목을 제거하고 완전히 사용자 지정된 인덱스를 제거하는 두 가지 가능한 경우를 설명합니다.

기본 제공 색인의 사용자 지정 제거

OOTB 인덱스의 정의를 새 버전으로 사용하여 변경 실행 취소에 설명된 단계를 따릅니다. 예를 들어 이미 damAssetLucene-8-custom-3을(를) 배포했지만 더 이상 맞춤화가 필요하지 않고 기본 damAssetLucene-8 색인으로 다시 바꾸고 싶다면 damAssetLucene-8의 색인 정의가 포함된 색인 damAssetLucene-8-custom-4을(를) 추가해야 합니다.

완전히 맞춤화된 색인 제거

더미 인덱스를 새 버전으로 사용하여 변경 실행 취소에 설명된 단계를 따릅니다. 더미 색인은 쿼리에 사용되지 않으며 데이터를 포함하지 않으므로 색인이 없는 것과 동일한 효과를 냅니다. 이 예제에서는 이름을 /oak:index/acme.product-1-custom-3로 지정할 수 있습니다. 이 이름은 인덱스 /oak:index/acme.product-1-custom-2을(를) 대체합니다. 이러한 더미 인덱스의 예는 다음과 같습니다.

<acme.product-1-custom-3
        jcr:primaryType="oak:QueryIndexDefinition"
        async="async"
        compatVersion="2"
        includedPaths="/dummy"
        queryPaths="/dummy"
        type="lucene">
        <indexRules jcr:primaryType="nt:unstructured">
            <rep:root jcr:primaryType="nt:unstructured">
                <properties jcr:primaryType="nt:unstructured">
                    <dummy
                        jcr:primaryType="nt:unstructured"
                        name="dummy"
                        propertyIndex="{Boolean}true"/>
                </properties>
            </rep:root>
        </indexRules>
</acme.product-1-custom-3>

색인 및 쿼리 최적화 index-query-optimizations

Apache Jackrabbit Oak는 유연한 색인 구성을 통해 효율적으로 검색 쿼리를 처리할 수 있도록 해 줍니다. 색인은 특히 대형 저장소에서 중요합니다. 모든 쿼리가 적절한 색인에 의해 지원되는지 확인하십시오. 적절한 색인이 없는 쿼리는 수천 개의 노드를 읽을 수 있으며 이는 경고로 기록됩니다.

쿼리와 색인을 최적화하는 방법에 대한 자세한 내용은 이 문서를 참조하십시오.