Förklaring av konfigurationsfiler

Innehållsförteckning

<- Föregående: Grundläggande fillayout

Det här dokumentet kommer att innehålla en beskrivning och en beskrivning av de konfigurationsfiler som distribueras i en standardserver som skapats av Dispatcher i Adobe Managed Services. deras användning, namnkonventioner osv.

Namngivningskonvention

Apache Web Server bryr sig egentligen inte om vad filtillägget är för en fil när den används med en Include- eller IncludeOptional-sats.  Om du namnger dem på rätt sätt med namn som eliminerar konflikter och förvirring blir ton lättare. Namn som används beskriver filens användningsområde och gör livet enklare. Om allt har namnet .conf blir det förvirrande. Vi vill undvika dåligt namngivna filer och tillägg.  Nedan finns en lista över de olika anpassade filtillägg och namnkonventioner som används i en typisk AMS-konfigurerad Dispatcher.

Filer i conf.d/

Filer i conf.dispatcher.d/

Undantagna problem

När du följer namnkonventionen kan du undvika att göra misstag som kan få katastrofala resultat.  Vi ska ta upp några exempel.

Exempel på problem

Som ett exempel på en plats för ExampleCo skapades två konfigurationsfiler av utvecklarna av Dispatcher-konfigurationerna.

/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

Om filen vhost av misstag placeras i mappen rewrites och rewrites file placeras i mappen vhosts.  Det verkar ha distribuerats korrekt av filnamnet, men Apache genererar ett FEL och problemet kommer inte att vara omedelbart synligt.

Så här blir det oftast ett problem

Om two files hämtas till platsen same kan de antingen overwrite themselves eller göra det omöjligt att särskilja, vilket gör distributionsprocessen till en mardröm.

Filtilläggen är desamma och tar automatiskt med någon

Filtilläggen är desamma och använder automatiskt inkluderat tillägg som Apache auto include alla .conf filer i många av standardmapparna.

Så här blir det oftast ett problem

Om värdfilen med tillägget .conf placeras i mappen /etc/httpd/conf.d/ försöker den att läsa in den i minnet på Apache, vilket vanligtvis är ok, men om den omskrivande regelfilen med tillägget .conf placeras i mappen /etc/httpd/conf.d/ inkluderas den automatiskt och används globalt, vilket ger förvirrande och oönskade resultat.

Upplösning

Namnge filerna baserat på vad de gör och säkert ut ur namnutrymmet för automatiska inkluderingsregler.

Om det är ett virtuellt värdfilnamn får det namnet med .vhost som tillägg.

Om det är en återskrivningsregelfil namnger du den med platsen _rewrite.rules som suffix och tillägg. Den här namnkonventionen visar vilken webbplats den är avsedd för och att det är en uppsättning regler för omskrivning.

Om det är en IP-vitlistregelfil ger du den namnet _whitelist.rules som suffix och tillägg. Den här namnkonventionen ger en beskrivning av vad den är till för och att det är en uppsättning IP-matchningsregler.

Om du använder dessa namnkonventioner undviker du problem om en fil flyttas till en katalog för automatisk infogning som den inte tillhör.

Om du till exempel placerar en fil med namnet .rules, .any eller .vhost i den automatiska inkluderingsmappen för /etc/httpd/conf.d/ påverkas inte filen.

Om en distributionsändringsbegäran säger"Distribuera exempel_eco_rewrite.rules till produktionsutskickare", kan den som distribuerar ändringarna redan veta att de inte lägger till en ny webbplats, så uppdaterar de bara skrivreglerna enligt filnamnet.

Inkludera order

När du utökar funktioner och konfigurationer i Apache Webserver som är installerad på Enterprise Linux har du några viktiga inkluderingsbeställningar som du vill förstå

Apache-baslinjen innehåller

Som du ser i diagrammet ovan ser httpd-binärfilen bara ut mot httpd.conf-filen som konfigurationsfilen.  Filen innehåller följande programsatser:

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

AMS-toppnivån omfattar

När vi tillämpade vår standard lade vi till ytterligare filtyper och inkluderar våra egna.

Här är AMS-originalkataloger och toppnivån innehåller

Bygger på Apache baslinje visar vi hur AMS skapade ytterligare mappar och inkluderingar på översta nivån för conf.d-mappar samt modulspecifika kataloger som är kapslade under /etc/httpd/conf.dispatcher.d/

När Apache läses in hämtas den i /etc/httpd/conf.modules.d/02-dispatcher.conf och den filen inkluderar den binära filen /etc/httpd/modules/mod_dispatcher.so i körningstillståndet.

LoadModule dispatcher_module modules /mod_dispatcher .so

Om du vill använda modulen i <VirtualHost /> släpper vi en konfigurationsfil i /etc/httpd/conf.d/ med namnet dispatcher_vhost.conf och i den här filen använder du de grundläggande parametrar som behövs för att modulen ska fungera:

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

Som du ser ovan innehåller detta den översta dispatcher.any-filen för Dispatcher-modulen som kan hämta dess konfigurationsfiler från /etc/httpd/conf.dispatcher.d/dispatcher.any

Tänk på innehållet i den här filen:

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

Filen dispatcher.any på den översta nivån innehåller alla aktiverade servergruppsfiler som finns i /etc/httpd/conf.dispatcher.d/enabled_farms/ med filnamnet FILENAME_farm.any som följer vår standardnamnkonvention.

Senare i filen dispatcher_vhost.conf som nämndes tidigare gör vi också en include-sats för att aktivera varje aktiverad virtuell värdfil som finns i /etc/httpd/conf.d/enabled_vhosts/ med filnamnet FILENAME.vhost som följer vår standardnamnkonvention.

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

I var och en av våra .vhost-filer kommer du att märka att Dispatcher-modulen initieras som en standardfilhanterare för en katalog.  Här är ett exempel på en .vhost-fil som visar syntaxen:

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

När den översta nivån innehåller en lösning har de andra underinkluderingar som är värda att nämnas.  Här följer ett diagram på hög nivå över hur servergrupperna och värdfilerna innehåller andra underelement

AMS virtuella värd innehåller

När en .vhost-fil från /etc/httpd/conf.d/availabled_vhosts/-katalogen länkas till /etc/httpd/conf.d/enabled_vhosts/-katalogen används de i den konfiguration som körs.

Filerna .vhost har underinkluderingar baserat på vanliga delar som vi har hittat.  Saker som variabler, vitlistor och skrivregler.

Filen .vhost kommer att innehålla programsatser för varje fil baserat på var de måste inkluderas i filen .vhost.  Här är ett exempel på syntax för en .vhost-fil som en bra referens:

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>

Som du ser i exemplet ovan finns det en inkluderingsfunktion för de variabler som behövs i konfigurationsfilen och som används senare.

I filen /etc/httpd/conf.d/variables/weretail.vars kan vi se vilka variabler som är definierade:

Define MAIN_DOMAIN dev.weretail.com

Du kan också se en rad som innehåller en lista med _whitelist.rules filer som begränsar vem som kan visa det här innehållet baserat på olika vitlistvillkor.  Här kan du se innehållet i en av de vita listfilerna /etc/httpd/conf.d/whitelists/weretail_mainoffice_whitelist.rules:

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

Du kan även se en rad som innehåller en uppsättning regler för omskrivning.  Låt oss titta på innehållet i filen 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-servergruppen innehåller

När en FILENAME_farm.any-fil från katalogen /etc/httpd/conf.dispatcher.d/available_farms/ får en länk till katalogen /etc/httpd/conf.dispatcher.d/enabled_farms/ används de i den konfiguration som körs.

Servergruppsfilerna innehåller undergrupper baserade på toppnivåavsnitt i servergruppen som cache, klienthuvuden, filter, återgivningar och värdar.

Filerna FILENAME_farm.any kommer att innehålla programsatser för varje fil baserat på var de måste inkluderas i servergruppsfilen.  Här är ett exempel på syntax för en FILENAME_farm.any-fil som en bra referens:

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

Som du kan se varje avsnitt för den lokala servergruppen i stället för att ha all syntax som behövs använder du programsatsen include.

Låt oss titta på syntaxen för några av dessa funktioner för att få en uppfattning om hur varje undergrupp skulle se ut

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

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

Som du ser är det en ny radavgränsad lista med domännamn som ska återges från den här servergruppen över de andra.

Titta sedan på /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" }

Nästa -> Förstå cache