Uitleg van configuratiebestanden

Inhoudsopgave

<- Vorige: basisbestandsindeling

Dit document zal onderbreken en elk van de configuratiedossiers verklaren die in een standaard gebouwde server van Dispatcher worden opgesteld die in Adobe Managed Services wordt voorzien. Het gebruik ervan, de naamgevingsconventie, enz.

Naamgevingsconventie

Apache Web Server geeft eigenlijk niet om wat de bestandsextensie is van een bestand wanneer de extensie wordt toegewezen aan een Include - of IncludeOptional -instructie.  Namen hen behoorlijk met namen die conflicten en verwarring elimineren helpt a ton . De namen die worden gebruikt, beschrijven het bereik van de toepassing van het bestand, waardoor het leven gemakkelijker wordt. Als alles de naam .conf heeft, wordt dit echt verwarrend. We willen bestanden en extensies met een lage naam voorkomen.  Hieronder volgt een lijst met de verschillende aangepaste bestandsextensies en naamgevingsconventies die worden gebruikt in een standaard Dispatcher met AMS-configuratie.

Bestanden in conf.d/

Bestanden in conf.dispatcher.d/

Vermijde problemen

Wanneer u de naamgevingsconventie volgt, kunt u bepaalde tamelijk eenvoudige fouten vermijden die rampzalige resultaten kunnen hebben.  We zullen enkele voorbeelden noemen.

Probleemvoorbeeld

Als plaatsvoorbeeld voor ExampleCo werden twee configuratiedossiers gecreeerd door de ontwikkelaars van de configuraties van 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

Als het vhost -bestand per ongeluk in de rewrites -map wordt geplaatst en de rewrites file in de vhosts -map wordt geplaatst.  Het zou om door filename behoorlijk worden opgesteld, nog zal Apache een FOUT werpen en het probleem zal niet onmiddellijk duidelijk zijn.

hoe dit typisch een kwestie wordt

Als de two files naar de same -locatie wordt gedownload, kunnen ze dit overwrite themselves doen of het onherkenbaar maken. Hierdoor wordt het implementatieproces een nachtmerrie.

de dossieruitbreidingen zijn het zelfde en auto-omvat prone

De bestandsextensies zijn gelijk en gebruiken een automatisch opgenomen extensie die door Apache wordt auto include weergegeven in .conf -bestanden in veel van de standaardmappen van Apache.

hoe dit typisch een kwestie wordt

Als het hostbestand met de extensie .conf in de /etc/httpd/conf.d/ -map wordt geplaatst, probeert het dit bestand te laden in het geheugen van Apache. Dit is normaal gesproken OK, maar als het bestand met herschrijfregels met de extensie .conf in de /etc/httpd/conf.d/ -map wordt geplaatst, wordt het automatisch opgenomen en wordt het globaal toegepast, wat verwarrende en ongewenste resultaten oplevert.

Resolutie

Geef de bestanden een naam die is gebaseerd op wat ze doen en veilig buiten de naamruimte van regels voor automatisch opnemen.

Als het een virtueel gastheerdossier is noem het met .vhost als uitbreiding.

Als het een herschrijf regeldossier is, noem het met plaats _rewrite.rules als achtervoegsel en uitbreiding. Deze naamgevingsconventie zal duidelijk maken voor welke site het is en dat het een set herschrijfregels is.

Als het een IP whitelist regeldossier is, noem het beschrijving _whitelist.rules als achtervoegsel en uitbreiding. Deze noemende overeenkomst zal wat beschrijving van geven wat het is en dat het een reeks IP passende regels is.

Als u deze naamgevingsconventies gebruikt, worden problemen voorkomen als een bestand wordt verplaatst naar een map voor automatisch opnemen die niet bij het bestand hoort.

Als u bijvoorbeeld een bestand met de naam .rules , .any of .vhost in de map auto-include van /etc/httpd/conf.d/ plaatst, heeft dat geen invloed.

Als een verzoek van de plaatsingsverandering "gelieve te stellen voorbeeco_rewrite.rules aan productieDispatchers"zegt, kan de persoon die de veranderingen opstelt reeds weten dat zij geen nieuwe plaats toevoegen, zij enkel bijwerken herschrijft regels zoals die door filename worden vermeld.

Volgorde opnemen

Bij het uitbreiden van functionaliteit en configuraties in Apache Webserver die op Onderneming Linux wordt geïnstalleerd, hebt u enkele belangrijke bevelen omvat u zult willen begrijpen

Inclusief basislijn Apache

Zoals in het diagram boven het httpd binaire getal wordt gezien kijkt slechts aan het httpd.conf- dossier aangezien het configuratiedossier is.  Dat bestand bevat de volgende instructies:

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

Inclusief hoofdniveau AMS

Toen wij onze norm toepasten, voegden wij enkele extra dossiertypes en van onze toe.

Hier zijn de basislijnmappen van AMS en de bovenste include-bestanden op het niveau
leeft

Aan de hand van de basislijn van Apache laten we zien hoe AMS aanvullende mappen en include-bestanden op hoofdniveau heeft gemaakt voor conf.d -mappen en specifieke mappen die zijn genest onder /etc/httpd/conf.dispatcher.d/

Wanneer Apache wordt geladen, wordt het /etc/httpd/conf.modules.d/02-dispatcher.conf opgehaald en wordt het binaire bestand /etc/httpd/modules/mod_dispatcher.so opgenomen in de actieve staat.

LoadModule dispatcher_module modules /mod_dispatcher .so

Als u de module wilt gebruiken in onze <VirtualHost /> , zet u een configuratiebestand neer in /etc/httpd/conf.d/ named dispatcher_vhost.conf en in dit bestand ziet u hoe u de basisparameters die nodig zijn om de module te laten werken, instelt:

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

Zoals u hierboven kunt zien, bevat dit het bestand op hoofdniveau dispatcher.any voor onze Dispatcher-module om de configuratiebestanden van deze module op te halen uit /etc/httpd/conf.dispatcher.d/dispatcher.any

Let op de inhoud van dit bestand:

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

Het bestand op hoofdniveau dispatcher.any bevat alle ingeschakelde landbouwhuisbestanden die in /etc/httpd/conf.dispatcher.d/enabled_farms/ met de bestandsnaam FILENAME_farm.any wonen en die voldoen aan onze standaardnaamgevingsconventie.

Later in het eerder vermelde dispatcher_vhost.conf bestand voeren we ook een include-instructie uit om elk ingeschakeld virtueel hostbestand in te schakelen dat in /etc/httpd/conf.d/enabled_vhosts/ met de bestandsnaam van FILENAME.vhost woont. Deze instructie volgt de standaardnaamgevingsconventie.

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

In elk van onze .vhost-bestanden ziet u dat de Dispatcher-module wordt geïnitialiseerd als een standaardbestandshandler voor een map.  Hier volgt een voorbeeld van een .vhost-bestand met de syntaxis:

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

Nadat het hoogste niveau omvat oplossen hebben zij andere sub omvat die het vermelden waard zijn.  Hier is een diagram op hoog niveau op hoe de landbouwbedrijven en de gastheren dossiers andere subelementen omvatten

Inclusief virtuele AMS-host

herschrijft

Wanneer een .vhost -bestand uit de map /etc/httpd/conf.d/availabled_vhosts/ wordt gesymboliseerd in de map /etc/httpd/conf.d/enabled_vhosts/ , wordt het gebruikt in de actieve configuratie.

De .vhost -bestanden bevatten subinclude-bestanden op basis van gemeenschappelijke items die we hebben gevonden.  Dingen als variabelen, whitelisten en herschrijven van regels.

Het .vhost -bestand bevat instructies voor elk bestand op basis van de locatie waar ze in het .vhost -bestand moeten worden opgenomen.  Hier volgt een voorbeeld van de syntaxis van een .vhost -bestand als een goede referentie:

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>

Zoals u in het bovenstaande voorbeeld kunt zien, is er een include-bestand voor de variabelen die nodig zijn in dit configuratiebestand die later worden gebruikt.

In het bestand /etc/httpd/conf.d/variables/weretail.vars kunnen we zien welke variabelen zijn gedefinieerd:

Define MAIN_DOMAIN dev.weretail.com

U kunt ook een regel zien die een lijst bevat met _whitelist.rules -bestanden die bepalen wie deze inhoud kan bekijken op basis van verschillende whitelistcriteria.  Hiermee kunt u de inhoud van een van de bestanden in de witte lijst bekijken /etc/httpd/conf.d/whitelists/weretail_mainoffice_whitelist.rules :

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

U kunt ook een regel zien die een set herschrijfregels bevat.  Bekijk de inhoud van het bestand 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]

Omvat AMS-landbouwbedrijf

Wanneer om het even welke FILENAME_farm.om het even welke dossiers van /etc/httpd/conf.dispatcher.d/available_farms/ folder in de /etc/httpd/conf.dispatcher.d/enabled_farms/ folder worden gesymboliseerd zullen zij in de lopende configuratie worden gebruikt.

De landbouwbedrijfdossiers hebben sub omvat gebaseerd op hoogste niveausecties van het landbouwbedrijfals geheime voorgeheugen, klantheaders, filters, teruggeeft, en gastheren.

De FILENAME_farm.any -bestanden bevatten instructies voor elk bestand op basis van de locatie waar de bestanden in het landbouwbedrijfsbestand moeten worden opgenomen.  Hier volgt een voorbeeld van de syntaxis van een FILENAME_farm.any -bestand als een goede referentie:

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

Aangezien u elke sectie voor het weretail landbouwbedrijf in plaats van het hebben van alle syntaxis nodig kunt zien het in plaats daarvan het gebruiken omvat verklaring.

Laten we eens kijken naar de syntaxis van een paar van deze include-bestanden om te zien hoe elke include-code eruit zou zien

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

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

Aangezien u kunt zien is het een nieuwe lijn gescheiden lijst van domeinnamen die van dit landbouwbedrijf over anderen zou moeten teruggeven.

Kijk nu naar de /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" }

Volgende -> Cache begrijpen