AEM에서 읽기 전용 또는 변경할 수 없는 파일

Last update: Thu Mar 28 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

설명 description

환경

Experience Manager

문제/증상

이 문서에서는 잠기고 변경할 수 없는 파일과 원하는 구성 설정을 올바르게 지정하는 방법을 설명합니다.

Adobe Managed Services(AMS)가 시스템을 프로비저닝하면 모든 것이 기능적이고 안전하도록 하는 기본 구성을 롤아웃합니다. AMS는 기능 및 보안의 기준선으로 유지되도록 하고자 합니다. 이를 위해 일부 파일은 읽기 전용으로 표시되어 변경할 수 없습니다.

레이아웃은 사용자의 동작을 변경하고 필요한 변경 사항을 재정의하는 것을 막지 않습니다. 이러한 파일을 변경하는 대신 원본을 대체하는 고유한 파일을 오버레이합니다.

또한 AMS가 최신 수정 사항 및 보안 개선 사항으로 디스패처를 패치할 때 파일이 변경되지 않는다는 확신을 가질 수 있습니다. 그러면 계속해서 개선 사항의 이점을 누리고 원하는 변경 사항만 채택할 수 있습니다.
레인을 따라 공이 굴러가는 볼링 레인을 보여줍니다. 공에는 'you'라는 단어가 적힌 화살표가 있습니다. 거터 범퍼가 올라가 있고 그 위에 'immutable files'라는 단어가 있습니다.
위의 그림에서 보듯이, 변경 불가능한 파일은 게임을 하는 것을 막지 않습니다. 성능 저하를 방지하고 계속 진행합니다. 이 방법을 사용하면 다음과 같은 몇 가지 주요 기능을 사용할 수 있습니다.

사용자 지정은 고유한 안전 공간에서 처리됩니다
사용자 지정 변경 사항의 오버레이는 AEM의 오버레이 메서드의 것을 미러링합니다.
사용자 지정을 변경하지 않고 AMS 구성을 패치할 수 있습니다
기본 설치와 사용자 지정 구성을 동시에 테스트하면 문제가 사용자 지정으로 인해 발생하는지 아니면 다른 원인으로 인해 발생하는지 식별하는 데 도움이 됩니다.

다음은 Dispatcher와 함께 배포된 파일의 일반적인 목록입니다.

/etc/httpd/
├── conf
│   └── httpd.conf
├── conf.d
│   ├── available_vhosts
│   │   ├── 000_unhealthy_author.vhost
│   │   ├── 000_unhealthy_publish.vhost
│   │   ├── aem_author.vhost
│   │   ├── aem_flush.vhost
│   │   ├── aem_health.vhost
│   │   ├── aem_lc.vhost
│   │   └── aem_publish.vhost
│   ├── dispatcher_vhost.conf
│   ├── enabled_vhosts
│   │   ├── aem_author.vhost -> /etc/httpd/conf.d/available_vhosts/aem_author.vhost
│   │   ├── aem_flush.vhost -> /etc/httpd/conf.d/available_vhosts/aem_flush.vhost
│   │   ├── aem_health.vhost -> /etc/httpd/conf.d/available_vhosts/aem_health.vhost
│   │   └── aem_publish.vhost -> /etc/httpd/conf.d/available_vhosts/aem_publish.vhost
│   ├── logformat.conf
│   ├── remoteip.conf
│   ├── rewrites
│   │   ├── base_rewrite.rules
│   │   └── xforwarded_forcessl_rewrite.rules
│   ├── security.conf
│   ├── variables
│   │   └── ams_default.vars
│   └── 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 -> /etc/httpd/conf.dispatcher.d/available_farms/000_ams_author_farm.any

│   │   └── 999_ams_publish_farm.any -> /etc/httpd/conf.dispatcher.d/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
│   ├── 01-cgi.conf
│   └── 02-dispatcher.conf
└── modules -> ../../usr/lib64/httpd/modules
    └── mod_dispatcher.so

변경할 수 없는 파일을 확인하려면 Dispatcher에서 다음 명령을 실행하여 확인할 수 있습니다.

$ lsattr -Rl /etc/httpd 2 > /dev/null | grep Immutable

다음은 변경할 수 없는 파일의 샘플 응답입니다.

/etc/httpd/conf/httpd.conf   Immutable
/etc/httpd/conf.d/available_vhosts/aem_author.vhost Immutable
/etc/httpd/conf.d/available_vhosts/aem_publish.vhost Immutable
/etc/httpd/conf.d/available_vhosts/aem_lc.vhost Immutable
/etc/httpd/conf.d/available_vhosts/aem_flush.vhost Immutable
/etc/httpd/conf.d/available_vhosts/aem_health.vhost Immutable
/etc/httpd/conf.d/available_vhosts/000_unhealthy_author.vhost Immutable
/etc/httpd/conf.d/available_vhosts/000_unhealthy_publish.vhost Immutable
/etc/httpd/conf.d/rewrites/base_rewrite.rules Immutable
/etc/httpd/conf.d/rewrites/xforwarded_forcessl_rewrite.rules Immutable
/etc/httpd/conf.d/whitelists/000_base_whitelist.rules Immutable
/etc/httpd/conf.d/dispatcher_vhost.conf Immutable
/etc/httpd/conf.d/logformat.conf Immutable
/etc/httpd/conf.d/security.conf Immutable
/etc/httpd/conf.modules.d/02-dispatcher.conf Immutable
/etc/httpd/conf.dispatcher.d/available_farms/000_ams_author_farm.any Immutable
/etc/httpd/conf.dispatcher.d/available_farms/999_ams_publish_farm.any Immutable
/etc/httpd/conf.dispatcher.d/available_farms/001_ams_lc_farm.any Immutable
/etc/httpd/conf.dispatcher.d/cache/ams_author_cache.any Immutable
/etc/httpd/conf.dispatcher.d/cache/ams_author_invalidate_allowed.any Immutable
/etc/httpd/conf.dispatcher.d/cache/ams_publish_cache.any Immutable
/etc/httpd/conf.dispatcher.d/cache/ams_publish_invalidate_allowed.any Immutable
/etc/httpd/conf.dispatcher.d/clientheaders/ams_author_clientheaders.any Immutable
/etc/httpd/conf.dispatcher.d/clientheaders/ams_publish_clientheaders.any Immutable
/etc/httpd/conf.dispatcher.d/clientheaders/ams_common_clientheaders.any Immutable
/etc/httpd/conf.dispatcher.d/clientheaders/ams_lc_clientheaders.any Immutable
/etc/httpd/conf.dispatcher.d/filters/ams_author_filters.any Immutable
/etc/httpd/conf.dispatcher.d/filters/ams_publish_filters.any Immutable
/etc/httpd/conf.dispatcher.d/filters/ams_lc_filters.any Immutable
/etc/httpd/conf.dispatcher.d/renders/ams_author_renders.any Immutable
/etc/httpd/conf.dispatcher.d/renders/ams_publish_renders.any Immutable
/etc/httpd/conf.dispatcher.d/renders/ams_lc_renders.any Immutable
/etc/httpd/conf.dispatcher.d/vhosts/ams_author_vhosts.any Immutable
/etc/httpd/conf.dispatcher.d/vhosts/ams_publish_vhosts.any Immutable
/etc/httpd/conf.dispatcher.d/vhosts/ams_lc_vhosts.any Immutable
/etc/httpd/conf.dispatcher.d/dispatcher.any Immutable

해결 방법 resolution

변경 방법

변수

변수를 사용하면 구성 파일 자체를 변경하지 않고도 기능을 변경할 수 있습니다. 변수의 값을 조정하여 구성의 특정 요소를 조정할 수 있습니다. /etc/httpd/conf.d/dispatcher_vhost.conf 파일에서 강조할 수 있는 한 가지 예가 다음과 같습니다.

Include /etc/httpd/conf.d/variables/ams_default.vars
`<` IfModule disp_apache2.c`>`
    DispatcherConfig conf.dispatcher.d/dispatcher.any
    DispatcherLog    logs/dispatcher.log
    DispatcherLogLevel ${DISP_LOG_LEVEL}
    DispatcherDeclineRoot 0
    DispatcherUseProcessedURL 1
`<` /IfModule`>`

DispatcherLogLevel 지시문에 일반적인 값 대신 DISP_LOG_LEVEL 변수를 넣는 방법을 확인하십시오. 코드의 해당 섹션 위에는 변수 파일에 include 문도 표시됩니다. 변수 파일 /etc/httpd/conf.d/variables/ams_default.vars 은 다음에 살펴보고 싶은 곳입니다. 다음은 해당 변수 파일의 내용입니다.

Define DISP_LOG_LEVEL info
Define AUTHOR_WHITELIST_ENABLED 0
Define PUBLISH_WHITELIST_ENABLED 0
Define LIVECYCLE_WHITELIST_ENABLED 0
Define AUTHOR_FORCE_SSL 1
Define PUBLISH_FORCE_SSL 0
Define LIVECYCLE_FORCE_SSL 1

위에서 DISP_LOG_LEVEL 변수의 현재 값이 'info'임을 알 수 있습니다. 이것을 추적하거나 디버그하거나 선택한 숫자 값/레벨로 조정할 수 있습니다. 이제 로그 수준을 제어하는 모든 곳이 자동으로 조정됩니다.

오버레이 메서드

최상위 include 파일 이 모든 사용자 정의 작업의 시작이기 때문에 숙지하십시오. 간단한 예제로 시작하기 위해 이 Dispatcher를 가리키려는 새 도메인 이름을 추가하는 시나리오가 있습니다. is we-retail.adobe.com 을 사용하는 도메인 예입니다. 먼저 변경 사항을 추가할 수 있는 새 구성 파일에 기존 구성 파일을 복사하는 것부터 시작하겠습니다.

$ cp /etc/httpd/conf.d/available_vhosts/aem_publish.vhost /etc/httpd/conf.d/available_vhosts/weretail_publish.vhost

기존의 aem_publish.vhost 파일을 복사했습니다. 이미 작업을 수행하는 데 필요한 것이 있고, 이미 멋지게 시작을 했는데 다시 시작하고 싶지 않기 때문입니다. 이제 새로운 weretail.vhost 파일을 편집하고 필요한 사항을 변경합니다.

전:

`<` VirtualHost *:80`>`
    ServerName    publish
    ServerAlias    ${PUBLISH_DEFAULT_HOSTNAME}
    DocumentRoot    ${PUBLISH_DOCROOT}
    `<` IfModule mod_headers.c`>`
            Header always add X-Dispatcher ${DISP_ID}
            Header always add X-Vhost "publish"
            Header merge X-Frame-Options SAMEORIGIN "expr=%{resp:X-Frame-Options}!='SAMEORIGIN'"
            Header merge X-Content-Type-Options nosniff "expr=%{resp:X-Content-Type-Options}!='nosniff'"
        Header append Vary User-Agent env=!dont-vary
    `<` /IfModule`>`
....... SNIP.......
`<` /VirtualHost`>`

이후:

`<` VirtualHost *:80`>`
    ServerName    weretail-publish
    ServerAlias    we-retail.adobe.com
    DocumentRoot    ${PUBLISH_DOCROOT}
    `<` IfModule mod_headers.c`>`
            Header always add X-Dispatcher ${DISP_ID}
            Header always add X-Vhost "werteail-publish"
            Header merge X-Frame-Options SAMEORIGIN "expr=%{resp:X-Frame-Options}!='SAMEORIGIN'"
            Header merge X-Content-Type-Options nosniff "expr=%{resp:X-Content-Type-Options}!='nosniff'"
        Header append Vary User-Agent env=!dont-vary
    `<` /IfModule`>`
....... SNIP.......
`<` /VirtualHost`>`

새 도메인 이름과 일치하도록 ServerName 및 ServerAlias를 업데이트하고 다른 이동 경로 헤더를 업데이트했습니다. 이제 Apache가 새 파일을 사용할 수 있도록 새 파일을 활성화해 보겠습니다.

$ cd /etc/httpd/conf.d/enabled_vhosts/; ln -s ../available_vhosts/weretail_publish.vhost .

이제 Apache 웹 서버는 도메인이 트래픽을 발생시켜야 한다는 것을 알고 있지만 여전히 Dispatcher 모듈에 적용할 새 도메인 이름이 있음을 알려야 합니다. 새 *_vhost.any 파일 /etc/httpd/conf.dispatcher.d/vhosts/weretail_vhosts.any 을 생성하고, 이 파일 안에 적용할 도메인 이름을 넣겠습니다.

"we-retail.adobe.com"

이제 새 가상 호스트 항목 파일을 사용할 새 팜 파일을 만들어야 하며 먼저 강력한 시작 파일을 새 파일에 복사합니다.

$ cp /etc/httpd/conf.dispatcher.d/available_farms/999_ams_publish_farm.any /etc/httpd/conf.dispatcher.d/available_farms/400_weretail_publish_farm.any

이 팜 파일에 적용해야 하는 변경 사항을 표시해 보겠습니다.

전:

/publishfarm {
    /virtualhosts {
        $include "/etc/httpd/conf.dispatcher.d/vhosts/ams_publish_vhosts.any"
    }
........SNIP.........
}

이후:

/weretailpublishfarm {
    /virtualhosts {
        $include "/etc/httpd/conf.dispatcher.d/vhosts/weretail_publish_vhosts.any"
    }
........SNIP.........
}

팜 이름과 팜 구성의 /virtualhosts 섹션에서 사용하는 include를 업데이트했습니다. 실행 중인 구성에서 사용할 수 있도록 이 새 팜 파일을 활성화해야 합니다.

$ cd /etc/httpd/conf.dispatcher.d/enabled_farms/; ln -s ../available_farms/400_weretail_publish_farm.any .

이제 웹 서버 서비스를 다시 로드하고 새 도메인을 사용합니다!

참고:

기본 구성 파일과 함께 제공되는 기존 포함 및 코드를 활용하고 변경하는 데 필요한 부분만 변경했습니다. 변경해야 하는 요소만 기술하면 됩니다. 작업을 훨씬 쉽게 만들고 더 적은 코드를 유지 관리할 수 있습니다.

recommendation-more-help

3d58f420-19b5-47a0-a122-5c9dab55ec7f