Grundläggande fillayout

Innehållsförteckning

<- Previous: What is "The Dispatcher"

I det här dokumentet förklaras AMS-standardkonfigurationsuppsättningen och hur man tänker bakom den här konfigurationsstandarden

Standardmappstruktur för Enterprise Linux

I AMS använder grundinstallationen Enterprise Linux som basoperativsystem. När du installerar Apache Webserver finns en standardinställd installationsfil. Här är standardfilerna som installeras genom att grundläggande RPM-moduler som tillhandahålls av yum-databasen installeras

/etc/httpd/
├── conf
│   ├── httpd.conf
│   └── magic
├── conf.d
│   ├── autoindex.conf
│   ├── README
│   ├── userdir.conf
│   └── welcome.conf
├── conf.modules.d
│   ├── 00-base.conf
│   ├── 00-dav.conf
│   ├── 00-lua.conf
│   ├── 00-mpm.conf
│   ├── 00-proxy.conf
│   ├── 00-systemd.conf
│   └── 01-cgi.conf
├── logs -> ../../var/log/httpd
├── modules -> ../../usr/lib64/httpd/modules
└── run -> /run/httpd

När vi följer och följer installationsdesignen/-strukturen får vi följande fördelar:

"Obs!"

Adobe Managed Services-serverbilder har vanligtvis små rotenheter i operativsystemet.  Vi placerar våra data i en separat volym som vanligtvis är monterad i /mnt
Sedan använder vi volymen i stället för standardvärdena för följande standardkataloger

DocumentRoot

Log Directory

Kom ihåg att gamla och nya kataloger mappas tillbaka till den ursprungliga monteringspunkten för att undvika förvirring.
Att använda en separat volym är inte nödvändigt, men det är värt att notera

AMS-tillägg

AMS lägger till ytterligare information i grundinstallationen av Apache Web Server.

Dokumentrot

AMS-standarddokumentrötter:

Mellanlagring och aktiverade VirtualHost-kataloger

Med följande kataloger kan du bygga ut konfigurationsfiler med ett mellanlagringsområde som du kan arbeta med filer och bara aktivera när de är klara.

Ytterligare conf.d kataloger

Det finns ytterligare delar som är vanliga i Apache-konfigurationer och vi har skapat underkataloger för att göra det möjligt att separera dessa filer på ett rent sätt och inte ha alla filer i en katalog

Skriver om katalog

Den här katalogen kan innehålla alla _rewrite.rules filer som du skapar och som innehåller din vanliga RewriteRuleSyntax som används på Apache-webbservrar i modulen mod_rewrite

Katalogen Whitelists

Den här katalogen kan innehålla alla _whitelist.rules filer som du skapar och som innehåller din typiska IP Allow - eller Require IPsyntax som använder Apache-webbservrar åtkomstkontroller

Variabelkatalog

Den här katalogen kan innehålla alla .vars-filer som du skapar och som innehåller variabler som du kan använda i dina konfigurationsfiler

Dispatcher modulspecifik konfigurationskatalog

Apache Web Server är mycket utbyggbar och när en modul har många konfigurationsfiler är det bäst att skapa en egen konfigurationskatalog under installationens baskatalog i stället för att rensa upp standardkatalogen.

Vi följer den bästa metoden och skapar en egen

Katalog för modulkonfigurationsfil

Mellanlagring och aktiverad servergrupp

Med följande kataloger kan du bygga ut konfigurationsfiler med ett mellanlagringsområde som du kan arbeta med filer och bara aktivera när de är klara.

Ytterligare conf.dispatcher.d kataloger

Det finns ytterligare delar som är underavsnitt i Dispatcher servergruppskonfigurationer och vi har skapat underkataloger för att göra det möjligt att separera dessa filer på ett rent sätt och inte ha alla filer i en katalog

Cachekatalog

Den här katalogen innehåller alla _cache.any, _invalidate.any filer som du skapar och som innehåller dina regler om hur du vill att modulen ska hantera cachelagrade element från AEM samt syntax för ogiltighetsregler.  Mer information finns här här

Katalog för klientrubriker

Den här katalogen kan innehålla alla _clientheaders.any filer som du skapar och som innehåller listor med klienthuvuden som du vill skicka till AEM när en begäran kommer in.  Mer information om det här avsnittet finns här

Filterkatalog

Den här katalogen kan innehålla alla _filters.any filer som du skapar och som innehåller alla filterregler för att blockera eller tillåta trafik genom Dispatcher att nå AEM

Återger katalog

Den här katalogen kan innehålla alla _renders.any filer som du skapar och som innehåller anslutningsinformationen till varje backend-server som dispatchern kommer att använda innehåll från

Vvärkatalog

Den här katalogen kan innehålla alla _vhosts.any filer som du skapar och som innehåller en lista med domännamn och sökvägar som matchar en viss servergrupp med en viss serverdel

Fullständig mappstruktur

AMS har strukturerat var och en av filerna med anpassade filtillägg och med avsikt att undvika namnutrymmesproblem/konflikter och förvirring.

Här är ett exempel på en standardfiluppsättning från en AMS-standarddistribution:

/etc/httpd/
├── conf
│   ├── httpd.conf
│   └── magic
├── conf.d
│   ├── 000_init_ootb_vars.conf
│   ├── 001_init_ams_vars.conf
│   ├── README
│   ├── autoindex.conf
│   ├── available_vhosts
│   │   ├── 000_unhealthy_author.vhost
│   │   ├── 000_unhealthy_publish.vhost
│   │   ├── aem_author.vhost
│   │   ├── aem_flush.vhost
│   │   ├── aem_flush_author.vhost
│   │   ├── aem_health.vhost
│   │   ├── aem_publish.vhost
│   │   └── ams_lc.vhost
│   ├── dispatcher_vhost.conf
│   ├── enabled_vhosts
│   │   ├── aem_author.vhost -> ../available_vhosts/aem_author.vhost
│   │   ├── aem_flush.vhost -> ../available_vhosts/aem_flush.vhost
│   │   ├── aem_health.vhost -> /etc/httpd/conf.d/available_vhosts/aem_health.vhost
│   │   └── aem_publish.vhost -> ../available_vhosts/aem_publish.vhost
│   ├── logformat.conf
│   ├── mimetypes3d.conf
│   ├── remoteip.conf
│   ├── rewrites
│   │   ├── base_rewrite.rules
│   │   └── xforwarded_forcessl_rewrite.rules
│   ├── security.conf
│   ├── userdir.conf
│   ├── variables
│   │   ├── ams_default.vars
│   │   └── ootb.vars
│   ├── welcome.conf
│   └── whitelists
│       └── 000_base_whitelist.rules
├── conf.dispatcher.d
│   ├── available_farms
│   │   ├── 000_ams_catchall_farm.any
│   │   ├── 001_ams_author_flush_farm.any
│   │   ├── 001_ams_publish_flush_farm.any
│   │   ├── 002_ams_author_farm.any
│   │   ├── 002_ams_lc_farm.any
│   │   └── 002_ams_publish_farm.any
│   ├── cache
│   │   ├── ams_author_cache.any
│   │   ├── ams_author_invalidate_allowed.any
│   │   ├── ams_publish_cache.any
│   │   └── ams_publish_invalidate_allowed.any
│   ├── clientheaders
│   │   ├── ams_author_clientheaders.any
│   │   ├── ams_common_clientheaders.any
│   │   ├── ams_lc_clientheaders.any
│   │   └── ams_publish_clientheaders.any
│   ├── dispatcher.any
│   ├── enabled_farms
│   │   ├── 000_ams_catchall_farm.any -> ../available_farms/000_ams_catchall_farm.any
│   │   ├── 001_ams_author_flush_farm.any -> ../available_farms/001_ams_author_flush_farm.any
│   │   ├── 001_ams_publish_flush_farm.any -> ../available_farms/001_ams_publish_flush_farm.any
│   │   ├── 002_ams_author_farm.any -> ../available_farms/002_ams_author_farm.any
│   │   └── 002_ams_publish_farm.any -> ../available_farms/002_ams_publish_farm.any
│   ├── filters
│   │   ├── ams_author_filters.any
│   │   ├── ams_lc_filters.any
│   │   └── ams_publish_filters.any
│   ├── renders
│   │   ├── ams_author_renders.any
│   │   ├── ams_lc_renders.any
│   │   └── ams_publish_renders.any
│   └── vhosts
│       ├── ams_author_vhosts.any
│       ├── ams_lc_vhosts.any
│       └── ams_publish_vhosts.any
├── conf.modules.d
│   ├── 00-base.conf
│   ├── 00-dav.conf
│   ├── 00-lua.conf
│   ├── 00-mpm.conf
│   ├── 00-mpm.conf.old
│   ├── 00-proxy.conf
│   ├── 00-systemd.conf
│   ├── 01-cgi.conf
│   └── 02-dispatcher.conf
├── logs -> ../../var/log/httpd
├── modules -> ../../usr/lib64/httpd/modules
└── run -> /run/httpd

Behåll det idealiskt

Enterprise Linux har patchcykler för Apache Webserver Package (httpd).

De mindre installerade standardfilerna som du ändrar blir bättre. Om några patchade säkerhetskorrigeringar eller konfigurationsförbättringar tillämpas via kommandot RPM/Yum kommer korrigeringarna inte att tillämpas ovanpå en ändrad fil.

I stället skapas en .rpmnew-fil bredvid originalet.  Det innebär att du kommer att sakna vissa ändringar som du kan ha önskat och skapat mer skräp i konfigurationsmapparna.

RPM:en under uppdateringsinstallationen kommer att undersöka httpd.conf om den är i läget unaltered, den kommer att ersätta filen och du får de viktiga uppdateringarna. Om httpd.conf var altered ersätter det inte filen. I stället skapas en referensfil med namnet httpd.conf.rpmnew och de många önskade korrigeringarna finns i filen som inte används vid tjänststart.

Enterprise Linux har konfigurerats korrekt för att hantera det här användningsexemplet på ett bättre sätt.  De ger dig områden där du kan utöka eller åsidosätta de standardvärden som de anger åt dig.  I grundinstallationen av httpd hittar du filen /etc/httpd/conf/httpd.conf och den har en syntax som:

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

Apache vill att du ska utöka modulerna och konfigurationerna genom att lägga till nya filer i katalogerna /etc/httpd/conf.d/ och /etc/httpd/conf.modules.d/ med filtillägget .conf

Som det perfekta exemplet när du lägger till Dispatcher-modulen i Apache skapar du en modul .so-fil i /etc/httpd/modules/ och tar sedan med den genom att lägga till en fil i /etc/httpd/conf.modules.d/02-dispatcher.conf med innehållet som läser in modulfilen .so

LoadModule dispatcher_module modules/mod_dispatcher.so

Nu använder vi modulen i filen /etc/httpd/conf.d/dispatcher_vhost.conf som initierar modulen och läser in den initiala modulspecifika konfigurationsfilen

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

Även här kommer du att märka att vi har lagt till filer och moduler, men inte ändrat några originalfiler.  Detta ger oss den önskade funktionaliteten och skyddar oss från saknade korrigeringar samt att hålla oss till högsta kompatibilitetsnivå med varje uppgradering av paketet.

Nästa -> Förklaring av konfigurationsfiler