여러 도메인에 Dispatcher 사용 using-dispatcher-with-multiple-domains

Dispatcher를 사용하여 다음의 조건을 지원하면서 여러 웹 도메인에서 페이지 요청을 처리합니다.

예를 들어 회사에서 브랜드 A와 브랜드 B의 두 가지 브랜드에 대한 웹 사이트를 게시할 경우, 웹 사이트 페이지의 콘텐츠는 AEM에서 작성되고 동일한 저장소 작업 영역에 저장됩니다.

/
| - content
   | - sitea
       | - content nodes
   | - siteb
       | - content nodes

BrandA.com의 페이지는 /content/sitea 아래에 저장됩니다. URL https://BrandA.com/en.html에 대한 클라이언트 요청은 /content/sitea/en 노드에 대해 렌더링된 페이지로 반환됩니다. 마찬가지로 BrandB.com의 페이지는 /content/siteb 아래에 저장됩니다.

Dispatcher를 사용하여 콘텐츠를 캐시할 때 클라이언트 HTTP 요청의 페이지 URL, 해당 캐시 파일의 경로, 저장소에 있는 해당 파일의 경로 간에 연결합니다.

클라이언트 요청

클라이언트가 웹 서버에 HTTP 요청을 보낼 때 요청된 페이지의 URL은 Dispatcher 캐시의 콘텐츠로(궁극적으로는 저장소의 콘텐츠로) 확인되어야 합니다.

캐시 무효화

Dispatcher가 캐시된 파일을 무효화하도록 Dispatcher 플러시 복제 에이전트가 요청할 때 저장소의 콘텐츠 경로는 캐시의 콘텐츠로 확인되어야 합니다.

여러 도메인에서 Dispatcher를 사용하려면 AEM, Dispatcher 및 웹 서버를 구성해야 합니다. 이 페이지에 설명된 솔루션은 일반적이며 대부분의 환경에 적용됩니다. 일부 AEM 토폴로지의 복잡성으로 인해 특정 문제를 해결하기 위해 솔루션에 추가 사용자 정의 구성이 필요할 수 있습니다. 기존 IT 인프라 및 관리 정책을 충족하도록 예제를 조정해야 할 수 있습니다.

URL 매핑 url-mapping

도메인 URL 및 콘텐츠 경로가 캐시된 파일로 확인되도록 하려면 프로세스 중 파일 경로 또는 페이지 URL을 변환해야 합니다. 다음과 같은 일반적인 전략에 대한 설명이 제공됩니다. 여기에서는 경로 또는 URL 변환이 프로세스의 다양한 지점에서 발생합니다.

웹 페이지에 짧은 URL을 사용하는 것이 바람직합니다. 일반적으로 페이지 URL은 웹 콘텐츠가 포함된 저장소 폴더의 구조를 반영합니다. 단, URL은 최상위 저장소 노드(예: /content)를 표시하지 않습니다. 클라이언트가 AEM 저장소의 구조를 반드시 알고 있는 것은 아닙니다.

일반적인 요구 사항 general-requirements

여러 도메인에서 작동하는 Dispatcher를 지원하려면 환경에서 다음 구성을 구현해야 합니다.

제공된 예제를 위한 환경 environment-for-the-provided-examples

제공된 예제 솔루션은 다음과 같은 특성을 가진 환경에 적용됩니다.

  | - /content
    | - sitea
  |    | - content nodes
    | - siteb
       | - content nodes

웹 서버의 문서 루트

  | - /usr
    | - lib
      | - apache
        | - httpd-2.4.3
          | - htdocs
            | - content
              | - sitea
                 | - content nodes
              | - siteb
                 | - content nodes

AEM이 수신 URL 재작성 aem-rewrites-incoming-urls

리소스 확인을 위한 Sling 매핑을 사용하면 수신 URL을 AEM 콘텐츠 경로와 연결할 수 있습니다. Dispatcher의 렌더링 요청이 저장소의 올바른 콘텐츠로 확인되도록 AEM 게시 인스턴스에 매핑을 만듭니다.

페이지 렌더링에 대한 Dispatcher 요청은 웹 서버에서 전달된 URL을 사용하여 페이지를 식별합니다. URL에 도메인 이름이 포함된 경우 Sling 매핑은 URL을 콘텐츠로 확인합니다. 다음 그래픽은 /content/sitea/en 노드에 대한 branda.com/en.html URL의 매핑을 보여 줍니다.

Dispatcher 캐시는 저장소 노드 구조를 미러링합니다. 따라서 페이지 활성화가 발생하면 캐시된 페이지를 무효화하기 위한 결과 요청에 URL 또는 경로 변환이 필요하지 않습니다.

웹 서버에서 가상 호스트 정의 define-virtual-hosts-on-the-web-server

각 웹 도메인에 다른 문서 루트를 할당할 수 있도록 웹 서버에서 가상 호스트를 정의합니다.

다음 예제 httpd.conf 파일은 Apache 웹 서버에 대해 두 개의 가상 도메인을 구성합니다.

이 구성에서 웹 서버는 https://branda.com/en/products.html에 대한 요청을 수신할 때 다음 작업을 수행합니다.

httpd.conf httpd-conf

# load the Dispatcher module
LoadModule dispatcher_module modules/mod_dispatcher.so
# configure the Dispatcher module
<IfModule disp_apache2.c>
 DispatcherConfig conf/dispatcher.any
 DispatcherLog    logs/dispatcher.log
 DispatcherLogLevel 3
 DispatcherNoServerHeader 0
 DispatcherDeclineRoot 0
 DispatcherUseProcessedURL 0
 DispatcherPassError 0
</IfModule>

# Define virtual host for brandA.com
<VirtualHost *:80>
  ServerName branda.com
  DocumentRoot /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea
   <Directory /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea>
     <IfModule disp_apache2.c>
       SetHandler dispatcher-handler
       ModMimeUsePathInfo On
     </IfModule>
     Options FollowSymLinks
     AllowOverride None
   </Directory>
</VirtualHost>

# define virtual host for brandB.com
<VirtualHost *:80>
  ServerName brandB.com
  DocumentRoot /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb
   <Directory /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb>
     <IfModule disp_apache2.c>
       SetHandler dispatcher-handler
       ModMimeUsePathInfo On
     </IfModule>
     Options FollowSymLinks
     AllowOverride None
   </Directory>
</VirtualHost>

# document root for web server
DocumentRoot "/usr/lib/apache/httpd-2.4.3/htdocs"

가상 호스트는 주 서버 섹션에 구성된 DispatcherConfig 속성 값을 상속합니다. 가상 호스트는 자체 DispatcherConfig 속성을 포함하여 기본 서버 구성을 재정의할 수 있습니다.

여러 도메인을 처리하도록 Dispatcher 구성 configure-dispatcher-to-handle-multiple-domains

도메인 이름과 해당 가상 호스트를 포함하는 URL을 지원하려면 다음 Dispatcher 팜을 정의하십시오.

가상 호스트를 위한 Dispatcher 팜 생성

클라이언트 HTTP 요청의 URL이 Dispatcher 캐시의 올바른 파일로 확인되도록 가상 호스트를 위한 팜에는 다음 구성이 있어야 합니다.

또한 AEM 게시 인스턴스는 가상 호스트에 대한 렌더링으로 지정되어야 합니다. 필요에 따라 다른 팜 속성을 구성합니다. 다음 코드는 branda.com 도메인에 대한 축약된 팜 구성입니다.

/farm_sitea  {
    ...
    /virtualhosts { "branda.com" }
    /renders {
      /rend01  { /hostname "127.0.0.1"  /port "4503" }
    }
    /filter {
      /0001 { /type "deny"  /glob "*" }
      /0023 { /type "allow" /glob "*/en*" }
      ...
     }
    /cache {
      /docroot "/usr/lib/apache/httpd-2.4.3/htdocs/content/sitea"
      ...
   }
   ...
}

캐시 무효화를 위한 Dispatcher 팜 생성

캐시된 파일 무효화 요청을 처리하려면 Dispatcher 팜이 필요합니다. 이 팜은 각 가상 호스트의 docroot 디렉터리에 있는 .stat 파일에 액세스할 수 있어야 합니다.

다음 속성 구성을 사용하면 Dispatcher가 캐시의 파일에서 AEM 콘텐츠 저장소의 파일을 확인할 수 있습니다.

/statfileslevel속성은 .stat 파일이 각 가상 호스트의 루트 디렉터리에 생성될 수 있을 만큼 충분히 높아야 합니다. 이 속성을 사용하면 각 도메인의 캐시를 개별적으로 무효화할 수 있습니다. 예제 설정의 경우 /statfileslevel 값이 2이면 *docroot*/content/sitea 디렉터리와 *docroot*/content/siteb 디렉터리에 .stat 파일을 생성합니다.

또한 게시 인스턴스는 가상 호스트에 대한 렌더링으로 지정되어야 합니다. 필요에 따라 다른 팜 속성을 구성합니다. 다음 코드는 캐시 무효화에 사용되는 팜의 축약된 구성입니다.

/farm_flush {
    ...
    /virtualhosts   { "invalidation_only" }
    /renders  {
      /rend01  { /hostname "127.0.0.1" /port "4503" }
    }
    /filter   {
      /0001 { /type "deny"  /glob "*" }
      /0023 { /type "allow" /glob "*/content*" }
      ...
      }
    /cache  {
       /docroot "/usr/lib/apache/httpd-2.4.3/htdocs"
       /statfileslevel "2"
       ...
   }
   ...
}

웹 서버를 시작하면 Dispatcher 로그(디버그 모드)에 모든 팜의 초기화가 표시됩니다.

Dispatcher initializing (build 4.1.2)
[Fri Nov 02 16:27:18 2012] [D] [24974(140006182991616)] farms[farm_sitea].cache.docroot = /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea
[Fri Nov 02 16:27:18 2012] [D] [24974(140006182991616)] farms[farm_siteb].cache.docroot = /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb
[Fri Nov 02 16:27:18 2012] [D] [24974(140006182991616)] farms[farm_flush].cache.docroot = /usr/lib/apache/httpd-2.4.3/htdocs
[Fri Nov 02 16:27:18 2012] [I] [24974(140006182991616)] Dispatcher initialized (build 4.1.2)

리소스 확인을 위한 Sling 매핑 구성 configure-sling-mapping-for-resource-resolution

리소스 확인을 위한 Sling 매핑을 사용하여 도메인 기반 URL이 AEM 게시 인스턴스의 콘텐츠로 확인되도록 합니다. 리소스 매핑은 Dispatcher에서(원래 클라이언트 HTTP 요청에서) 들어오는 URL을 콘텐츠 노드로 변환합니다.

Sling 리소스 매핑에 대한 자세한 내용은 Sling 설명서의 리소스 해결을 위한 매핑을 참조하십시오.

다른 매핑이 필요할 수 있지만 일반적으로 다음 리소스에 매핑이 필요합니다.

콘텐츠 페이지에 대한 매핑을 생성한 후 필요한 추가 매핑을 검색하려면 웹 브라우저를 사용하여 웹 서버에서 페이지를 엽니다. 게시 인스턴스의 error.log 파일에서 찾을 수 없는 리소스에 대한 메시지를 찾으십시오. 다음 예제 메시지는 /etc/clientlibs에 대한 매핑이 필요함을 나타냅니다.

01.11.2012 15:59:24.601 *INFO* [10.36.34.243 [1351799964599] GET /etc/clientlibs/foundation/jquery.js HTTP/1.1] org.apache.sling.engine.impl.SlingRequestProcessorImpl service: Resource /content/sitea/etc/clientlibs/foundation/jquery.js not found

예제 리소스 매핑 노드

다음 표에는 branda.com 도메인에 대한 리소스 매핑을 구현하는 노드가 나열되어 있습니다. brandb.com 도메인에 대해 유사한 노드가 생성됩니다(예: /etc/map/http/brandb.com). HTML 페이지의 참조가 Sling의 컨텍스트에서 올바르게 해석되지 않을 때 모든 경우에 매핑이 필요합니다.

Dispatcher 플러시 복제 에이전트 구성 configuring-the-dispatcher-flush-replication-agent

AEM 게시 인스턴스의 Dispatcher 플러시 복제 에이전트는 올바른 Dispatcher 팜에 무효화 요청을 보내야 합니다. 팜을 대상으로 지정하려면 전송 탭에서 Dispatcher 플러시 복제 에이전트의 URI 속성을 사용합니다. 캐시를 무효화하도록 구성된 Dispatcher 팜의 /virtualhost 속성 값을 포함합니다.

https://*webserver_name*:*port*/*virtual_host*/dispatcher/invalidate.cache

예를 들어 이전 예제의 farm_flush 팜을 사용하려면 URI는 https://localhost:80/invalidation_only/dispatcher/invalidate.cache입니다.

웹 서버가 수신 URL 재작성 the-web-server-rewrites-incoming-urls

웹 서버의 내부 URL 재작성 기능을 사용하여 도메인 기반 URL을 Dispatcher 캐시의 파일 경로로 변환합니다. 예를 들어 https://brandA.com/en.html 페이지에 대한 클라이언트 요청은 웹 서버의 문서 루트에 있는 content/sitea/en.html파일로 변환됩니다.

Dispatcher 캐시는 저장소 노드 구조를 미러링합니다. 따라서 페이지 활성화가 발생하면 캐시된 페이지를 무효화하기 위한 결과 요청에 URL 또는 경로 변환이 필요하지 않습니다.

웹 서버에서 가상 호스트 및 재작성 규칙 정의 define-virtual-hosts-and-rewrite-rules-on-the-web-server

웹 서버에서 다음 측면을 구성합니다.

다음 예제 httpd.conf 파일은 Apache 웹 서버에 대해 두 개의 가상 호스트를 구성합니다.

예를 들어 웹 서버는 https://brandA.com/en/products.html URL이 포함된 요청을 수신할 때 다음 작업을 수행합니다.

httpd.conf httpd-conf-1

# load the Dispatcher module
LoadModule dispatcher_module modules/mod_dispatcher.so
# configure the Dispatcher module
<IfModule disp_apache2.c>
 DispatcherConfig conf/dispatcher.any
 DispatcherLog    logs/dispatcher.log
 DispatcherLogLevel 3
 DispatcherNoServerHeader 0
 DispatcherDeclineRoot 0
 DispatcherUseProcessedURL 1
 DispatcherPassError 0
</IfModule>

# Define virtual host for brandA.com
<VirtualHost *:80>
  ServerName branda.com
  DocumentRoot /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea
  RewriteEngine  on
  RewriteRule    ^/(.*)\.html$  /content/sitea/$1.html [PT]
   <Directory /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea>
     <IfModule disp_apache2.c>
       SetHandler dispatcher-handler
       ModMimeUsePathInfo On
     </IfModule>
     Options FollowSymLinks
     AllowOverride None
   </Directory>
</VirtualHost>

# define virtual host for brandB.com
<VirtualHost *:80>
  ServerName brandB.com
  DocumentRoot /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb
  RewriteEngine  on
  RewriteRule    ^/(.*)\.html$  /content/siteb/$1.html [PT]
   <Directory /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb>
     <IfModule disp_apache2.c>
       SetHandler dispatcher-handler
       ModMimeUsePathInfo On
     </IfModule>
     Options FollowSymLinks
     AllowOverride None
   </Directory>
</VirtualHost>

# document root for web server
DocumentRoot "/usr/lib/apache/httpd-2.4.3/htdocs"

Dispatcher 팜 구성 configure-a-dispatcher-farm

웹 서버가 URL을 재작성할 때 Dispatcher는 Dispatcher 구성에 따라 정의된 단일 팜이 필요합니다. 웹 서버 가상 호스트 및 URL 이름 바꾸기 규칙을 지원하려면 다음 구성이 필요합니다.

다음 예제 구성 파일은 Dispatcher와 함께 설치된 예제 dispatcher.any 파일을 기반으로 합니다. 이전 httpd.conf 파일의 웹 서버 구성을 지원하려면 다음 변경이 필요합니다.

평소와 같이, 캐시의 문서 루트는 웹 서버의 문서 루트(40행)와 동일합니다. /usr/lib/apache/httpd-2.4.3/htdocs

dispatcher.any dispatcher-any

/name "testDispatcher"
/farms
  {
  /dispfarm0
    {
    /clientheaders
      {
      "*"
      }
    /virtualhosts
      {
      "brandA.com" "brandB.com"
      }
    /renders
      {
      /rend01    {  /hostname "127.0.0.1"   /port "4503"  }
      }
    /filter
      {
      /0001 { /type "deny"  /glob "*" }
      /0023 { /type "allow" /glob "*/content*" }  # disable this rule to allow mapped content only
      /0041 { /type "allow" /glob "* *.css *"   }  # enable css
      /0042 { /type "allow" /glob "* *.gif *"   }  # enable gifs
      /0043 { /type "allow" /glob "* *.ico *"   }  # enable icos
      /0044 { /type "allow" /glob "* *.js *"    }  # enable javascript
      /0045 { /type "allow" /glob "* *.png *"   }  # enable png
      /0046 { /type "allow" /glob "* *.swf *"   }  # enable flash
      /0061 { /type "allow" /glob "POST /content/[.]*.form.html" }  # allow POSTs to form selectors under content
      /0062 { /type "allow" /glob "* /libs/cq/personalization/*"  }  # enable personalization
      /0081 { /type "deny"  /glob "GET *.infinity.json*" }
      /0082 { /type "deny"  /glob "GET *.tidy.json*"     }
      /0083 { /type "deny"  /glob "GET *.sysview.xml*"   }
      /0084 { /type "deny"  /glob "GET *.docview.json*"  }
      /0085 { /type "deny"  /glob "GET *.docview.xml*"  }
      /0086 { /type "deny"  /glob "GET *.*[0-9].json*" }
      /0090 { /type "deny"  /glob "* *.query.json*" }
      }
    /cache
      {
      /docroot "/usr/lib/apache/httpd-2.4.3/htdocs"
      /statfileslevel "2"
      /allowAuthorized "0"
      /rules
        {
        /0000  { /glob "*"     /type "allow"  }
        }
      /invalidate
        {
        /0000  {   /glob "*" /type "deny"  }
        /0001 {  /glob "*.html" /type "allow"  }
        }
      /allowedClients
        {
        }
      }
    /statistics
      {
      /categories
        {
        /html  { /glob "*.html" }
        /others  {  /glob "*"  }
        }
      }
    }
  }

비 HTML 파일에 대한 링크 재작성 rewriting-links-to-non-html-files

확장자가 .html 또는 .htm이 아닌 파일에 대한 참조를 재작성하려면 Sling 재작성기 변환기 구성 요소를 생성하고 기본 재작성기 파이프라인에 추가합니다.

리소스 경로가 웹 서버 컨텍스트에서 올바르게 확인되지 않는 경우 참조를 재작성합니다. 예를 들어 이미지 생성 구성 요소가 /content/sitea/en/products.navimage.png와 같은 링크를 만들 때 변환기가 필요합니다. 완벽한 기능을 갖춘 인터넷 웹 사이트를 만드는 방법의 topnav 구성 요소는 이러한 링크를 만듭니다.

Sling 재작성기는 Sling 출력을 후처리하는 모듈입니다. 재작성기의 SAX 파이프라인 구현은 생성기, 하나 이상의 변환기 및 직렬 변환기로 구성됩니다.

AEM 기본 Rewriter 파이프라인 the-aem-default-rewriter-pipeline

AEM은 text/html 유형의 문서를 처리하는 기본 파이프라인 재작성기를 사용합니다.

/libs/cq/config/rewriter/default 노드는 파이프라인을 정의합니다.

변환기 생성 creating-a-transformer

변환기 구성 요소를 생성하고 파이프라인에서 사용하려면 다음 작업을 수행합니다.

다음 예제에서는 이미지 파일에 대한 참조를 재작성하는 변환기를 구현합니다.

예제는 강력하지 않습니다. 프로덕션 환경에서 사용하면 안 됩니다.

예제 TransformerFactory 구현 example-transformerfactory-implementation

package com.adobe.example;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Service;
import org.apache.felix.scr.annotations.Property;

import org.apache.sling.rewriter.Transformer;
import org.apache.sling.rewriter.TransformerFactory;

@Component
@Service
public class MyRewriterTransformerFactory implements TransformerFactory {
    /* Define the alias */
    @Property(value="mytransformer")
    static final String PIPELINE_TYPE ="pipeline.type";

    public Transformer createTransformer() {

        return new MyRewriterTransformer ();
    }
}

예제 변환기 구현 example-transformer-implementation

package com.adobe.example;

import java.io.IOException;

import org.apache.cocoon.xml.sax.AbstractSAXPipe;

import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.rewriter.ProcessingComponentConfiguration;
import org.apache.sling.rewriter.ProcessingContext;
import org.apache.sling.rewriter.Transformer;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import org.xml.sax.Attributes;
import org.xml.sax.SAXException;
import org.xml.sax.helpers.AttributesImpl;

import javax.servlet.http.HttpServletRequest;

public class MyRewriterTransformer extends AbstractSAXPipe implements Transformer {

 private static final Logger log = LoggerFactory.getLogger(MyRewriterTransformer.class);
 private SlingHttpServletRequest httpRequest;
 /* The element and attribute to act on  */
 private static final String ATT_NAME = new String("src");
 private static final String EL_NAME = new String("img");

 public MyRewriterTransformer () {
 }
 public void dispose() {
 }
 public void init(ProcessingContext context, ProcessingComponentConfiguration config) throws IOException {
  this.httpRequest = context.getRequest();
  log.debug("Transforming request {}.", httpRequest.getRequestURI());
 }
 @Override
 public void startElement (String nsUri, String localname, String qname, Attributes atts) throws SAXException {
  /* copy the element attributes */
  AttributesImpl linkAtts = new AttributesImpl(atts);
  /* Only interested in EL_NAME elements */
  if(EL_NAME.equalsIgnoreCase(localname)){

   /* iterate through the attributes of the element and act only on ATT_NAME attributes */
   for (int i=0; i < linkAtts.getLength(); i++) {
    if (ATT_NAME.equalsIgnoreCase(linkAtts.getLocalName(i))) {
     String path_in_link = linkAtts.getValue(i);

     /* use the resource resolver of the http request to reverse-resolve the path  */
     String mappedPath = httpRequest.getResourceResolver().map(httpRequest, path_in_link);

     log.info("Tranformed {} to {}.", path_in_link,mappedPath);

     /* update the attribute value */
     linkAtts.setValue(i,mappedPath);
    }
   }

  }
        /* return updated attributes to super and continue with the transformer chain */
 super.startElement(nsUri, localname, qname, linkAtts);
 }
}

재작성기 파이프라인에 변환기 추가 adding-the-transformer-to-a-rewriter-pipeline

변환기를 사용하는 파이프라인을 정의하는 JCR 노드를 만듭니다. 다음 노드 정의는 텍스트/html 파일을 처리하는 파이프라인을 생성합니다. HTML용 기본 AEM 생성기 및 파서가 사용됩니다.

재작성기 구성 노드 - XML 표현 rewriter-configuration-node-xml-representation

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="https://www.jcp.org/jcr/1.0" xmlns:nt="https://www.jcp.org/jcr/nt/1.0"
    jcr:primaryType="nt:unstructured"
    contentTypes="[text/html]"
    enabled="{Boolean}true"
    generatorType="htmlparser"
    order="5"
    serializerType="htmlwriter"
    transformerTypes="[mytransformer]">
</jcr:root>

다음 그래픽은 노드의 CRXDE Lite 표현을 보여 줍니다.