Implementera URL-omdirigeringar som är fria från pipeline

Lär dig hur du implementerar URL-omdirigeringar utan pipeline i AEM as a Cloud Service så att marknadsföringsteamet kan hantera omdirigeringarna utan att behöva någon utvecklare.

Det finns flera alternativ för att hantera URL-omdirigeringar i AEM. Mer information finns i URL-omdirigeringar.

I självstudien ligger fokus på att skapa URL-omdirigeringar som nyckelvärdepar i en textfil som Apache RewriteMap och AEM as a Cloud Service-specifik konfiguration används för att läsa in dem i Apache/Dispatcher-modulen.

Förutsättningar

För att kunna genomföra den här självstudiekursen behöver du:

Exempel på självstudiekurser

Vi antar att WKND:s marknadsföringsteam lanserar en ny skidkampanj. De vill skapa korta URL:er för hjälpsidorna och hantera dem själva på samma sätt som de hanterar innehållet. De bestämde sig för att använda metoden URL-omdirigeringar utan pipeline för att hantera URL-omdirigeringarna.

Baserat på marknadsföringsteamets krav är följande URL-omdirigeringar som måste skapas.

Nu ska vi se hur du hanterar dessa URL-omdirigeringar och obligatoriska engångskonfigurationer för Dispatcher i AEM as a Cloud Service.

Hantera URL-omdirigeringar manage-redirects

Om du vill hantera URL-omdirigeringar finns det flera tillgängliga alternativ, så tittar vi närmare på dem.

Textfil i DAM

URL-omdirigeringarna kan hanteras som nyckelvärdepar i en textfil och överföras till AEM Digital Asset Management (DAM).

Ovanstående URL-omdirigeringar kan till exempel sparas i en textfil med namnet skicampaign.txt och överföras till mappen DAM @ /content/dam/wknd/redirects. Efter granskning och godkännande kan marknadsföringsteamet publicera textfilen.

# 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-kommandon - Omdirigeringshanteraren

ACS Commons - Omdirigeringshanteraren innehåller ett användarvänligt gränssnitt för att hantera URL-omdirigeringar.

Marknadsföringsteamet kan till exempel skapa en ny sida för omdirigeringskartor med namnet SkiCampaign och lägga till ovanstående URL-omdirigeringar med fliken Redigera poster . URL-omdirigeringarna är tillgängliga på /etc/acs-commons/redirect-maps/skicampaign/jcr:content.redirectmap.txt.

ACS-kommandon - omdirigeringshanteraren

Alternativt har ACS Commons - Redirect Manager ett användarvänligt gränssnitt för att hantera URL-omdirigeringar.

Marknadsföringsteamet kan till exempel skapa en ny konfiguration med namnet /conf/wknd och lägga till URL-omdirigeringar ovan med knappen + Omdirigeringskonfiguration . URL-omdirigeringarna är tillgängliga på /conf/wknd/settings/redirects.txt.

Konfigurera Dispatcher

Följande Dispatcher-konfigurationer krävs för att läsa in URL-omdirigeringar som en RewriteMap och tillämpa dem på inkommande begäranden.

Aktivera Dispatcher-modulen för flexibelt läge

Kontrollera först att Dispatcher-modulen är aktiverad för flexibelt läge. Förekomsten av filen USE_SOURCES_DIRECTLY i mappen dispatcher/src/opt-in anger att Dispatcher är i flexibelt läge.

Läs in URL-omdirigeringar som RewriteMap

Skapa sedan en ny konfigurationsfil managed-rewrite-maps.yaml i mappen dispatcher/src/opt-in med följande struktur.

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

Under distributionen skapar Dispatcher filen <MAPNAME>.map i mappen /tmp/rewrites.

Använd URL-omdirigeringar på inkommande begäranden

Skapa eller uppdatera slutligen konfigurationsfilen för Apache genom att skriva om den så att den använder ovanstående karta (<MAPNAME>.map). Vi använder till exempel filen rewrite.rules från mappen dispatcher/src/conf.d/rewrites för att tillämpa URL-omdirigeringarna.

...
# 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]
...

Exempelkonfigurationer

Låt oss granska Dispatcher-konfigurationerna för var och en av de URL-omdirigeringsalternativ som nämns ovan.

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]

...

Så här distribuerar du konfigurationerna

Om du vill distribuera konfigurationerna använder du pipeline full-stack eller web tier config i Cloud Manager .

När distributionen är klar är URL-omdirigeringarna aktiva och marknadsföringsteamet kan hantera dem utan att behöva en utvecklare.

Så här testar du URL-omdirigeringar

Låt oss testa URL-omdirigeringarna med webbläsaren eller kommandot curl. Gå till URL:en för /ski/westcoast och verifiera att den omdirigeras till /us/en/adventures/tahoe-skiing.html.

Sammanfattning

I den här självstudiekursen fick du lära dig att hantera URL-omdirigeringar med hjälp av pipelinefria konfigurationer i AEM as a Cloud Service-miljön.

Marknadsföringsteamet kan hantera URL-omdirigeringar som nyckelvärdepar i en textfil och överföra dem till DAM eller använda ACS Commons - Redirect Map Manager eller Redirect Manager. Dispatcher-konfigurationerna uppdateras för att läsa in URL-omdirigeringarna som en RewriteMap och tillämpa dem på inkommande begäranden.

Ytterligare resurser