Basisbestandsindeling

Inhoudsopgave

<- Vorige: wat is "De Dispatcher"

In dit document wordt de standaardset configuratiebestanden van AMS beschreven en wordt de gedachte achter deze configuratiestandaard uitgelegd

Standaardmapstructuur voor Enterprise Linux

In AMS gebruikt de basisinstallatie Enterprise Linux als het basisbesturingssysteem. Wanneer u Apache Webserver installeert, wordt standaard een installatiebestand geïnstalleerd. Hier zijn de standaardbestanden die worden geïnstalleerd door de basis-RPM's te installeren die door de yum-opslagplaats worden geleverd

/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

Wanneer het volgende en het naleven van het installatieontwerp/de structuur krijgen wij de volgende voordelen:

"Nota"

De Adobe Managed Services-serverimages hebben doorgaans kleine hoofdstations van het besturingssysteem.  We plaatsen onze gegevens in een afzonderlijk volume dat normaal gesproken in /mnt wordt gemonteerd
Dan gebruiken wij dat volume in plaats van de gebreken voor de volgende standaardfolders

DocumentRoot

Log Directory

Houd in mening dat de oude en nieuwe folders terug naar het originele onderstelpunt worden in kaart gebracht om verwarring te elimineren.
Het gebruik van een afzonderlijk volume is niet van vitaal belang, maar het is een notitie die het waard is

AMS-invoegtoepassingen

AMS voegt een toevoeging toe aan de basisinstallatie van Apache Web Server.

Documentrasters

AMS-standaardachterbasis voor documenten:

Staging en Enabled VirtualHost Directories

Met de volgende mappen kunt u configuratiebestanden samenstellen met een parkeergebied dat u kunt bewerken aan bestanden en vervolgens alleen kunt inschakelen wanneer deze gereed zijn.

Aanvullende conf.d directory's

Er zijn aanvullende onderdelen die veel voorkomen in Apache-configuraties en we hebben submappen gemaakt voor een schone manier om deze bestanden van elkaar te scheiden en niet alle bestanden in één directory te plaatsen

Map opnieuw schrijven

Deze folder kan alle _rewrite.rules dossiers bevatten u creeert die uw typische RewriteRulesyntax bevatten die Apache Webservers mod_rewritemodule in dienst nemen

Map Whitelists

Deze folder kan alle _whitelist.rules dossiers bevatten u creeert die uw typische IP Allow of Require IP syntaxis bevatten die Apache Webservers toegangscontrolesin dienst nemen

Directory voor variabelen

Deze map kan alle .vars bestanden bevatten die u maakt en die variabelen bevatten die u kunt gebruiken in uw configuratiebestanden

Dispatcher Module-specifieke configuratiemap

De Server van het Web van Apache is zeer verlengbaar en wanneer een module heel wat configuratiedossiers heeft is het beste praktijken om uw eigen configuratiefolder onder de installatielandfolder in plaats van het verwarren omhoog standaardte creëren.

We volgen de beste praktijken en creëerden onze eigen

Module configuratiebestand

Staging en ingeschakelde kwekerij

Met de volgende mappen kunt u configuratiebestanden samenstellen met een parkeergebied dat u kunt bewerken aan bestanden en vervolgens alleen kunt inschakelen wanneer deze gereed zijn.

Aanvullende conf.dispatcher.d directory's

Er zijn extra stukken die subsecties zijn van de configuraties van het de landbouwbedrijfdossier van Dispatcher en wij creeerden subfolders om voor een schone manier toe te staan om die dossiers te scheiden en niet alle dossiers in één folder te hebben

Cache Directory

Deze map bevat alle _cache.any , _invalidate.any -bestanden die u maakt en die uw regels bevatten over de manier waarop de module caching-elementen moet verwerken die afkomstig zijn van AEM en syntaxis van validatieregels.  Meer details op deze sectie zijn hier 🔗

Map met clientkoppen

Deze map kan alle _clientheaders.any bestanden bevatten die u maakt en lijsten met clientkoppen bevatten die u wilt doorgeven aan AEM wanneer een aanvraag wordt ingediend.  Meer details op deze sectie zijn hier

Filtermap

Deze map kan alle _filters.any bestanden bevatten die u maakt en die al uw filterregels bevatten om het verkeer door de Dispatcher te blokkeren of te laten bereiken AEM

Map renderen

Deze map kan alle _renders.any bestanden bevatten die u maakt en die de connectiviteitsgegevens bevatten voor elke backendserver waarvan de verzender inhoud gebruikt.

Vhosts-map

Deze map kan alle _vhosts.any bestanden bevatten die u maakt en die een lijst bevatten met de domeinnamen en -paden die moeten worden aangepast aan een bepaalde farm aan een bepaalde back-end server

Volledige mapstructuur

AMS heeft elk bestand gestructureerd met aangepaste bestandsextensies en met de bedoeling naamruimteproblemen/conflicten en verwarring te voorkomen.

Hier volgt een voorbeeld van een standaardbestandsset van een standaardimplementatie van AMS:

/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

Het ideaal houden

Enterprise Linux heeft patchcycli voor het Apache Webserver Package (httpd).

Hoe minder geïnstalleerde standaardbestanden u hoe beter verandert, omdat als er oplossingen voor patches of configuratieverbeteringen zijn toegepast via de opdracht RPM/Yum, de correcties niet boven op een gewijzigd bestand worden toegepast.

In plaats daarvan wordt een .rpmnew -bestand gemaakt naast het origineel.  Dit betekent u sommige veranderingen zult missen u zou kunnen gewild en meer huisvuil in uw configuratiemappen tot stand gebracht hebben.

d.w.z. RPM tijdens updateinstallatie zal httpd.conf bekijken als het in de unaltered staat is het ** het dossier zal vervangen en u zult de vitale updates krijgen. Als httpd.conf altered toen was zal het niet het dossier vervangen en in plaats daarvan zal het een verwijzingsdossier genoemd httpd.conf.rpmnew creëren en de vele gewenste moeilijke situaties zullen in dat dossier zijn dat niet op de dienstopstarten van toepassing is.

Enterprise Linux is op de juiste wijze ingesteld om deze gebruikszaak op een betere manier te verwerken.  U krijgt gebieden waarin u de standaardinstellingen die u voor u instelt, kunt uitbreiden of overschrijven.  In de basisinstallatie van httpd vindt u het bestand /etc/httpd/conf/httpd.conf en bevat het de volgende syntaxis:

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

Apache wil dat u de modules en configuraties uitbreidt bij het toevoegen van nieuwe bestanden aan de mappen /etc/httpd/conf.d/ en /etc/httpd/conf.modules.d/ met de bestandsextensie .conf .

Als perfect voorbeeld bij het toevoegen van de Dispatcher-module aan Apache maakt u een module .so -bestand in /etc/httpd/modules/ en neemt u dit bestand op door een bestand in /etc/httpd/conf.modules.d/02-dispatcher.conf toe te voegen met de inhoud om het module .so -bestand te laden

LoadModule dispatcher_module modules/mod_dispatcher.so

Nu verbruiken wij onze module in ons dossier /etc/httpd/conf.d/dispatcher_vhost.conf dat onze module initialiseert en het aanvankelijke module-specifieke configuratiedossier laadt

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

Ook hier zult u zien dat we bestanden en modules hebben toegevoegd, maar geen originele bestanden hebben gewijzigd.  Dit geeft ons de gewenste functionaliteit en beschermt ons tegen ontbrekende gezochte flardmoeilijke situaties evenals het houden aan het hoogste niveau van verenigbaarheid met elke verbetering van het pakket.

Volgende -> Uitleg van configuratiebestanden