설명서AEMAEM 6.x용 Cloud Manager 설명서

Dispatcher 구성 manage-your-dispatcher-configurations

Last update: Fri Sep 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자

Cloud Manager를 사용하여 Dispatcher 구성 파일을 배포하는 방법에 대해 알아봅니다.

Cloud Manager를 사용하여 Dispatcher 구성 배포 deploying-dispatcher-configurations

Cloud Manager는 웹 서버 및 Dispatcher 구성 파일이 일반 AEM 콘텐츠 패키지와 함께 Git 저장소에 저장된다고 가정하여 배포할 수 있습니다.

이 기능을 활용하려면 Maven 빌드는 conf 및 conf.d의 두 개 이상의 디렉터리가 포함된 .zip 파일을 생성해야 합니다. 이 .zip 파일을 maven-assembly-plugin을 사용하여 생성할 수 있습니다.

Cloud Manager가 내장된 프로젝트 생성 마법사를 사용하여 생성한 프로젝트는 자동으로 올바른 Maven 프로젝트 구조가 생성됩니다. Adobe Managed Services(AMS)를 처음 사용하는 경우 권장되는 경로입니다.

Dispatcher 인스턴스에 배포하면 인스턴스의 디렉터리가 Git 저장소의 디렉터리로 바뀝니다. 웹 서버 및 Dispatcher 구성 파일에는 환경별 세부 정보가 필요한 경우가 많기 때문에 이 기능을 올바르게 사용하기 전에 CSE(고객 성공 엔지니어)와 협력하여 /etc/sysconfig/httpd에서 적절한 환경 변수를 설정해야 합니다.

기존 관리 서비스 고객에 대한 Dispatcher 구성 steps-for-configuring-dispatcher

다음 단계에 따라 초기 Dispatcher 구성을 완료합니다.

  1. CSE에서 현재 프로덕션 구성 파일을 가져옵니다.
  2. 게시 렌더러 IP와 같은 하드 코딩된 환경 관련 데이터를 제거하고 변수로 대체합니다.
  3. 각 대상 Dispatcher의 키-값 쌍에 필요한 변수를 정의하고 CSE에 각 인스턴스의 /etc/sysconfig/httpd에 추가하도록 요청합니다.
  4. 스테이징 환경에서 업데이트된 구성을 테스트합니다.
  5. 테스트가 완료되면 CSE에 프로덕션에 배포하도록 요청합니다.
  6. Git 저장소에 파일을 커밋합니다.
  7. Cloud Manager를 통해 배포합니다.
NOTE
Dispatcher 및 웹 서버 구성을 Git 저장소로 마이그레이션하는 작업은 Cloud Manager 온보딩 작업 중에 수행할 수 있지만 나중에 수행할 수도 있습니다.

예 example

특정 파일 및 디렉터리 구조는 프로젝트의 세부 사항에 따라 달라질 수 있지만 이 예제는 Apache 및 Dispatcher 구성을 포함하도록 프로젝트를 구조화하는 방법에 대한 구체적인 지침을 제공해야 합니다.

  1. dispatcher라는 하위 디렉터리를 만듭니다.

    여기서 임의의 이름을 사용할 수 있지만 이 단계에서 작성된 디렉터리 이름은 6단계에서 사용한 이름과 같아야 합니다.

  2. 이 하위 디렉터리에는 Maven 어셈블리 플러그인을 사용하여 Dispatcher.zip 파일을 작성하는 Maven 모듈이 포함됩니다. dispatcher 디렉터리에서 이 내용이 포함된 pom.xml 파일을 만들고 필요에 따라 parent 참조 artifactId 및 name를 변경합니다.

    code language-xml 
    <?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <!-- reference to your parent pom -->
    </parent>

    <artifactId>dispatcher</artifactId> <!-- feel free to change this -->
    <packaging>pom</packaging>
    <name>dispatcher</name> <!-- feel free to change this -->

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <version>3.1.0</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals><goal>single</goal></goals>
                        <configuration>
                            <descriptors>
                                <descriptor>assembly.xml</descriptor>
                            </descriptors>
                            <appendAssemblyId>false</appendAssemblyId>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>
    • 1단계에서와 같이 artifactId와 name은 원하는 경우 다른 값이 될 수 있습니다. dispatcher는 여기서 단지 예시일 뿐입니다.

  3. Maven 어셈블리 플러그인은 .zip 파일이 생성되는 방법을 정의하기 위해 descriptor가 필요합니다. 이 설명자를 만들려면 dispatcher 하위 디렉터리에 다음 내용이 포함된 assembly.xml이라는 이름의 파일을 만듭니다. 이 파일 이름은 위의 pom.xml 파일의 26행에 있습니다.

    code language-xml 
    <assembly xmlns="http://maven.apache.org/ASSEMBLY/2.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/ASSEMBLY/2.0.0 http://maven.apache.org/xsd/assembly-2.0.0.xsd">
  <id>distribution</id>
  <formats>
    <format>zip</format>
  </formats>
  <includeBaseDirectory>false</includeBaseDirectory>
  <fileSets>
    <fileSet>
      <directory>${basedir}/src</directory>
      <includes>
        <include>**/*</include>
      </includes>
      <outputDirectory></outputDirectory>
    </fileSet>
  </fileSets>
</assembly>

  4. Dispatcher 하위 디렉터리 내부에 src라는 하위 디렉터리(위 11행의 어셈블리 설명자에서 참조)를 생성하여 실제 Apache 및 Dispatcher 구성을 저장합니다. 이 src 디렉터리 내에서 conf, conf.d, conf.dispatcher.d 및 conf.modules.d라는 디렉터리를 만듭니다.

  5. conf, conf.d, conf.dispatcher.d 및 conf.modules.d 디렉터리를 구성 파일로 채웁니다. 예를 들어 기본 구성은 이러한 파일과 심볼 링크로 구성됩니다.

    code language-none 
    dispatcher
├── assembly.xml
├── pom.xml
└── src
    ├── conf
    │  ├── httpd.conf
    │  └── magic
    ├── conf.d
    │  ├── README
    │  ├── autoindex.conf
    │  ├── available_vhosts
    │  │  ├── aem_author.vhost
    │  │  ├── aem_flush.vhost
    │  │  ├── aem_health.vhost
    │  │  ├── aem_lc.vhost
    │  │  └── aem_publish.vhost
    │  ├── dispatcher_vhost.conf
    │  ├── enabled_vhosts
    │  │  ├── aem_author.vhost -> ../available_vhosts/aem_author.vhost
    │  │  ├── aem_flush.vhost -> ../available_vhosts/aem_flush.vhost
    │  │  └── aem_publish.vhost -> ../available_vhosts/aem_publish.vhost
    │  ├── rewrites
    │  │  ├── base_rewrite.rules
    │  │  └── xforwarded_forcessl_rewrite.rules
    │  ├── userdir.conf
    │  ├── variables
    │  │  └── ams_default.vars
    │  ├── welcome.conf
    │  └── whitelists
    │      └── 000_base_whitelist.rules
    ├── conf.dispatcher.d
    │  ├── available_farms
    │  │  ├── 000_ams_author_farm.any
    │  │  ├── 001_ams_lc_farm.any
    │  │  └── 999_ams_publish_farm.any
    │  ├── cache
    │  │  ├── ams_author_cache.any
    │  │  ├── ams_author_invalidate_allowed.any
    │  │  ├── ams_publish_cache.any
    │  │  └── ams_publish_invalidate_allowed.any
    │  ├── clientheaders
    │  │  ├── ams_author_clientheaders.any
    │  │  ├── ams_common_clientheaders.any
    │  │  ├── ams_lc_clientheaders.any
    │  │  └── ams_publish_clientheaders.any
    │  ├── dispatcher.any
    │  ├── enabled_farms
    │  │  ├── 000_ams_author_farm.any -> ../available_farms/000_ams_author_farm.any
    │  │  └── 999_ams_publish_farm.any -> ../available_farms/999_ams_publish_farm.any
    │  ├── filters
    │  │  ├── ams_author_filters.any
    │  │  ├── ams_lc_filters.any
    │  │  └── ams_publish_filters.any
    │  ├── renders
    │  │  ├── ams_author_renders.any
    │  │  ├── ams_lc_renders.any
    │  │  └── ams_publish_renders.any
    │  └── vhosts
    │      ├── ams_author_vhosts.any
    │      ├── ams_lc_vhosts.any
    │      └── ams_publish_vhosts.any
    └── conf.modules.d
        ├── 00-base.conf
        ├── 00-dav.conf
        ├── 00-lua.conf
        ├── 00-mpm.conf
        ├── 00-proxy.conf
        ├── 00-systemd.conf
        ├── 01-cgi.conf
        └── 02-dispatcher.conf

  6. 마지막으로 프로젝트의 루트에 있는 pom.xml 파일에 <module> 요소를 추가하여 Dispatcher 모듈을 포함합니다.

    예를 들어 기존 모듈 목록은 다음과 같습니다.

    code language-xml 
        <modules>
        <module>core</module>
        <module>ui.apps</module>
        <module>ui.content</module>
    </modules>

    다음으로 변경합니다.

    code language-xml 
        <modules>
        <module>core</module>
        <module>ui.apps</module>
        <module>ui.content</module>
        <module>dispatcher</module>
    </modules>
    • 1단계에서 설명한 대로 <module> 요소의 값은 생성된 디렉터리 이름과 일치해야 합니다.

  7. 테스트하려면 프로젝트 루트 디렉터리에서 mvn clean package를 실행합니다. 출력에 다음과 같은 선이 표시됩니다.

    code language-none 
    [INFO] --- maven-assembly-plugin:3.1.0:single (default) @ dispatcher ---
[INFO] Reading assembly descriptor: assembly.xml
[INFO] Building zip: /Users/me/mycompany/dispatcher/target/dispatcher-1.0-SNAPSHOT.zip

    이 파일의 압축을 풀어서 내용을 볼 수도 있습니다.

    code language-shell 
    $ unzip -l dispatcher/target/dispatcher-1.0-SNAPSHOT.zip
Archive:  dispatcher/target/dispatcher-1.0-SNAPSHOT.zip
  Length      Date    Time    Name
---------  ---------- -----   ----
        0  09-12-2018 12:53   conf.modules.d/
        0  10-19-2018 10:38   conf.dispatcher.d/
        0  09-12-2018 12:53   conf.dispatcher.d/available_farms/
        0  09-12-2018 12:53   conf.dispatcher.d/filters/
        0  09-12-2018 12:53   conf.dispatcher.d/renders/
        0  09-12-2018 12:53   conf.dispatcher.d/cache/
        0  09-12-2018 12:53   conf.dispatcher.d/clientheaders/
        0  09-12-2018 12:53   conf.dispatcher.d/enabled_farms/
        0  09-12-2018 12:53   conf.dispatcher.d/vhosts/
        0  09-12-2018 12:53   conf.d/
        0  09-12-2018 12:53   conf.d/rewrites/
        0  09-12-2018 12:53   conf.d/whitelists/
        0  09-12-2018 12:53   conf.d/variables/
        0  11-01-2018 13:53   conf.d/enabled_vhosts/
        0  09-12-2018 12:53   conf.d/available_vhosts/
        0  09-12-2018 12:53   conf/
       88  09-12-2018 12:53   conf.modules.d/00-systemd.conf
     4913  09-12-2018 12:53   conf.dispatcher.d/available_farms/999_ams_publish_farm.any
      152  09-12-2018 12:53   conf.dispatcher.d/renders/ams_lc_renders.any
      490  09-12-2018 12:53   conf.dispatcher.d/clientheaders/ams_common_clientheaders.any
     1727  09-12-2018 12:53   conf.d/rewrites/base_rewrite.rules
       36  09-12-2018 12:53   conf.d/enabled_vhosts/aem_author.vhost
    11753  09-12-2018 12:53   conf/httpd.conf
      957  09-12-2018 12:53   conf.modules.d/00-proxy.conf
      944  09-12-2018 12:53   conf.dispatcher.d/available_farms/001_ams_lc_farm.any
      220  09-12-2018 12:53   conf.dispatcher.d/cache/ams_author_invalidate_allowed.any
       43  09-12-2018 12:53   conf.dispatcher.d/enabled_farms/999_ams_publish_farm.any
      516  09-12-2018 12:53   conf.d/welcome.conf
       37  09-12-2018 12:53   conf.d/enabled_vhosts/aem_publish.vhost
    13077  09-12-2018 12:53   conf/magic
       96  09-12-2018 12:53   conf.modules.d/02-dispatcher.conf
     2601  09-12-2018 12:53   conf.dispatcher.d/available_farms/000_ams_author_farm.any
      837  09-12-2018 12:53   conf.dispatcher.d/cache/ams_author_cache.any
       42  09-12-2018 12:53   conf.dispatcher.d/enabled_farms/000_ams_author_farm.any
     2926  09-12-2018 12:53   conf.d/autoindex.conf
     2555  09-12-2018 12:53   conf.d/available_vhosts/aem_lc.vhost
       41  09-12-2018 12:53   conf.modules.d/00-lua.conf
     2234  09-12-2018 12:53   conf.dispatcher.d/filters/ams_publish_filters.any
      220  09-12-2018 12:53   conf.dispatcher.d/cache/ams_publish_invalidate_allowed.any
      402  09-12-2018 12:53   conf.dispatcher.d/dispatcher.any
      573  09-12-2018 12:53   conf.d/whitelists/000_base_whitelist.rules
      871  09-12-2018 12:53   conf.d/available_vhosts/aem_flush.vhost
      139  09-12-2018 12:53   conf.modules.d/00-dav.conf
      742  09-12-2018 12:53   conf.dispatcher.d/filters/ams_author_filters.any
      557  09-12-2018 12:53   conf.dispatcher.d/cache/ams_publish_cache.any
      105  09-12-2018 12:53   conf.dispatcher.d/vhosts/ams_lc_vhosts.any
      101  09-12-2018 12:53   conf.dispatcher.d/vhosts/ams_publish_vhosts.any
     3582  09-12-2018 12:53   conf.d/dispatcher_vhost.conf
     2529  09-12-2018 12:53   conf.d/available_vhosts/aem_publish.vhost
      742  09-12-2018 12:53   conf.modules.d/00-mpm.conf
       88  09-12-2018 12:53   conf.dispatcher.d/filters/ams_lc_filters.any
      177  09-12-2018 12:53   conf.dispatcher.d/clientheaders/ams_lc_clientheaders.any
      366  09-12-2018 12:53   conf.d/README
     2723  09-12-2018 12:53   conf.d/available_vhosts/aem_author.vhost
     3739  09-12-2018 12:53   conf.modules.d/00-base.conf
      138  09-12-2018 12:53   conf.dispatcher.d/renders/ams_author_renders.any
       44  09-12-2018 12:53   conf.dispatcher.d/clientheaders/ams_publish_clientheaders.any
      112  09-12-2018 12:53   conf.dispatcher.d/vhosts/ams_author_vhosts.any
      580  09-12-2018 12:53   conf.d/variables/ams_default.vars
       35  09-12-2018 12:53   conf.d/enabled_vhosts/aem_flush.vhost
     1252  09-12-2018 12:53   conf.d/userdir.conf
      451  09-12-2018 12:53   conf.modules.d/01-cgi.conf
      321  09-12-2018 12:53   conf.dispatcher.d/renders/ams_publish_renders.any
      170  09-12-2018 12:53   conf.dispatcher.d/clientheaders/ams_author_clientheaders.any
      220  09-12-2018 12:53   conf.d/rewrites/xforwarded_forcessl_rewrite.rules
     1753  09-12-2018 12:53   conf.d/available_vhosts/aem_health.vhost
---------                     -------
    69017                     66 files
recommendation-more-help
c6cdc82b-cee9-48e0-a6ee-48149d5e72c3