配置文件说明

目录

< — 上一页：基本文件布局

本文档将细分并解释AdobeManaged Services中配置的标准内置Dispatcher服务器中部署的每个配置文件。 它们的使用、命名惯例等……

命名约定

使用Include或IncludeOptional语句定位文件时，Apache Web Server实际上不在乎文件的文件扩展名。  用能消除冲突和混淆的名称正确命名它们有助于 吨。 使用的名称将描述应用文件的范围，使工作更轻松。 如果所有对象都名为.conf，这会让人感到非常困惑。 我们希望避免文件及扩展名的命名不当。  以下是典型AMS配置的Dispatcher中使用的各种自定义文件扩展名和命名约定的列表。

conf.d/中包含的文件

conf.dispatcher.d/中包含的文件

已避免的问题

在遵循命名惯例时，您可以避免某些容易出错且可能造成灾难性结果的错误。  我们将介绍一些示例。

问题示例

作为网站示例，ExampleCo由Dispatcher配置的开发人员创建了两个配置文件。

/etc/httpd/conf.d/exampleco.conf

<VirtualHost *:80>
    ServerName  "exampleco"
    ServerAlias "www.exampleco.com"
    .......... SNIP ...............
    <IfModule mod_rewrite.c>
        ReWriteEngine   on
        LogLevel warn rewrite:trace1
        Include /etc/httpd/conf.d/rewrites/exampleco.conf
    </IfModule>
</VirtualHost>

/etc/httpd/conf.d/rewrites/exampleco.conf

RewriteRule ^/$ /content/exampleco/en.html [PT,L]
RewriteRule ^/robots.txt$ /content/dam/exampleco/robots.txt [PT,L]

POTENTIAL DANGER - The file names are the same

如果意外将vhost文件放入rewrites文件夹，而将rewrites file放入vhosts文件夹。  该文件名似乎已正确部署，但Apache将引发​ 错误，问题不会立即显现。

这通常如何变成问题

如果将two files下载到same位置，则他们可以overwrite themselves，或者使其无法区分，这将使部署过程成为噩梦。

文件扩展名相同且容易自动包含

文件扩展名相同，并且使用自动包含的扩展名，Apache将在其许多默认文件夹中auto include任何.conf文件。

这通常如何变成问题

如果将扩展名为.conf的vhost文件放入/etc/httpd/conf.d/文件夹，它将尝试将其加载到Apache上的内存中（通常正常），但如果将扩展名为.conf的重写规则文件放入/etc/httpd/conf.d/文件夹，它将自动包含并全局应用，从而导致混淆和不希望的结果。

解决方法

根据文件的操作命名文件，并安全地退出自动包含规则命名空间。

如果是虚拟主机文件名，则使用.vhost作为扩展名。

如果是重写规则文件，请将其命名为site_rewrite.rules作为后缀和扩展名。 此命名惯例将明确指出该站点用于哪个站点，以及它是一组重写规则。

如果它是IP白名单规则文件，请将其描述命名为_whitelist.rules作为后缀和扩展名。 此命名约定将给出其用途的一些描述，以及它是一组IP匹配规则。

如果文件被移动到其不所属的自动包含目录中，使用这些命名约定可避免出现问题。

例如，将名为.rules、.any或.vhost的文件放置在/etc/httpd/conf.d/的自动包含文件夹中不会产生任何影响。

如果部署更改请求中显示“请将exampleco_rewrite.rules部署到生产Dispatcher”，则部署这些更改的人员可能已经知道他们不会添加新站点，而只是更新重写规则，如文件名所示。

包括订单

在Enterprise Linux上安装的Apache Webserver中扩展功能和配置时，您有一些重要的包括订单，您需要了解这些订单

Apache基线包括

如上图所示，httpd二进制文件仅查找httpd.conf文件作为配置文件。  该文件包含以下语句：

Include conf.modules.d/*.conf
IncludeOptional conf.d/*.conf

AMS顶级包含

在应用标准时，我们添加了其他文件类型，并包括我们自己的文件类型。

以下是AMS基准目录，最上层包括
中的实际配置文件的符号链接

基于Apache的基线，我们展示了AMS如何为conf.d文件夹以及嵌套在/etc/httpd/conf.dispatcher.d/下的模块特定目录创建一些其他文件夹和顶级包含

当Apache加载时，它将拉入/etc/httpd/conf.modules.d/02-dispatcher.conf，并且该文件会将二进制文件/etc/httpd/modules/mod_dispatcher.so纳入到它的运行状态。

LoadModule dispatcher_module modules /mod_dispatcher .so

要在<VirtualHost />中使用模块，我们将配置文件拖放到名为dispatcher_vhost.conf的/etc/httpd/conf.d/中，在该文件中，您将看到使用设置模块工作所需的基本参数：

<IfModule disp_apache2.c>
    DispatcherConfig conf.dispatcher.d/dispatcher.any
    ...SNIP...
</IfModule>

如上所示，这包括我们的Dispatcher模块的顶级dispatcher.any文件，以便从/etc/httpd/conf.dispatcher.d/dispatcher.any中提取其配置文件

请注意此文件的内容：

/farms {
    $include "enabled_farms/*_farm.any"
}

顶级dispatcher.any文件包括在/etc/httpd/conf.dispatcher.d/enabled_farms/中生活的所有启用场文件，其文件名为FILENAME_farm.any，符合我们的标准命名约定。

稍后在前面提到的dispatcher_vhost.conf文件中，我们还执行了include语句，以启用每个启用的、文件名为FILENAME.vhost且位于/etc/httpd/conf.d/enabled_vhosts/中的虚拟主机文件，这些文件遵循我们的标准命名约定。

IncludeOptional /etc/httpd/conf.d/enabled_vhosts/*.vhost

在每个.vhost文件中，您会注意到Dispatcher模块已初始化为目录的默认文件处理程序。  下面是一个示例.vhost文件，其中显示了语法：

<VirtualHost *:80>
 ServerName "weretail"
 ServerAlias www.weretail.com weretail.com
 <Directory />
  <IfModule disp_apache2.c>
   ....SNIP....
   SetHandler dispatcher-handler
  </IfModule>
  ....SNIP....
 </Directory>
 ....SNIP....
</VirtualHost>

在顶级包含解析后，它们会具有其他值得一提的子包含。  以下是一个高级图表，说明了场和vhosts文件如何包含其他子元素

AMS虚拟主机包括

当来自/etc/httpd/conf.d/availabled_vhosts/目录的任何.vhost文件被符号链接到/etc/httpd/conf.d/enabled_vhosts/目录时，它们将在运行配置中使用。

.vhost文件具有基于我们找到的公共段的子包含。  变量、白名单和重写规则等内容。

.vhost文件将根据每个文件需要包含在.vhost文件中的位置为其包含include语句。  以下是.vhost文件的示例语法，作为良好引用：

Include /etc/httpd/conf.d/variables/weretail.vars
<VirtualHost *:80>
 ServerName "${MAIN_DOMAIN}"
 <Directory />
  Include /etc/httpd/conf.d/whitelists/weretail*_whitelist.rules
  <IfModule disp_apache2.c>
   ....SNIP....
   SetHandler dispatcher-handler
  </IfModule>
  ....SNIP....
 </Directory>
 ....SNIP....
 <IfModule mod_rewrite.c>
  ReWriteEngine   on
  LogLevel warn rewrite:trace1
  Include /etc/httpd/conf.d/rewrites/weretail_rewrite.rules
 </IfModule>
</VirtualHost>

如上面的示例所示，此配置文件中有一个include用于以后要使用的变量。

在文件/etc/httpd/conf.d/variables/weretail.vars中，我们可以看到定义了哪些变量：

Define MAIN_DOMAIN dev.weretail.com

您还可以看到一行，其中包含根据不同的白名单条件限制谁可以查看此内容的_whitelist.rules文件列表。  让我们查看白名单文件/etc/httpd/conf.d/whitelists/weretail_mainoffice_whitelist.rules的内容：

<RequireAny>
  Require ip 192.150.16.0/23
</RequireAny>

您还可以看到包含一组重写规则的行。  让我们看一下weretail_rewrite.rules文件的内容：

RewriteRule ^/robots.txt$ /content/dam/weretail/robots.txt [NC,PT]
RewriteCond %{SERVER_NAME} brand1.weretail.net [NC]
RewriteRule ^/favicon.ico$ /content/dam/weretail/favicon.ico [NC,PT]
RewriteCond %{SERVER_NAME} brand2.weretail.com [NC]
RewriteRule ^/sitemap.xml$ /content/weretail/general/sitemap.xml [NC,PT]
RewriteRule ^/logo.jpg$ /content/dam/weretail/general/logo.jpg [NC,PT]

AMS场包含

当来自/etc/httpd/conf.dispatcher.d/available_farms/目录的任何FILENAME_farm.any文件被符号链接到/etc/httpd/conf.dispatcher.d/enabled_farms/目录时，它们将在运行配置中使用。

场文件具有基于场🔗的顶级部分的子包含，如缓存、clientheaders、筛选器、渲染器和主机。

FILENAME_farm.any文件将根据需要在场文件中包含它们的位置，为每个文件包含include语句。  以下是FILENAME_farm.any文件的示例语法，作为良好引用：

/weretailfarm {
 /clientheaders {
  $include "/etc/httpd/conf.dispatcher.d/clientheaders/ams_publish_clientheaders.any"
  $include "/etc/httpd/conf.dispatcher.d/clientheaders/ams_common_clientheaders.any"
 }
 /virtualhosts {
  $include "/etc/httpd/conf.dispatcher.d/vhosts/weretail_vhosts.any"
 }
 /renders {
  $include "/etc/httpd/conf.dispatcher.d/renders/ams_publish_renders.any"
 }
 /filter {
  $include "/etc/httpd/conf.dispatcher.d/filters/ams_publish_filters.any"
  $include "/etc/httpd/conf.dispatcher.d/filters/weretail_search_filters.any"
 }
 ....SNIP....
 /cache {
  ....SNIP....
  /rules {
   $include "/etc/httpd/conf.dispatcher.d/cache/ams_publish_cache.any"
  }
  ....SNIP....
  /allowedClients {
   /0000 {
    /glob "*.*.*.*"
    /type "deny"
   }
   $include "/etc/httpd/conf.dispatcher.d/cache/ams_publish_invalidate_allowed.any"
  }
 ....SNIP....
 }
}

由于您可以看到weretail场的每个部分，但没有获得所需的所有语法，因此请使用include语句。

让我们看一下其中几个包含的语法，以了解每个子包含是什么样的

/etc/httpd/conf.dispatcher.d/vhosts/weretail_publish_vhosts.any：

"brand1.weretail.com"
"brand2.weretail.com"
"www.weretail.comf"

如您所见，这是一个新的以行分隔的域名列表，应从该场呈现域名，而不是其他场。

接下来，我们查看/etc/httpd/conf.dispatcher.d/filters/weretail_search_filters.any：

/400 { /type "allow" /method "GET" /path "/bin/weretail/lists/*" /extension "json" }
/401 { /type "allow" /method "POST" /path "/bin/weretail/search/' /extension "html" }

下一步 — >了解缓存