설명서AEM 6.4배포 안내서

작업 오프로딩 offloading-jobs

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • Developer
CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

소개 introduction

오프로드는 토폴로지의 Experience Manager 인스턴스 간에 처리 작업을 배포합니다. 오프로드를 사용하면 특정 유형의 처리를 수행하는 데 특정 Experience Manager 인스턴스를 사용할 수 있습니다. 전문 처리를 통해 사용 가능한 서버 리소스의 사용을 최대화할 수 있습니다.

오프로드는 Apache Sling Discovery 및 Sling JobManager 기능. 오프로딩을 사용하려면 토폴로지에 Experience Manager 클러스터를 추가하고 클러스터에서 처리하는 작업 항목을 식별합니다. 클러스터는 하나 이상의 Experience Manager 인스턴스로 구성되므로 단일 인스턴스가 클러스터로 간주됩니다.

토폴로지에 인스턴스 추가에 대한 내용은 토폴로지 관리.

작업 배포 job-distribution

Sling JobManager 및 JobConsumer를 사용하면 토폴로지에서 처리된 작업을 만들 수 있습니다.

  • 작업 관리자: 특정 주제에 대한 작업을 만드는 서비스입니다.
  • 작업 소비자: 하나 이상의 주제 작업을 실행하는 서비스입니다. 동일한 항목에 여러 JobConsumer 서비스를 등록할 수 있습니다.

JobManager가 작업을 생성할 때 Offloading 프레임워크는 토폴로지 내의 Experience Manager 클러스터를 선택하여 작업을 실행합니다.

  • 클러스터에는 작업 항목에 등록된 JobConsumer를 실행 중인 인스턴스를 하나 이상 포함해야 합니다.
  • 클러스터에 있는 하나 이상의 인스턴스에 대해 항목을 활성화해야 합니다.

자세한 내용은 항목 소비 구성 작업 분배 세분화에 대한 정보입니다.

chlimage_1-109

Offloading 프레임워크에서 작업을 실행할 클러스터를 선택하고 클러스터가 여러 인스턴스로 구성된 경우 Sling Distribution은 클러스터에서 작업을 실행하는 인스턴스를 결정합니다.

작업 페이로드 job-payloads

오프로딩 프레임워크는 작업을 저장소의 리소스와 연결하는 작업 페이로드를 지원합니다. 작업 페이로드는 처리 리소스를 위해 작업을 만들고 작업이 다른 컴퓨터에 오프로드될 때 유용합니다.

작업을 만들 때 페이로드는 작업을 만드는 인스턴스에만 위치합니다. 작업을 오프로드할 때 복제 에이전트는 최종 작업을 사용하는 인스턴스에 페이로드가 생성되었는지 확인합니다. 작업 실행이 완료되면 역복제를 수행하면 작업이 생성된 인스턴스에 페이로드가 다시 복사됩니다.

토폴로지 관리 administering-topologies

토폴로지는 오프로딩에 참여하는 느슨하게 결합된 Experience Manager 클러스터입니다. 클러스터는 하나 이상의 Experience Manager 서버 인스턴스로 구성됩니다(단일 인스턴스가 클러스터로 간주됨).

각 Experience Manager 인스턴스는 다음의 오프로딩 관련 서비스를 실행합니다.

  • 검색 서비스: 토폴로지에 가입하기 위해 토폴로지 커넥터에 요청을 보냅니다.
  • 토폴로지 커넥터: 조인 요청을 받고 각 요청을 수락하거나 거부합니다.

토폴로지의 모든 구성원에 대한 검색 서비스가 멤버 중 하나에 있는 토폴로지 커넥터를 가리킵니다. 다음에 나오는 섹션에서 이 멤버를 루트 멤버라고 합니다.

chlimage_1-110

토폴로지의 각 클러스터에는 지시선으로 인식되는 인스턴스가 포함되어 있습니다. 클러스터 리더는 클러스터의 다른 구성원을 대신하여 토폴로지와 상호 작용합니다. 리더가 클러스터를 벗어나면 클러스터의 새 리더가 자동으로 선택됩니다.

토폴로지 보기 viewing-the-topology

토폴로지 브라우저를 사용하여 Experience Manager 인스턴스가 참여하는 토폴로지의 상태를 탐색합니다. 토폴로지 브라우저는 토폴로지의 클러스터 및 인스턴스를 표시합니다.

각 클러스터에 대해 각 멤버가 클러스터에 가입된 순서와 리더인 멤버를 나타내는 클러스터 멤버 목록이 표시됩니다. Current 속성은 현재 관리 중인 인스턴스를 나타냅니다.

클러스터의 각 인스턴스에 대해 몇 가지 토폴로지 관련 등록 정보를 볼 수 있습니다.

  • 인스턴스의 작업 소비자에 대한 주제 허용 목록.
  • 토폴로지와 연결하기 위해 노출되는 끝점입니다.
  • 오프로드용으로 인스턴스가 등록된 작업 항목입니다.
  • 인스턴스가 처리하는 작업 주제입니다.

  1. Touch UI를 사용하여 도구 탭을 클릭합니다. (http://localhost:4502/tools.html)

  2. Granite 작업 영역에서 브라우저 오프로딩 을 클릭합니다.

  3. 탐색 패널에서 토폴로지 브라우저를 클릭합니다.

    토폴로지에 참여하는 클러스터가 나타납니다.

    chlimage_1-111

  4. 클러스터의 인스턴스 목록과 해당 ID, 현재 상태 및 지시선 상태를 보려면 클러스터를 클릭하십시오.

  5. 보다 자세한 속성을 보려면 인스턴스 ID를 클릭합니다.

웹 콘솔을 사용하여 토폴로지 정보를 볼 수도 있습니다. 콘솔은 토폴로지 클러스터에 대한 추가 정보를 제공합니다.

  • 로컬 인스턴스입니다.
  • 이 인스턴스가 토폴로지(발신)에 연결하는 데 사용하는 토폴로지 커넥터 서비스와 이 인스턴스에 연결하는 서비스(수신)입니다.
  • 토폴로지 및 인스턴스 속성에 대한 기록을 변경합니다.

다음 절차를 사용하여 웹 콘솔의 토폴로지 관리 페이지를 엽니다.

  1. 브라우저에서 웹 콘솔을 엽니다. (http://localhost:4502/system/console)

  2. 주 > 토폴로지 관리를 클릭합니다.

    chlimage_1-112

토폴로지 멤버 자격 구성 configuring-topology-membership

Apache Sling 리소스 기반 검색 서비스는 각 인스턴스에서 실행되어 Experience Manager 인스턴스가 토폴로지와 상호 작용하는 방법을 제어합니다.

Discovery Service는 토폴로지 커넥터 서비스에 주기적인 POST 요청(하트비트)을 전송하여 토폴로지와 연결을 설정하고 유지 관리합니다. 토폴로지 커넥터 서비스는 토폴로지를 조인할 수 있는 IP 주소 또는 호스트 이름 허용 목록을 유지합니다.

  • 토폴로지에 인스턴스를 조인하려면 루트 멤버의 토폴로지 커넥터 서비스의 URL을 지정합니다.
  • 인스턴스가 토폴로지를 조인할 수 있도록 설정하려면 루트 멤버의 토폴로지 커넥터 서비스의 허용 목록에 인스턴스를 추가하십시오.

웹 콘솔 또는 sling:OsgiConfig 노드를 사용하여 org.apache.sling.discovery.impt.Config 서비스의 다음 속성을 구성합니다.

속성 이름
OSGi 이름
설명
기본 값
하트비트 시간 초과(초)
heartbeatTimeout
타깃팅된 인스턴스를 사용할 수 없는 것으로 간주되기 전에 하트비트 응답을 기다리는 시간(초)입니다.
20
하트비트 간격(초)
heartbeatInterval
하트비트 간 시간(초)입니다.
15
최소 이벤트 지연 (초)
minEventDelay

토폴로지가 변경되면 TOPOLOGY_CHANGING에서 TOPOLOGY_CHANGED로 상태 변경을 지연시키는 시간이 소요됩니다. 상태가 TOPOLOGY_CHANGING일 때 발생하는 각 변경 사항은 이 시간 만큼 지연을 증가시킵니다.

이렇게 지연되면 수신기에 이벤트가 쇄도하지 않습니다.

지연을 사용하지 않으려면 0이나 음수를 지정합니다.

3
토폴로지 커넥터 URL
topologyConnectorUrl
하트비트 메시지를 보낼 토폴로지 커넥터 서비스의 URL입니다.
http://localhost:4502/libs/sling/topology/connector
토폴로지 커넥터 허용 목록
topologyConnectorWhitelist
로컬 토폴로지 커넥터 서비스가 토폴로지에서 허용하는 IP 주소 또는 호스트 이름 목록입니다.

localhost

127.0.0.1

저장소 설명자 이름
leaderElectionRepositoryDescriptor
<값 없음>

다음 절차를 사용하여 CQ 인스턴스를 토폴로지의 루트 멤버에 연결합니다. 프로시저는 인스턴스가 루트 토폴로지 멤버의 토폴로지 커넥터 URL을 가리킵니다. 토폴로지의 모든 멤버에 대해 이 절차를 수행합니다.

  1. 브라우저에서 웹 콘솔을 엽니다. (http://localhost:4502/system/console)
  2. 주 > 토폴로지 관리를 클릭합니다.
  3. 검색 서비스 구성을 클릭합니다.
  4. 토폴로지 커넥터 URL 속성에 항목을 추가하고 루트 토폴로지 멤버의 토폴로지 커넥터 서비스의 URL을 지정합니다. URL은 https://rootservername:4502/libs/sling/topology/connector 형식입니다.

토폴로지의 루트 멤버에 대해 다음 절차를 수행합니다. 프로시저는 다른 토폴로지 멤버의 이름을 해당 검색 서비스 허용 목록에 추가합니다.

  1. 브라우저에서 웹 콘솔을 엽니다. (http://localhost:4502/system/console)
  2. 주 > 토폴로지 관리를 클릭합니다.
  3. 검색 서비스 구성을 클릭합니다.
  4. 토폴로지의 각 멤버에 대해 Topology Connector 허용 목록 속성에 항목을 추가하고 토폴로지 멤버의 호스트 이름 또는 IP 주소를 지정합니다.

항목 소비 구성 configuring-topic-consumption

오프로딩 브라우저를 사용하여 토폴로지의 Experience Manager 인스턴스에 대한 주제 소비를 구성합니다. 각 인스턴스에 대해 사용하는 주제를 지정할 수 있습니다. 예를 들어 하나의 인스턴스만 특정 유형의 주제를 사용하도록 토폴로지를 구성하려면 하나를 제외한 모든 인스턴스에서 주제를 비활성화합니다.

작업은 라운드 로빈 논리를 사용하여 관련 항목이 활성화된 인스턴스 간에 분산됩니다.

  1. Touch UI를 사용하여 도구 탭을 클릭합니다. (http://localhost:4502/tools.html)

  2. Granite 작업 영역에서 브라우저 오프로딩 을 클릭합니다.

  3. 탐색 패널에서 브라우저 오프로드 를 클릭합니다.

    항목을 사용할 수 있는 오프로딩 항목 및 서버 인스턴스가 나타납니다.

    chlimage_1-113

  4. 인스턴스에 대한 주제 소비를 비활성화하려면 상위 이름 아래에서 인스턴스 옆에 있는 사용 안 함 을 클릭합니다.

  5. 인스턴스에 대한 모든 주제 소비를 구성하려면 주제 아래의 인스턴스 식별자를 클릭합니다.

    chlimage_1-114

  6. 항목 옆에 있는 다음 단추 중 하나를 클릭하여 인스턴스에 대한 소비 동작을 구성한 다음 저장을 클릭합니다.

    • 활성화됨: 이 인스턴스는 이 항목의 작업을 사용합니다.
    • 비활성화됨: 이 인스턴스는 이 항목의 작업을 사용하지 않습니다.
    • 제외: 이 인스턴스는 이 항목의 작업만 사용합니다.

    참고: 항목에 대해 제외 를 선택하면 다른 모든 항목이 자동으로 사용 안 함으로 설정됩니다.

설치된 Job 소비자 installed-job-consumers

여러 JobConsumer 구현이 Experience Manager과 함께 설치됩니다. 이러한 JobConsumer가 등록된 항목은 오프로딩 브라우저에 나타납니다. 표시되는 추가 항목은 사용자 지정 JobConsumers가 등록한 항목입니다. 다음 표에서는 기본 JobConsumer에 대해 설명합니다.

작업 항목
서비스 PID
설명
/
org.apache.sling.event.impl.jobs.deprecated.EventAdminBridge
Apache Sling과 함께 설치됩니다. 이전 버전과의 호환성을 위해 OSGi 이벤트 관리자가 생성하는 작업을 처리합니다.
com/day/cq/replication/job/*
com.day.cq.replication.impl.AgentManagerImpl
작업 페이로드를 복제하는 복제 에이전트.
com/adobe/granite/workflow/offloading
com.adobe.granite.workflow.core.offloading.WorkflowOffloadingJobConsumer
DAM 자산 업데이트 오프로더 워크플로우가 생성하는 작업을 처리합니다.

인스턴스에 대한 항목 비활성화 및 활성화 disabling-and-enabling-topics-for-an-instance

Apache Sling Job Consumer Manager 서비스는 주제 허용 목록 및 차단 목록 속성을 제공합니다. Experience Manager 인스턴스에서 특정 주제 처리를 활성화하거나 비활성화하도록 이러한 속성을 구성합니다.

참고: 인스턴스가 토폴로지에 속하는 경우 토폴로지의 모든 컴퓨터에서 브라우저 오프로딩 을 사용하여 항목을 활성화하거나 비활성화할 수도 있습니다.

사용 가능한 주제 목록을 만드는 논리는 먼저 허용 목록에 있는 모든 주제를 허용하는 다음 차단 목록에 있는 주제를 제거합니다. 기본적으로 모든 주제가 활성화됩니다(허용 목록 값은 *)이고 사용할 수 없는 항목이 없습니다(차단 목록에 값이 없음).

웹 콘솔 또는 sling:OsgiConfig 노드 아래에 나열된 속성을 구성합니다. 대상 sling:OsgiConfig 노드, 작업 소비자 관리자 서비스의 PID는 org.apache.sling.event.impl.jobs.JobConsumerManager 입니다.

웹 콘솔의 속성 이름
OSGi ID
설명
주제 화이트리스트
job.consumermanager.whitelist
로컬 JobManager 서비스가 처리하는 주제 목록입니다. 기본값(&A) 모든 항목을 등록된 TopicConsumer 서비스로 보냅니다.
항목 블랙리스트
job.consumermanager.blacklist
로컬 JobManager 서비스가 처리하지 않는 주제 목록입니다.

오프로드용 복제 에이전트 만들기 creating-replication-agents-for-offloading

오프로딩 프레임워크는 복제를 사용하여 작성자와 작업자 간에 리소스를 전송합니다. 인스턴스가 토폴로지에 참여할 때 오프로딩 프레임워크는 자동으로 복제 에이전트를 생성합니다. 에이전트가 기본값으로 생성됩니다. 에이전트가 인증에 사용하는 암호를 수동으로 변경해야 합니다.

CAUTION
자동 생성된 복제 에이전트 관련 알려진 문제를 해결하려면 새 복제 에이전트를 수동으로 만들어야 합니다. 다음 절차를 따르십시오. 자동 생성된 복제 에이전트를 사용하는 문제 오프로드용 에이전트를 만들기 전에

오프로드용 인스턴스 간에 작업 페이로드를 전송하는 복제 에이전트를 만듭니다. 다음 그림은 작성자에서 작업자 인스턴스로 오프로드하는 데 필요한 에이전트를 보여줍니다. 작성자는 Sling ID가 1이고 작업자 인스턴스는 Sling ID가 2입니다.

chlimage_1-115

이 설정을 사용하려면 다음 세 가지 에이전트가 필요합니다.

  1. 작업자 인스턴스에 복제하는 작성자 인스턴스의 송신 에이전트입니다.
  2. 작업자 인스턴스의 보낸 편지함에서 가져오는 작성자 인스턴스의 역방향 에이전트입니다.
  3. 작업자 인스턴스의 보낼 편지함 에이전트입니다.

이 복제 구성표는 작성자와 게시 인스턴스 간에 사용되는 복제 구성표와 유사합니다. 그러나 오프로딩 상황의 경우 관련된 모든 인스턴스가 작성 인스턴스를 만듭니다.

NOTE
오프로딩 프레임워크는 토폴로지를 사용하여 오프로딩 인스턴스의 IP 주소를 가져옵니다. 그러면 프레임워크는 이러한 IP 주소를 기반으로 복제 에이전트를 자동으로 만듭니다. 나중에 오프로딩 인스턴스의 IP 주소가 변경되면 인스턴스가 다시 시작된 후 변경 내용이 토폴로지에 자동으로 표시됩니다. 그러나 오프로딩 프레임워크는 새 IP 주소를 반영하도록 복제 에이전트를 자동으로 업데이트하지 않습니다. 이러한 상황을 방지하려면 토폴로지의 모든 인스턴스에 대해 고정 IP 주소를 사용하십시오.

오프로드용 복제 에이전트 이름 지정 naming-the-replication-agents-for-offloading

에 특정 형식 사용 이름 오프로딩 프레임워크에서 특정 작업자 인스턴스에 대해 올바른 에이전트를 자동으로 사용하도록 복제 에이전트의 속성입니다.

작성자 인스턴스에서 나가는 에이전트 이름을 지정합니다.

offloading_<slingid>, 위치 <slingid> 는 작업자 인스턴스의 Sling ID입니다.

예: offloading_f5c8494a-4220-49b8-b079-360a72f71559

작성자 인스턴스에서 역방향 에이전트의 이름을 지정합니다.

offloading_reverse_<slingid>, 위치 <slingid> 는 작업자 인스턴스의 Sling ID입니다.

예: offloading_reverse_f5c8494a-4220-49b8-b079-360a72f71559

작업자 인스턴스에서 보낸 편지함의 이름을 지정합니다.

offloading_outbox

보내는 에이전트 만들기 creating-the-outgoing-agent

  1. 만들기 복제 에이전트 작성자. (자세한 내용은 복제 에이전트 설명서). 원하는 대로 지정합니다. 제목. 다음 이름 명명 규칙을 준수해야 합니다.

  2. 다음 속성을 사용하여 에이전트를 생성합니다.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    속성 값
    설정 > 직렬화 유형 기본값
    전송 >전송 URI https://<ip of target instance>:<port>/bin/receive?sling:authRequestLogin=1
    전송 > 전송 사용자 대상 인스턴스의 복제 사용자
    전송 > 전송 암호 대상 인스턴스의 복제 사용자 암호
    Extended > HTTP 메서드 POST
    트리거 > 기본값 무시 True

역방향 에이전트 만들기 creating-the-reverse-agent

  1. 만들기 역방향 복제 에이전트 작성자. (자세한 내용은 복제 에이전트 설명서) 원하는 대로 지정합니다. 제목. 다음 이름 명명 규칙을 준수해야 합니다.

  2. 다음 속성을 사용하여 에이전트를 생성합니다.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
    속성 값
    설정 > 직렬화 유형 기본값
    전송 >전송 URI https://<ip of target instance>:<port>/bin/receive?sling:authRequestLogin=1
    전송 > 전송 사용자 대상 인스턴스의 복제 사용자
    전송 > 전송 암호 대상 인스턴스의 복제 사용자 암호
    Extended > HTTP 메서드 GET

보낼 편지함 에이전트 만들기 creating-the-outbox-agent

  1. 만들기 복제 에이전트 작업자 인스턴스에서 사용됩니다. (자세한 내용은 복제 에이전트 설명서) 원하는 대로 지정합니다. 제목. 다음 이름 반드시 offloading_outbox.

  2. 다음 속성을 사용하여 에이전트를 생성합니다.

    table 0-row-2 1-row-2 2-row-2 3-row-2
    속성 값
    설정 > 직렬화 유형 기본값
    전송 >전송 URI repo://var/replication/outbox
    트리거 > 기본값 무시 True

Sling ID 찾기 finding-the-sling-id

다음 방법 중 하나를 사용하여 Experience Manager 인스턴스의 Sling ID를 얻습니다.

  • 웹 콘솔을 열고 Sling 설정에서 Sling ID 속성( )의 값을 찾습니다.http://localhost:4502/system/console/status-slingsettings). 이 메서드는 인스턴스가 아직 토폴로지의 일부가 아닌 경우에 유용합니다.
  • 인스턴스가 이미 토폴로지의 일부인 경우 토폴로지 브라우저를 사용합니다.

DAM 자산 처리 오프로딩 offloading-the-processing-of-dam-assets

특정 인스턴스가 DAM에서 추가 또는 업데이트된 자산의 백그라운드 처리를 수행하도록 토폴로지 인스턴스를 구성합니다.

기본적으로, Experience Manager은 DAM 자산이 변경되거나 DAM에 자산이 추가되면 DAM 자산 업데이트 워크플로우를 실행합니다. Experience Manager이 DAM 자산 업데이트 오프로더 워크플로우를 대신 실행하도록 기본 동작을 변경합니다. 이 워크플로우는 주제가 있는 JobManager 작업을 생성합니다 com/adobe/granite/workflow/offloading. 그런 다음 전용 작업자에게 작업이 오프로드되도록 토폴로지를 구성합니다.

CAUTION
워크플로우 오프로딩과 함께 사용할 때는 워크플로우를 일시적이지 않아야 합니다. 예를 들어 자산 오프로딩에 사용할 때 DAM 자산 업데이트 워크플로우가 일시적이지 않아야 합니다. 워크플로우에서 임시 플래그를 설정/해제하려면 다음을 참조하십시오 임시 워크플로우.

다음 절차에서는 오프로딩 토폴로지에 대해 다음 특성을 가정합니다.

  • 하나 이상의 Experience Manager 인스턴스가 DAM 자산을 추가하거나 업데이트하기 위해 사용자가 상호 작용하는 작성 인스턴스를 작성합니다.
  • 사용자는 DAM 자산을 처리하는 하나 이상의 Experience Manager 인스턴스와 직접 상호 작용하지 않습니다. 이러한 인스턴스는 DAM 자산의 백그라운드 처리에 사용됩니다.

  1. 각 Experience Manager 인스턴스에서 루트 지형 커넥터를 가리키도록 검색 서비스를 구성합니다. (자세한 내용은 토폴로지 멤버 자격 구성)

  2. 연결 인스턴스가 허용 목록에 있도록 루트 지형 커넥터를 구성합니다.

  3. 오프로딩 브라우저 를 열고 을 비활성화합니다 com/adobe/granite/workflow/offloading 사용자가 DAM 자산을 업로드하거나 변경하기 위해 상호 작용하는 인스턴스에 대한 항목.

    chlimage_1-116

  4. 사용자가 DAM 자산을 업로드하거나 변경하기 위해 상호 작용하는 각 인스턴스에서 DAM 자산 업데이트 오프로딩 워크플로우를 사용하도록 워크플로우 런처를 구성합니다.

    1. 워크플로우 콘솔을 엽니다.
    2. 시작 관리자 탭을 클릭합니다.
    3. DAM 자산 업데이트 워크플로우를 실행하는 두 개의 런처 구성을 찾습니다. 하나의 런처 구성 이벤트 유형은 Node Created이고 다른 유형은 Node Modified입니다.
    4. DAM 자산 업데이트 오프로딩 워크플로우를 실행하도록 두 이벤트 유형을 모두 변경합니다. (런처 구성에 대한 자세한 내용은 노드가 변경될 때 워크플로우 시작)

  5. DAM 자산의 배경 처리를 수행하는 인스턴스에서 DAM 자산 업데이트 워크플로우를 실행하는 워크플로우 런처를 비활성화합니다.

추가 참조 further-reading

이 페이지에 표시된 세부 사항 외에 다음을 읽을 수도 있습니다.

recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56