URL の外部化 externalizing-urls

AEM の Externalizer は、あらかじめ設定された DNS をプレフィックスとして、リソースパス（例えば /path/to/my/page）をプログラム的に外部の絶対 URL（例えば https://www.mycompany.com/path/to/my/page）に変換できる OSGi サービスです。

AEM as a Cloud Service インスタンスには自分の外部向け URL がわからず、また、場合によってはリンクをリクエストスコープの範囲外で作成する必要があるので、このサービスは、そのような外部 URL を設定して作成するための一元的な場所を提供します。

この記事では、Externalizer サービスの設定方法と使用方法について説明します。サービスの技術的詳細について詳しくは、Javadocsを参照してください。

Externalizer のデフォルトの動作とオーバーライド方法 default-behavior

Externalizer サービスはすぐに使用でき、いくつかのドメイン識別子を、環境用に生成された AEM サービスの URL に一致する絶対 URL プレフィックス（author https://author-p12345-e6789.adobeaemcloud.com や publish https://publish-p12345-e6789.adobeaemcloud.com など）にマップします。これらの各デフォルトドメインのベース URL は、Cloud Manager で定義された環境変数から読み取られます。

参考までに、com.day.cq.commons.impl.ExternalizerImpl.cfg.json のデフォルトの OSGi 設定は実質的に次のとおりです：

{
   "externalizer.domains": [
      "local $[env:AEM_EXTERNALIZER_LOCAL;default=http://localhost:4502]",
      "author $[env:AEM_EXTERNALIZER_AUTHOR;default=http://localhost:4502]",
      "publish $[env:AEM_EXTERNALIZER_PUBLISH;default=http://localhost:4503]",
      "preview $[env:AEM_EXTERNALIZER_PREVIEW;default=http://localhost:4503]"
   ]
}

preview および publish の値をオーバーライドするには、記事 AEM as a Cloud Service 用の OSGi の設定の説明に従って Cloud Manager 環境変数を使用し、事前定義された AEM_CDN_DOMAIN_PUBLISH および AEM_CDN_DOMAIN_PREVIEW 変数を設定します。

Externalizer サービスの設定 configuring-the-externalizer-service

Externalizer サービスでは、プログラムでリソースパスにプレフィックスを付けるために使用可能なドメインを一元的に定義できます。Externalizer サービスは、1 つのドメインを持つアプリケーションにのみ使用してください。

Externalizer サービスのドメインマッピングを定義するには：

Externalizer サービスの使用 using-the-externalizer-service

ここでは、Externalizer サービスの使用方法に関するいくつかの例を紹介します。