組態檔說明

目錄

< — 上一步：基本檔案配置

本檔案將細分並說明Managed ServicesAdobe中布建的標準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.any檔案，供我們的Dispatcher模組從/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陳述式，以啟用每個在/etc/httpd/conf.d/enabled_vhosts/中啟用的虛擬主機檔案（檔案名稱為FILENAME.vhost），這些檔案會遵循我們的標準命名慣例。

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個檔案具有根據我們找到之共同片段的Sub Include。  變數、白名單和重寫規則等。

.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>

如上面的範例所示，此設定檔案中需要納入的變數稍後會使用。

在檔案/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、篩選器、轉譯器和vhosts。

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" }

下一個 — >瞭解快取