변수 사용 및 이해

목차

<- 이전: 캐시 이해

이 문서에서는 Apache 웹 서버 및 Dispatcher 모듈 구성 파일에서 변수의 기능을 활용할 수 있는 방법을 설명합니다.

변수

Apache는 변수를 지원하며 Dispatcher 모듈 버전 4.1.9부터 변수도 지원합니다!

이를 활용하여 다음과 같은 유용한 작업을 수행할 수 있습니다.

기준선 변수 사용

AMS 기준 파일은 읽기 전용이며 변경할 수 없기 때문에 설정/해제하거나 사용하는 변수를 편집하여 구성할 수 있는 기능이 있습니다.

기준선 변수

AMS 기본 변수가 /etc/httpd/conf.d/variables/ootb.vars 파일에 선언되어 있습니다. 이 파일은 편집할 수 없지만 변수에 null 값이 없는지 확인하기 위해 존재합니다. /etc/httpd/conf.d/variables/ams_default.vars을(를) 포함하는 것보다 먼저 포함된 다음 그 이후에 포함됩니다. 이 파일을 편집하여 이러한 변수의 값을 변경하거나 파일에 동일한 변수 이름과 값을 포함할 수 있습니다.

다음은 /etc/httpd/conf.d/variables/ams_default.vars 파일의 내용 샘플입니다.

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

예제 1 - SSL 강제

AUHOR_FORCE_SSL 또는 PUBLISH_FORCE_SSL 위에 표시된 변수는 http 요청에 들어올 때 최종 사용자가 https로 리디렉션되도록 하는 재작성 규칙을 사용하도록 1로 설정할 수 있습니다

다음은 이 토글을 사용할 수 있는 구성 파일 구문입니다.

</VirtualHost *:80>
 <IfModule mod_rewrite.c>
  ReWriteEngine on
  <If "${PUBLISH_FORCE_SSL} == 1">
   Include /etc/httpd/conf.d/rewrites/forcessl_rewrite.rules
  </If>
 </IfModule>
</VirtualHost>

다음과 같은 재작성 규칙에 포함된 는 최종 사용자 브라우저를 리디렉션하는 코드가 있지만 1로 설정되는 변수는 파일 사용 여부를 나타냅니다

예제 2 - 로깅 수준

변수 DISP_LOG_LEVEL을(를) 사용하여 실행 중인 구성에서 실제로 사용되는 로그 수준에 사용할 항목을 설정할 수 있습니다.

다음은 ams 기본 구성 파일에 있는 구문 예입니다.

<IfModule disp_apache2.c>
 DispatcherLog    logs/dispatcher.log
 DispatcherLogLevel ${DISP_LOG_LEVEL}
</IfModule>

Dispatcher 로깅 수준을 높여야 하는 경우 ams_default.vars 변수 DISP_LOG_LEVEL을(를) 원하는 수준으로 업데이트하십시오.

예제 값은 정수 또는 단어일 수 있습니다.

예제 3 - 허용 목록

IP 주소를 기반으로 최종 사용자 트래픽을 허용하거나 허용하지 않는 규칙을 포함하는 재작성 규칙에 참여하도록 변수 AUTHOR_WHITELIST_ENABLED 및 PUBLISH_WHITELIST_ENABLED을(를) 1로 설정할 수 있습니다.  에서 이 기능을 전환하려면 화이트리스트 규칙 파일 생성과 함께 이 기능을 포함해야 합니다.

다음은 변수가 화이트리스트 파일 및 화이트리스트 파일 예제의 포함을 활성화하는 방법에 대한 몇 가지 구문 예입니다

sample.vhost:

<VirtualHost *:80>
 <Directory />
  <If "${AUTHOR_WHITELIST_ENABLED} == 1">
   Include /etc/httpd/conf.d/whitelists/*_whitelist.rules
  </If>
 </Directory>
</VirtualHost>

sample_whitelist.rules:

<RequireAny>
  Require ip 10.43.0.10/24
</RequireAny>

볼 수 있듯이 sample_whitelist.rules은(는) IP 제한을 적용하지만 변수를 토글하면 sample.vhost에 포함할 수 있습니다.

변수를 배치할 위치

웹 서버 시작 인수

AMS는 /etc/sysconfig/httpd 파일 내에 있는 Apache 프로세스의 시작 인수에 서버/토폴로지 특정 변수를 넣습니다.

이 파일에는 다음과 같이 미리 정의된 변수가 있습니다.

AUTHOR_IP="10.43.0.59"
AUTHOR_PORT="4502"
AUTHOR_DOCROOT='/mnt/var/www/author'
PUBLISH_IP="10.43.0.20"
PUBLISH_PORT="4503"
PUBLISH_DOCROOT='/mnt/var/www/html'
ENV_TYPE='dev'
RUNMODE='sites'

이는 변경할 수 있는 사항은 아니지만 구성 파일에서 활용하는 것이 좋습니다

변수 파일(.vars)

코드에서 제공한 사용자 지정 변수는 /etc/httpd/conf.d/variables/ 디렉터리 내의 .vars 파일에 있어야 합니다.

이러한 파일에는 원하는 사용자 지정 변수가 있을 수 있으며 일부 구문 예는 다음 샘플 파일에서 볼 수 있습니다

/etc/httpd/conf.d/variables/weretail_domains_dev.vars:

Define WERETAIL_DOMAIN dev.weretail.com
Define WERETAIL_ALT_DOMAIN dev.weretail.net

/etc/httpd/conf.d/variables/weretail_domains_stage.vars:

Define WERETAIL_DOMAIN stage.weretail.com
Define WERETAIL_ALT_DOMAIN stage.weretail.net

/etc/httpd/conf.d/variables/weretail_domains_prod.vars:

Define WERETAIL_DOMAIN www.weretail.com
Define WERETAIL_ALT_DOMAIN www..weretail.net

고유한 변수를 만들 때 파일의 이름을 해당 내용에 따라 지정하고 수동 여기에 제공된 이름 지정 표준을 따르도록 지정합니다.  위의 예에서 변수 파일이 구성 파일에 사용할 변수로 다른 DNS 항목을 호스팅함을 볼 수 있습니다.

변수 사용

변수 파일 내에 변수를 정의했으므로 다른 구성 파일 내에서 변수를 올바르게 사용하는 방법에 대해 알아보겠습니다.

위의 .vars 예제 파일을 사용하여 적절한 사용 사례를 보여 줍니다.

모든 환경 기반 변수를 전체적으로 포함하려고 /etc/httpd/conf.d/000_load_env_vars.conf 파일을 만듭니다.

IncludeOptional /etc/httpd/conf.d/variables/*_${ENV_TYPE}.vars
IncludeOptional /etc/httpd/conf.d/variables/*_${RUNMODE}.vars

httpd 서비스가 시작되면 AMS가 /etc/sysconfig/httpd에서 설정한 변수를 가져오고 변수가 ENV_TYPE 및 RUNMODE(으)로 설정되어 있는 것으로 알고 있습니다.

이 전역 .conf 파일을 가져올 때 conf.d에 있는 파일의 포함 순서가 영숫자 로드 순서이므로 파일 이름에 000이 있으면 디렉터리에 있는 다른 파일보다 먼저 로드됩니다.

include 문도 파일 이름에 변수를 사용합니다.  이렇게 하면 ENV_TYPE 및 RUNMODE 변수에 있는 값에 따라 실제로 로드할 파일을 변경할 수 있습니다.

ENV_TYPE 값이 dev인 경우 사용되는 파일은 다음과 같습니다.

/etc/httpd/conf.d/variables/weretail_domains_dev.vars

ENV_TYPE 값이 stage인 경우 사용되는 파일은 다음과 같습니다.

/etc/httpd/conf.d/variables/weretail_domains_stage.vars

RUNMODE 값이 preview인 경우 사용되는 파일은 다음과 같습니다.

/etc/httpd/conf.d/variables/weretail_domains_preview.vars

해당 파일이 포함되면 내부에 저장된 변수 이름을 사용할 수 있습니다.

/etc/httpd/conf.d/available_vhosts/weretail.vhost 파일에서 개발용으로만 작동한 일반 구문을 교환할 수 있습니다.

<VirtualHost *:80>
 ServerName dev.weretail.com
 ServerAlias dev.weretail.net

dev, stage 및 prod에 작동하는 변수의 기능을 사용하는 최신 구문의 경우,

<VirtualHost *:80>
 ServerName ${WERETAIL_DOMAIN}
 ServerAlias ${WERETAIL_ALT_DOMAIN}

/etc/httpd/conf.dispatcher.d/vhosts/weretail_vhosts.any 파일에서 개발용으로만 작동한 일반 구문을 교환할 수 있습니다.

"dev.weretail.com"
"dev.weretail.net"

dev, stage 및 prod에 작동하는 변수의 기능을 사용하는 최신 구문의 경우,

"${WERETAIL_DOMAIN}"
"${WERETAIL_ALT_DOMAIN}"

이러한 변수는 환경당 배포된 파일이 다를 필요 없이 실행 중인 설정을 개별화하는 데 재사용률이 매우 큽니다.  기본적으로 변수를 사용하여 구성 파일을 템플릿화하고 변수를 기반으로 파일을 포함할 수 있습니다.

변수 값 보기

때때로 변수를 사용할 때 구성 파일에 있을 수 있는 값을 확인하기 위해 검색해야 합니다. 서버에서 다음 명령을 실행하여 해결된 변수를 볼 수 있습니다.

source /etc/sysconfig/httpd;/sbin/httpd -S | grep Define | grep "="

컴파일된 Apache 구성에서 변수가 어떻게 표시됩니까?

$ source /etc/sysconfig/httpd;/sbin/httpd -t -D DUMP_CONFIG | grep -v "#"

컴파일된 Dispatcher 구성에서 변수가 어떻게 표시되는지:

$ source /etc/sysconfig/httpd;/sbin/httpd -t -D DUMP_ANY

명령 출력에서 구성 파일과 컴파일된 출력의 변수 차이점을 확인할 수 있습니다.

예제 구성

/etc/httpd/conf.d/enabled_vhosts/aem_publish.vhost:

<VirtualHost *:80>
    DocumentRoot    ${PUBLISH_DOCROOT}

이제 명령을 실행하여 컴파일된 출력을 확인합니다.

컴파일된 Apache 구성:

$ source /etc/sysconfig/httpd;/sbin/httpd -t -D DUMP_CONFIG | grep DocumentRoot
DocumentRoot /mnt/var/www/html

컴파일된 Dispatcher 구성:

$ source /etc/sysconfig/httpd;/sbin/httpd -t -D DUMP_ANY | grep docroot
/docroot "/mnt/var/www/html"

다음 -> 플러시