パイプラインを使用しない URL リダイレクト pipeline-free-redirects

様々な理由で、組織は 301 （または 302）リダイレクトを引き起こす方法で URL を書き換えます。つまり、ブラウザーは別のページにリダイレクトされます。

次のようなシナリオが考えられます。

AEM as a Cloud Serviceには、クライアントサイドのリダイレクトを実装する いくつかのアプローチがありますが、この記事で説明する方法である、パイプラインを使用しないリダイレクトは、次の場合に適しています。

この機能の中核は、AEM Apache/Dispatcherがパブリッシュリポジトリー内の指定された場所に配置された 1 つ以上の書き換えマップファイルを読み込む（または再読み込む）機能です。 ファイルがそこにどのように配置されるかについては、この機能の範囲外であることに注意が必要ですが、次のいずれかの方法を検討できます。

書き換えマップ rewrite-map

書き換えマップは、デフォルトでは 300 秒ごとに Apache HTTP サーバーによって再読み込み（変更された場合）されます（値は設定可能）。 ファイル形式は、Apache ドキュメントに記載されているプレーンテキストのキー値マップの RewriteMap ファイル形式に従う必要があります。

書き換えマップファイルの場所を指定する managed-rewrite-maps.yaml という名前のファイルを作成し、Cloud Manager フルスタックパイプラインまたは web 階層パイプラインを使用して、1 回デプロイする必要があります。 ファイルは、Dispatcher 設定の src/opt-in フォルダーに作成する必要があります。 必ず フレキシブルモードファイル構造を使用してください。

次のパターンで設定できます。

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

例えば、書き換えマップファイルを配置する方法を選択して、AEMに mysite-redirectmap.txt という名前のアセットとして取り込んで公開する場合は、/content/dam の下にフォルダーを指定できます。

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

次に、rewrites/rewrite.rules や <yourfile>.vhost などの Apache 設定ファイルで、name プロパティによって参照されるマップファイルを設定する必要があります（上記のサンプルでは my.map）。

RewriteMap ディレクティブは、データが sdbm （単純 DBM）形式を使用してデータベース・マネージャ（DBM）ファイル形式で格納されることを示す必要があります。

残りの設定は、redirectmap.txt の形式によって異なります。 最も単純な形式は、以下のサンプルに示すように、元の URL とマッピングされた URL を 1 対 1 でマッピングするものです。

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

考慮事項 considerations

次の点に注意してください。