オブジェクトキャッシュ

概要

Cloudflareでは、リクエストは各地域にある短時間だけ動く多数のisolateで処理されます。KVはそのすべてから共有されるため、あるリクエストでキャッシュした値を、どこで処理される次のリクエストでも使えます。メモリーのバックエンドは1つのプロセスの中でキャッシュするため、長時間動き続けるNode.jsのサーバーに向いています。

Cloudflare KV

KVアダプターを設定し、KVバインディングを指定します。

import emdash from "emdash/astro";
import { d1, r2, kvCache } from "@emdash-cms/cloudflare";

export default defineConfig({
	integrations: [
		emdash({
			database: d1({ binding: "DB" }),
			storage: r2({ binding: "MEDIA" }),
			objectCache: kvCache({ binding: "CACHE" }),
		}),
	],
});

セットアップ

KVの名前空間を作成し、Wranglerの設定にバインディングを追加します。

npx wrangler kv namespace create CACHE

コマンドを実行すると、名前空間の id が表示されます。kvCache で使ったバインディング名の下に、その id を追加します。

{
  "kv_namespaces": [
    {
      "binding": "CACHE",
      "id": "<namespace-id>"
    }
  ]
}

[[kv_namespaces]]
binding = "CACHE"
id = "<namespace-id>"

オプション

Node.js（メモリー）

メモリーのアダプターは、サーバーのプロセスの中でキャッシュします。外部のサービスは必要ありません。

import emdash, { memoryCache } from "emdash/astro";
import { sqlite } from "emdash/db";

export default defineConfig({
	integrations: [
		emdash({
			database: sqlite({ url: "file:./data.db" }),
			objectCache: memoryCache(),
		}),
	],
});

オプション

キャッシュされるもの

オブジェクトキャッシュの対象は、一般的なページの描画で実行される読み込みです。

• コンテンツの取得：getEmDashCollection、getEmDashEntry、resolveEmDashPath。
• サイト設定、ナビゲーションメニュー、タクソノミーのターム。

管理画面のAPIへのリクエスト、メディアファイル、HTMLのレスポンス全体は、ここでは扱いません。描画したHTMLをエッジでキャッシュする方法は、Cloudflareへのデプロイを参照してください。

オブジェクトキャッシュとHTMLのエッジキャッシュは、別々の問題を解決します。HTMLの層でキャッシュミスになった場合もWorkerは実行されますが、そのときオブジェクトキャッシュがあれば、コンテンツの取得の繰り返しを防げます。HTMLの層でキャッシュヒットした場合は、EmDashはまったく実行されません。

反映までの時間

管理画面またはREST APIでコンテンツを編集すると、影響を受けるキャッシュのエントリーは自動で無効になります。エントリーを作成、更新、公開、削除すると、そのコレクションのキャッシュ済みの取得結果が消去されます。バイラインやタクソノミーのタームを変更すると、それを表示しているエントリーのキャッシュが消去されます。

匿名の訪問者に対しては、各isolateが更新されたエポックを受け取るまで、変更がすべてのisolateに反映されるのに時間がかかります。isolate内のメモリーのバックエンドでは、すぐに反映されます。Workers KVでは、KVのエッジキャッシュの伝播（結果整合性で、最大60秒程度）に、isolate内の revalidate の時間幅（デフォルトは1秒）を足した時間までかかります。revalidate を小さくすると、キャッシュへの読み込みが増える代わりに、isolate内での反映が速くなります。大きくすると、キャッシュを読み込む回数が減ります。

予約公開したコンテンツ

予約公開したエントリーは、公開日時を過ぎると表示されるようになります。キャッシュされたページに、新しく公開された予約公開のエントリーが反映されるのは、そのコレクションに次の変更があったとき、またはキャッシュしたエントリーの defaultTtl が切れたときです。予約公開の時刻どおりに表示されることがサイトにとって重要な場合は、defaultTtl を小さく設定します。