記事の公開後に、一覧と詳細のキャッシュを更新する

公開用にビルドしたサイトを手元で動かし、表示結果の再利用と、記事を公開した後の更新を確かめます。

目次

キャッシュは、一度作った表示結果を保存して再利用する仕組みです。表示のたびに同じ処理を繰り返さずに済みます。ただし、記事を変えた後も古い内容を見せない仕組みが必要です。

記事を公開したら古いキャッシュを使わないようにするには、保存時間と、更新対象を識別するタグを設定します。この実習では「同じHTMLが再利用される」「記事を公開すると新しいHTMLに変わる」の両方を確認します。開発用サーバーでは再利用されないため、公開用のファイルを作るビルドを行い、手元で動かします。

先に用意するもの

写真付き一覧のガイドの「練習用サイトを準備する」まで済ませてください。同じダウンロード教材「週末ノート」を使います。EmDash 1.4.0、Astro 7.4.5、Node.js 24.22.1が対象です。実行確認はmacOSで行いました。Windows向けの入力例はコマンドプロンプト用で、Windows実機では未確認です。

以下のファイル名は、特に断りがなければ教材の weekend-note フォルダーからの場所です。ファイルの内容はVS Codeで編集し、指定された名前で保存します。コマンドはファイルに保存せず、コマンド入力画面へ貼り付けて実行します。どちらも、囲みの前にある説明で作業する場所を確認してください。開発サーバーは weekend-note のコマンド入力画面で npm run dev を実行しておきます。

起動に使った画面は開いたままにします。このあとのコマンドは、別の入力画面で実行します。VS Code左側のファイル一覧で weekend-note フォルダーを右クリックし、**Open in Integrated Terminal(統合ターミナルで開く)**を選ぶと、そのフォルダーを作業場所にした画面を開けます。Windowsでは、パソコンの準備で選んだコマンドプロンプトを使います。

設定値を引くときは、cacheHint と maxAge の指定方法へ。5秒の例で、期限が切れたあとの表示も確かめられます。

1. キャッシュの保存先を設定する

教材の astro.config.mjs は、すでに次の設定になっています。ファイル全体です。

import { defineConfig, memoryCache } from 'astro/config';
import node from '@astrojs/node';
import react from '@astrojs/react';
import publishCheck from 'weekend-publish-check';
import emdash, { local } from 'emdash/astro';
import { sqlite } from 'emdash/db';

export default defineConfig({
  output: 'server',
  adapter: node({ mode: 'standalone' }),
  devToolbar: { enabled: false },
  cache: { provider: memoryCache() },
  integrations: [react(), emdash({
    database: sqlite({ url: 'file:./data.db' }),
    storage: local({ directory: './uploads', baseUrl: '/_emdash/api/media/file' }),
    admin: { siteName: '週末ノート・実習' },
    sandboxRunner: '@emdash-cms/sandbox-workerd/sandbox',
    sandboxed: [publishCheck],
  })],
});

ここでの memoryCache は astro/config から読みます。作ったHTMLを、実行中のNode.jsプログラム(プロセス)が使うメモリーに保存する方式です。サーバーを再起動すれば消えます。複数台やCloudflareへ、そのまま共有される保存先ではありません。

2. 保存時間と更新用の印を付ける

src/pages/cached.astro を確認します。

---
import { getEmDashCollection } from 'emdash';
import Layout from '../layouts/Layout.astro';
const { entries, cacheHint, error } = await getEmDashCollection('posts', { limit: 20 });
if (error) return new Response('記事を読み込めませんでした。', { status: 500 });
if (Astro.cache?.enabled) Astro.cache.set({ ...cacheHint, maxAge: 300 });
const renderedAt = new Date().toISOString();
---
<Layout title="キャッシュを確かめる"><h1>キャッシュ付きの記事一覧</h1>
<p>このHTMLを作った時刻 <time>{renderedAt}</time></p>
<ul>{entries.map(post => <li><a href={`/posts/${post.id}/`}>{post.data.title}</a></li>)}</ul></Layout>

maxAge: 300 は最大300秒という保存時間です。cacheHint には、記事の更新と結び付けるタグが入ります。...cacheHint でその情報を残しつつ保存時間を加えています。実測では、タグだけの指定ではHTMLが再利用されず、保存時間の指定も必要でした。

詳細ページの src/pages/posts/[slug].astro にも、同じ Astro.cache.set({ ...cacheHint, maxAge: 300 }) が入っています。これで一覧と詳細の両方が対象になります。

3. 本番形式で動かす

4350の開発サーバーは起動したままにします。weekend-note のコマンド入力画面で次を実行します。

npm run build
npm start

http://127.0.0.1:4351 の起動表示を確認してください。これは4350とは別のプロセスですが、教材では同じ練習用データベースを読みます。http://127.0.0.1:4351/cached/ を2回開くと「このHTMLを作った時刻」が同じになれば再利用できています。

4. 公開後の無効化を自動で確認する

さらに別のコマンド入力画面を開き、VS Codeのフォルダー直下なら cd weekend-note で移動して、次を実行します。

node scripts/verify-cache.mjs

教材のこのスクリプトは、練習用の記事の名前を一時的に変えて公開し、一覧と詳細の表示が更新されるかを確認して、元の名前へ戻します。開発サーバーから確認用の認証情報を取得しますが、値は表示せずファイルにも保存しません。

「本番ビルド: 再利用されたHTML、公開後の一覧・詳細の更新を確認」と出れば成功です。確認内容は evidence/cache.json に保存されます。変更前の時刻2つが一致し、変更後の時刻が変わっていることを見られます。

記事を公開する命令も、4351側のAPI(プログラム用の操作窓口)へ送っています。 4350から記事を変えても、別のプログラムとして動く4351には、古いキャッシュを使わないようにする通知が届くとは限りません。この違いを避けるため、教材に確認スクリプトを付けています。

うまく更新されない場合・終了するとき

まず、ビルド後に4351を再起動したか、maxAge と cacheHint の両方があるかを確認します。4350で表示時刻を比べても、このキャッシュの確認にはなりません。

これは公開済みの記事の実習です。個人情報やログインした人だけに見せる内容を、同じ条件で共有キャッシュへ保存しないでください。

終わるときは、npm startを実行した画面でControl + Cを押します。開発サーバーも、起動画面が入力待ちに戻っていなければ、その画面でControl + Cを押してください。入力待ちへ戻ったあとも動いている場合は、weekend-noteでnpx astro dev stopを実行します。次回はnpm run devとnpm startをそれぞれ別の入力画面で実行します。コードを変えたら、その前にnpm run buildも必要です。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。