Dynamic Media を使用した CDN キャッシュの無効化 invalidating-cdn-cache-for-dm-assets
Dynamic Media アセットは、顧客との配信を高速化するために、CDN(コンテンツ配信ネットワーク)によってキャッシュされます。 ただし、これらのアセットを更新する場合に、その変更を Web サイトに即座に反映させたいことがあります。 CDN キャッシュの削除または無効化を行うと、Dynamic Media によって配信されるアセットをすばやく更新できます。 TTL(有効期限)の値(デフォルトは 10 時間)を使用してキャッシュの有効期限が切れるのを待つ代わりに、キャッシュを数分で有効期限切れにするリクエストを Dynamic Media から送信することができます。
Dynamic Media Assets の CDN にキャッシュされたコンテンツを無効にするには:
パート 1/2:CDN 無効化テンプレートの作成
-
ツール > Assets > CDN無効化に移動します。
-
CDN 無効化テンプレートページで、シナリオに応じて次のいずれかのオプションを実行します。
table 0-row-2 1-row-2 2-row-2 シナリオ オプション Dynamic Media Classic を使用して、以前に CDN 無効化テンプレートを作成したことがある。 「テンプレートを作成」テキストフィールドに、テンプレートデータが事前に入力されています。 この場合は、テンプレートを編集するか、次の手順に進みます。 テンプレートを作成する必要がある。 何を入力すればよいか? 「テンプレートを作成」テキストフィールドに、次の例のように、特定の画像 ID ではなく <ID>を参照する画像 URL(画像プリセットまたは修飾子を含む)を入力します。https://my.publishserver.com/is/image/company_name/<ID>?$product$
テンプレートに<ID>だけが含まれる場合は、Dynamic Media がhttps://<publishserver_name>/is/image/<company_name>/<ID>を入力します。ここで、<publishserver_name>はDynamic Media Classic の一般設定で定義されているパブリッシュサーバーの名前です。<company_name>は、この Experience Manager インスタンスに関連付けられている会社ルートの名前で、<ID>は、アセットピッカーで選択した無効化するアセットです。
プリセット/修飾子の post<ID>は、そのまま URL 定義内にコピーされます。テンプレートに基づいて自動形成できるのは
画像(すなわち/is/image)のみです。/is/content/の場合、アセットピッカーを使用してビデオや PDF などのアセットを追加しても、URL は自動生成されません。 代わりに、CDN無効化テンプレートのいずれかでそのようなアセットを指定する必要があります。または、パート 2/2: CDN無効化オプションの設定.
例:
この最初の例では、無効化テンプレートに<ID>と/is/contentのアセット URLが含まれています。 例えば、http://my.publishserver.com:8080/is/content/dms7snapshot/<ID>のようになります。 Dynamic Media は、このパスに基づいて URL を作成し、<ID>は、アセットピッカーを使用して選択された、無効にするアセットとなります。
2 つ目の例では、無効化テンプレートに、/is/contentが用いられ、Web プロパティで使用されるアセットの完全な URL が含まれます(アセットピッカーに依存しません)。 例えば、バックパックがアセット IDであるhttp://my.publishserver.com:8080/is/content/dms7snapshot/backpackとします。
Dynamic Mediaでサポートされているアセット形式は、無効化の対象となります。 ® CDN無効化でサポートされている not のアセットファイルタイプには、PostScript®、Encapsulated PostScript®、Adobe Illustrator、Adobe InDesign、Microsoft、Powerpoint、Microsoft® Excel、Microsoft® Word、およびリッチテキスト形式があります。
・ テンプレートを作成する際は、構文とタイプミスに注意してください。
・ CDN無効化テンプレートは、最大2500文字のテキストを保存できます。
・ CDN無効化テンプレートまたはURLで入力してください パート 2: CDN無効化オプションの設定。
・ CDN無効化テンプレートの各エントリは、それぞれ独自の行にする必要があります。
・次のCDN無効化テンプレートの例は、デモ目的でのみ使用できます。
note NOTE CDN 無効化テンプレートは、最大 2500 文字までのテキストを保存できます。 -
CDN無効化テンプレート ページの右上隅にある「保存」を選択し、「OK」を選択します。
パート 2/2: CDN無効化オプションの設定 -
Experience Manager as a Cloud Service で、ツール/Assets/CDN 無効化を選択します。
-
CDN 無効化 - 詳細追加ページで、CDN を無効にするアセットを選択します。
note NOTE 「CDN でアセット関連の画像プリセットを無効にする」および「テンプレートに基づいて無効にする」をオフにしたままにすると、選択したアセットのベース URL が無効に設定されます。 このオプションは、画像に対してのみ使用します。 table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 オプション 説明 CDN でアセット関連の画像プリセットを無効化する (オプション)このオプションを選択すると、選択したアセットとそれに関連するすべての画像プリセット URL が、キャッシュの無効化のために自動作成されます。
アセットと、それに関連付けられた事前定義のプリセット URL は、無効化のために自動作成されます。 このオプションは、画像アセットに対してのみ機能します。テンプレートに基づいて無効化 (オプション)URL 作成に定義済みのテンプレートのみを使用する場合は、このオプションを選択します。 アセットを追加 アセットピッカーを使用して、無効にするアセットを選択します。 公開済みまたは非公開のアセットを選択できます。
CDN でのキャッシュは、アセットベースではなく URL ベースです。 したがって、Web サイト上での完全な URL を認識しておく必要があります。 これらの URL を決定したら、テンプレートに追加できます。 それから、アセットを選択して追加し、ワンステップで URL を無効にできます。
このオプションは、「CDN でアセット関連の画像プリセットを無効化する」、または「テンプレートに基づいて無効化」、あるいはその両方と組み合わせて使用します。URL を追加 CDN キャッシュを無効にする Dynamic Media セットに、完全な URL パスを手動で追加または貼り付けます。 このオプションは、パート 1の2:CDN無効化テンプレートの作成でCDN無効化テンプレートを作成しておらず、無効化するアセットが少ない場合に使用します。
重要:追加する各URLは、独自の行にする必要があります。
一度に 1000 個までの URL を無効にできます。 「URL を追加」テキストフィールドの URL 数が 1000 を超える場合、「次へ」を選択できません。 その場合、選択したアセットの右側の X を選択するか、手動で追加した URL を選択して、アセットを無効化リストから削除する必要があります。
画像スマート切り抜きの URL は、CDN 無効化テンプレートまたはこの「URL を追加」テキストフィールドのいずれかで指定します。 -
ページの右上隅にある「次へ」を選択します。
-
CDN 無効化 - 確認ページの URL リストボックスに、前の手順で作成した CDN 無効化テンプレートから生成された 1 つまたは複数の URL と、先ほど追加したアセットのリストが表示されます。
例えば、前の手順で示した CDN 無効化テンプレートの例を使用して、
spinsetという名前のアセットを 1 つ追加したとします。 ツール/Assets/CDN 無効化に移動すると、CDN 無効化 - 確認のユーザーインターフェイスで次の 5 つの URL が生成されます。
必要に応じて、URL の右側の X を選択して、URL を無効化プロセスから削除します。
-
ページの右上隅近くにある「送信」を選択して、CDN 無効化プロセスを開始します。
CDN 無効化エラーのトラブルシューティング
いずれの場合も、無効にするバッチ全体が処理されるか、バッチ全体が失敗します。
- Dynamic Media設定が見つかりません。
- Dynamic Media設定を読み取るサービスユーザーの取得中に例外が発生しました。
- URLの形成に使用される公開サーバーまたは会社ルートがDynamic Media設定に見つかりません。
cdnCacheInvalidation API で検証した結果 URL が無効な場合に発生します。