Het uitvoeren van pijpleidingsvrije URL richt

Leer hoe te om pijpleiding-vrije URL uit te voeren richtin AEM as a Cloud Service om het marketing team toe te laten om de omleidingen te beheren zonder een ontwikkelaar te hoeven.

Er zijn veelvoudige opties om URL te beheren richt in AEM, voor meer informatie, zie opnieuw richt URL.

Het leerprogramma concentreert zich bij het creëren van URL richt zich als zeer belangrijk-waardeparen in een tekstdossier zoals Apache RewriteMapopnieuw en gebruikt AEM as a Cloud Service specifieke configuratie om hen in de module Apache/Dispatcher te laden.

Vereisten

U hebt het volgende nodig om deze zelfstudie te voltooien:

Gebruiksscenario voor zelfstudie

Voor het demodoel, laten we veronderstellen dat het WKND marketing team een nieuwe skicampagne lanceert. Ze willen korte URL's maken voor de ski-avontuurpagina's en deze op hun eigen manier beheren, net zoals ze de inhoud beheren. Zij besloten om de pijpleiding-vrije URL te gebruiken herleidtbenadering om URL te beheren opnieuw richt.

Gebaseerd op de vereisten van het marketing team, zijn het volgende URL omleidingen die moeten worden gecreeerd.

Nu, zie hoe te om deze URL te beheren richt en vereiste eenmalig Dispatcher configuraties in de milieu van AEM as a Cloud Service.

URL-omleidingen beheren manage-redirects

Om URL te beheren zijn er veelvoudige beschikbare opties, onderzoeken hen.

Tekstbestand in DAM

De URL-omleidingen kunnen worden beheerd als sleutelwaardeparen in een tekstbestand en worden geüpload naar het DAM (AEM Digital Asset Management).

De bovenstaande URL-omleidingen kunnen bijvoorbeeld worden opgeslagen in een tekstbestand met de naam skicampaign.txt en worden geüpload naar de map DAM @ /content/dam/wknd/redirects . Na revisie en goedkeuring kan het marketingteam het tekstbestand publiceren.

# Ski Campaign Redirects separated by the TAB character
/ski      /us/en/adventures.html
/ski/northamerica  /us/en/adventures/downhill-skiing-wyoming.html
/ski/westcoast   /us/en/adventures/tahoe-skiing.html
/ski/europe          /us/en/adventures/ski-touring-mont-blanc.html

ACS-opdrachten - Kaartbeheer omleiden

ACS Commons - richt de Manager van de Kaartopnieuw om een gebruikersvriendelijke interface om URL te leiden richt.

Bijvoorbeeld, kan het marketing team een nieuwe Redirect genoemde pagina van Kaarten SkiCampaign tot stand brengen en bovengenoemde URL toe leidt opnieuw richt gebruikend geeft Ingangen tabel uit. De URL-omleidingen zijn beschikbaar via /etc/acs-commons/redirect-maps/skicampaign/jcr:content.redirectmap.txt .

ACS-opdrachten - Omleidingsbeheer

Alternatief, verstrekken de ACS Bevelen - Richt Managerook een gebruikersvriendelijke interface om URL te beheren richt.

Bijvoorbeeld, kan het marketing team een nieuwe configuratie tot stand brengen genoemd /conf/wknd en de bovengenoemde omleidingen toevoegen URL gebruikend de + knoop van de Configuratie van de Omleiding. De URL-omleidingen zijn beschikbaar via /conf/wknd/settings/redirects.txt .

De Dispatcher configureren

Als u de URL als een RewriteMap wilt laden en deze wilt toepassen op binnenkomende aanvragen, zijn de volgende Dispatcher-configuraties vereist.

Dispatcher-module inschakelen voor flexibele modus

Eerst, verifieer dat de module van Dispatcher voor flexibele wijze wordt toegelaten. De aanwezigheid van USE_SOURCES_DIRECTLY -bestand in de dispatcher/src/opt-in -map geeft aan dat de Dispatcher zich in de flexibele modus bevindt.

URL-omleidingen laden als RewriteMap

Maak vervolgens een nieuw configuratiebestand managed-rewrite-maps.yaml in de map dispatcher/src/opt-in met de volgende structuur.

maps:
- name: <MAPNAME>.map # e.g. skicampaign.map
    path: <ABSOLUTE_PATH_TO_URL_REDIRECTS_FILE> # e.g. /content/dam/wknd/redirects/skicampaign.txt, /etc/acs-commons/redirect-maps/skicampaign/jcr:content.redirectmap.txt, /conf/wknd/settings/redirects.txt
    wait: false # Optional, default is false, when true, the Apache waits for the map to be loaded before starting
    ttl: 300 # Optional, default is 300 seconds, the reload interval for the map

Tijdens de implementatie maakt de Dispatcher het <MAPNAME>.map -bestand in de map /tmp/rewrites .

URL-omleidingen toepassen op binnenkomende aanvragen

Tot slot creeer of werk het Apache herschrijf configuratiedossier bij om de bovengenoemde kaart (<MAPNAME>.map) te gebruiken. Laten we bijvoorbeeld het bestand rewrite.rules uit de map dispatcher/src/conf.d/rewrites gebruiken om de URL-omleidingen toe te passen.

...
# Use the RewriteMap to define the URL redirects
RewriteMap <MAPALIAS> dbm=sdbm:/tmp/rewrites/<MAPNAME>.map

RewriteCond ${<MAPALIAS>:$1} !=""
RewriteRule ^(.*)$ ${<MAPALIAS>:$1|/} [L,R=301]
...

Voorbeelden van configuraties

Laten wij de configuraties van Dispatcher voor elk van de hierboven vermelde opties van het omleidingsbeheer URL 🔗 herzien.

maps:
- name: skicampaign.map
  path: /content/dam/wknd/redirects/skicampaign.txt

...

# The DAM-managed skicampaign.txt file as skicampaign.map
RewriteMap skicampaign dbm=sdbm:/tmp/rewrites/skicampaign.map

# Apply the RewriteMap for matching request URIs
RewriteCond ${skicampaign:$1} !=""
RewriteRule ^(.*)$ ${skicampaign:$1|/} [L,R=301]

...

maps:
- name: skicampaign.map
  path: /etc/acs-commons/redirect-maps/skicampaign/jcr:content.redirectmap.txt

...

# The Redirect Map Manager-managed skicampaign.map
RewriteMap skicampaign dbm=sdbm:/tmp/rewrites/skicampaign.map

# Apply the RewriteMap for matching request URIs
RewriteCond ${skicampaign:$1} !=""
RewriteRule ^(.*)$ ${skicampaign:$1|/} [L,R=301]

...

maps:
- name: skicampaign.map
  path: /conf/wknd/settings/redirects.txt

...

# The Redirect Manager-managed skicampaign.map
RewriteMap skicampaign dbm=sdbm:/tmp/rewrites/skicampaign.map

# Apply the RewriteMap for matching request URIs
RewriteCond ${skicampaign:$1} !=""
RewriteRule ^(.*)$ ${skicampaign:$1|/} [L,R=301]

...

Hoe te om de configuraties op te stellen

Om de configuraties op te stellen, gebruik de volledig-stapelof 🔗 3} pijpleiding van de Webrij config {in Cloud Manager.

Zodra de plaatsing succesvol is, zijn de omleidingen URL actief en het marketing team kan hen beheren zonder een ontwikkelaar te hebben nodig.

De omleidingen van de URL testen

Test de URL-omleidingen met de browser of de opdracht curl . Open de URL van /ski/westcoast en controleer of deze wordt doorgestuurd naar /us/en/adventures/tahoe-skiing.html .

Samenvatting

In deze zelfstudie hebt u geleerd hoe u URL-omleidingen kunt beheren met behulp van configuraties zonder pijplijn in AEM as a Cloud Service-omgeving.

Het marketingteam kan de URL omleiden als sleutel-waardeparen in een tekstbestand en deze uploaden naar DAM of de ACS-commons - Redirect Map Manager of Redirect Manager gebruiken. De configuraties van Dispatcher worden bijgewerkt om URL te laden herleidt als RewriteMap en hen op de inkomende verzoeken toe te passen.

Aanvullende bronnen