Pipeline-fria URL-omdirigeringar pipeline-free-redirects

Av olika anledningar skriver organisationer om URL:er på ett sätt som orsakar en 301-omdirigering (eller 302), vilket innebär att webbläsaren omdirigeras till en annan sida.

Scenarier:

AEM as a Cloud Service erbjuder flera strategier för att implementera omdirigeringar på serversidan, men den strategi som beskrivs i den här artikeln, omdirigeringar utan pipeline, är ett bra val när:

Kärnan i den här funktionen är möjligheten för AEM Apache/Dispatcher att läsa in (eller ladda om) en eller flera omskrivningsfiler som har placerats på en viss plats i publiceringsdatabasen (så att de kan hämtas från AEM publicering). Det är viktigt att nämna att hur filerna kommer in ligger utanför den här funktionens omfång, men du kan tänka dig någon av följande metoder:

En detaljerad implementeringsguide steg för steg finns i självstudiekursen Implementera URL-omdirigeringar utan pipeline.

Mappen för omskrivning rewrite-map

Omskrivningskartan läses in på nytt (om den ändras) av Apache HTTP-servern var 300:e sekund som standard (värdet är konfigurerbart). Filformatet bör följa det vanliga textnyckelvärdesschemat RewriteMap som beskrivs i Apache-dokumentationen.

En fil med namnet managed-rewrite-maps.yaml ska skapas för att ange platsen för mappningsfilen för omskrivning och den måste distribueras en gång med Cloud Manager fullständiga stackpipeline eller webbskiktspipeline. Filen måste skapas i mappen src/opt-in i din dispatcher-konfiguration. Se till att du använder filstrukturen i det flexibla läget.

Du kan konfigurera den med följande mönster:

maps:
- name: my.map
  path: <path-in-publish-repository>/redirectmap.txt

Om du t.ex. har valt en metod för att montera omskrivningskartan är att importera den i AEM som en resurs med namnet mysite-redirectmap.txt och sedan publicera den, kan du ange en mapp under /content/dam:

maps:
- name: my.map
  path: /content/dam/redirectmaps/mysite-redirectmap.txt

I en Apache-konfigurationsfil som rewrites/rewrite.rules eller <yourfile>.vhost måste du sedan konfigurera den mappningsfil som namnegenskapen refererar till (my.map i exemplet ovan). När mappningsfilen har lästs in sparas den i det lokala lagringsutrymmet för dispatchern på fast plats /tmp/rewrites/.

Direktivet RewriteMap ska ange att data lagras i ett DBM-filformat (Database Manager) med formatet sdbm (simple DBM), och den fullständiga filsökvägen härleds från lagringsplatsens prefix och namnegenskapen.

Resten av konfigurationen beror på formatet för redirectmap.txt. Det enklaste formatet som visas i exemplet nedan är en till en mappning mellan den ursprungliga URL:en och den mappade url

# RewriteMap from managed rewrite maps
RewriteMap map.foo dbm=sdbm:/tmp/rewrites/my.map
RewriteCond ${map.foo:$1} !=""
RewriteRule ^(.*)$ ${map.foo:$1|/} [L,R=301]

Överväganden considerations

Tänk på följande:

Självstudiekurser tutorials