Dispatcher 구성 manage-your-dispatcher-configurations

마지막 업데이트: 2026년 7월 14일

주제:
Cloud Manager

작성 대상:

{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

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

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

웹 서버 및 Dispatcher 구성 파일이 표준 AEM 컨텐츠 패키지와 함께 Git 저장소에 저장된 경우 Cloud Manager에서 배포할 수 있습니다.

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

Cloud Manager가 기본 제공 프로젝트 생성 마법사를 사용하여 생성한 프로젝트는 자동으로 올바른 Maven 프로젝트 구조가 생성됩니다. Adobe Managed Services(AMS)를 처음 사용하는 경우에는 이 방법을 사용하는 것이 좋습니다.

Dispatcher 인스턴스에 배포하면 인스턴스의 디렉터리가 Git 저장소의 디렉터리로 바뀝니다. 웹 서버 및 Dispatcher 구성 파일에 종종 환경별 세부 정보가 필요하므로 /etc/sysconfig/httpd에서 적절한 환경 변수를 올바르게 설정하려면 고객 지원 팀과 공동 작업하십시오.

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

초기 Dispatcher 구성을 완료하려면 다음을 수행하십시오.

고객 지원 팀에서 현재 프로덕션 구성 파일을 가져옵니다.
게시 렌더러 IP와 같은 환경 관련 데이터를 제거하고 변수로 바꿉니다.
각 대상 Dispatcher의 키-값 쌍에 필요한 변수를 정의하고 각 인스턴스의 variables 폴더에 추가하십시오.
스테이징 환경에서 업데이트된 구성을 테스트합니다.
테스트가 완료되면 고객 지원 팀에 프로덕션에 배포하도록 요청합니다.
Git 저장소에 파일을 커밋합니다.
Cloud Manager를 통해 배포합니다.

NOTE

Dispatcher 및 웹 서버 구성을 Git 저장소로 마이그레이션하는 작업은 Cloud Manager 온보딩 중에 수행되지만 나중에 수행할 수도 있습니다.

예 example

특정 파일 및 디렉터리 구조는 프로젝트의 세부 사항에 따라 다르지만, 이 예에서는 Apache 및 Dispatcher 구성을 포함하도록 프로젝트를 구성하는 방법에 대한 명확한 설명을 제공합니다.

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

여기에서 임의의 이름을 사용하되, 이 단계에서 작성된 디렉터리 이름은 1단계에서 사용한 이름과 같아야 합니다.

이 하위 디렉터리에는 maven-assembly-plugin을(를) 사용하여 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이(가) 여기에 예로 사용되었습니다.

maven-assembly-plugin에서 .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>

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

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

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

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

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> 요소의 값은 생성된 디렉터리 이름과 일치해야 합니다.

테스트하려면 프로젝트 루트 디렉터리에서 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

experience-manager-cloud-manager-help-main-toc