失効済みコンテンツの配信

最終更新日 2021-04-21

Fastly では、オリジンサーバーに問題が発生している時、またはオリジンサーバーからの新しいコンテンツの取得に長い時間を要している場合に、失効済みコンテンツを配信するよう設定することができます。例えば、Fastly がオリジンサーバーに連絡できない場合、ユーザーが要求したときに、Fastly の POP はキャッシュされたコンテンツを提供しつづけます。これらの機能は、デフォルトでは有効になっていません。

ヒント

失効済みコンテンツの配信に関する詳細は、失効済みコンテンツと再検証に関するドキュメントをご参照ください。

新しいコンテンツの取得中に古いコンテンツを配信する

コンテンツの種類によっては、生成に時間がかかるものもあります。一度キャッシュされたコンテンツはすぐに配信されますが、最初にアクセスしようとしたユーザーはコンテンツが生成されるのを待たなければなりません。

キャッシング時間のペナルティ

これはコールドキャッシュの場合には避けられないことですが、オブジェクトがキャッシュにあり、 TTL が期限切れになっている時にこのようなことが起こるのであれば、Fastly は新しいコンテンツがバックグラウンドでフェッチされている間、失効済みコンテンツを表示するように設定することができます。

バックグラウンドで新しいコンテンツを取得する

Fastly は、Google Chrome ブラウザへの搭載が検討されている Mark Nottingham 氏の RFC 5861 『HTTP Cache-Control Extensions for Stale Content』で提案された動作をベースにしています。

失効済みの配信を有効にする

注意

すでにカスタム VCL でエラー時の失効済みコンテンツの配信を有効にしている場合、コントロールパネルでこの機能を追加すると、異なる失効済み TTL が設定されます。これを回避するため、Web コントロールパネルでこの機能を有効化する前に stale-if-error ステートメントをカスタム VCL から削除してください。

コントロールパネルを介したエラーで、デフォルト TTL 期間 (43200秒または12時間) での失効済みコンテンツの配信を有効にするには、以下の手順に従ってください。

Fastly コントロールパネルにログインします。
Home ページから、適切なサービスを選択します。検索ボックスで ID、名称、ドメインでの検索が行えます。
Edit configuration ボタンをクリックし、アクティブなバージョンをクローンするオプションを選択します。ドメインページが表示されます。
Settings をクリックします。Settings ページが表示されます。
Serve stale スイッチをオンにすると、デフォルト TTL 期間である43200秒 (12時間) の間、失効済みコンテンツの配信が自動的に有効になります。
Activate ボタンをクリックして設定変更をデプロイします。

手動で失効済みの配信を有効にする

オリジンサーバーからのレスポンスの Cache-Control または Surrogate-Control ヘッダーに stale-while-revalidate または stale-if-error ディレクティブを追加することで、手動で失効済みコンテンツの配信を有効にすることができます。例:

Cache-Control: max-age=600, stale-while-revalidate=30

この例では、一部のコンテンツを10分間キャッシュした後、新しいコンテンツが取得されるまでの間、最大30秒間失効済みコンテンツを配信するようになっています。

同様に、こちらのステートメント:

Surrogate-Control: max-age=3600, stale-if-error=86400

では、キャッシュのコンテンツを1時間 (3600 秒) 毎に更新しますが、オリジンがダウンしている場合は期限切れのコンテンツを1日間 (86400 秒) 表示するようになっています。

また、vcl_fetchにて以下の変数を設定することで、VCL 内からこれらの動作を制御することもできます。。

set beresp.stale_while_revalidate = 30s;

set beresp.stale_if_error = 86400s;

grace によるインタラクション

Stale-if-error は、Varnish の変数 grace と全く同じ働きをするので、この2つの記述は同等です。

set beresp.grace = 86400s;

set beresp.stale_if_error = 86400s;

ただし、VCL に grace のステートメントがある場合は、Cache-Control や Surrogate-Control のレスポンスヘッダー内の stale-if-error ステートメントをオーバーライドします。

ヘッダーや VCL で beresp.stale_if_error を設定するだけでは何の意味もありません。失効済みコンテンツを配信するためには、以下の手順を踏む必要があります。

エラー発生時に失効済みコンテンツを配信する

オリジンサーバーが利用できなくなった場合に、失効済みコンテンツを配信したい場合があります。この手順では、3つのオリジンサーバーの障害のシナリオにて VCL を使って対応するための高度な設定を行います。

Varnish の場合、オリジン/オリジンサーバー障害には3つのケースが考えられます。

ヘルスチェックの失敗により、オリジン/オリジンサーバーに異常があると見なされる。
何らかの理由で Varnish がオリジン/オリジンサーバーに接続できない場合、503エラーが発生する。
オリジンからの HTTP レスポンスが、ユーザーへの配信に適さない内容である (503エラーなど)。

下記のカスタム VCL はこれら3種類のケースすべてに対応します。オリジンのヘルスステータスが異常の場合、デフォルトサーバーの執行済み動作がstale-if-errorによって開始されます。オリジン/オリジンサーバー障害の発生からオリジンのヘルスステータスが異常と見なされるまでの間、Varnish は通常503 エラーを返します。カスタム VCL を使用することで、失効済みのコピーがある場合には、代わりに失効済みを配信するか、シンセティックエラーページを返すことができます。エラーページはカスタマイズすることができます。3つ目のケースでは、vcl_fetch での 5XX エラーを遮断し、失効済みコンテンツを配信するか、シンセティックエラーページを配信することで対応することができます。

警告

503 エラーが発生している場合、キャッシュされたコンテンツに対する全コンテンツのパージの実行は避けてください。全コンテンツのパージを行うと stale-if-error が機能しなくなるため、オリジンサーバーへのリクエスト数が増加します。その結果、503 エラーがさらに増える可能性があります。

必須ではありませんが、この VCL と一緒にヘルスチェック機能を有効にしてください。ヘルスチェックを有効にしていない場合でもすべての機能は動作しますが、失効済みのレスポンスやシンセティックレスポンスの配信には、オリジンのタイムアウトを待たなくてはいけないため、より長い時間がかかります。ヘルスチェックを有効にすると、オリジンが不健全であるとマークされるため、この問題は回避されます。

以下のカスタム VCL は、Fastly 標準のボイラープレートを含んでいます。お客様のサービスにアップロードする前に、必要に合わせて以下の値をカスタマイズまたは削除してください。

if (beresp.status >= 500 && beresp.status < 600) は、失効済みコンテンツやシンセティックレスポンスを配信すべき HTTP レスポンスコードを含むように変更する必要があります。
set beresp.stale_if_error = 86400s; は、失効済みコンテンツが配信される期間を制御します。この値は、設定に応じて適切な値に設定する必要があります。オリジンから Surrogate-Control または Cache-Control にて stale_if_error を送信している場合は、この行全体を削除します。
set beresp.stale_while_revalidate = 60s;これは、オブジェクトstale_while_revalidateに対して機能が有効になる時間を制御するもので、設定に意味のある量に設定する必要があります。この機能により、Varnish はキャッシュミスの際に執行済みとなり、バックグラウンドでオリジンから最新バージョンのオブジェクトを取得するようになります。これにより、TTL の短いオブジェクトや、一般的なキャッシュミスの際に、大きなパフォーマンスの向上が期待できます。 stale_while_revalidateは、 stale_if_errorによって上書きされるので注意してください。つまり、オブジェクトが再検証中に失効済み（キャッシュしてからTTLに設定された時間が経過した）状態で配信される資格がある限り、stale_if_error の効果はありません。オリジンから Surrogate-Control または Cache-Control にて stale_while_revalidate を送信している場合は、この行全体を削除します。
synthetic {"<!DOCTYPE html>Your HTML!</html>"}; は、失効済みバージョンのオブジェクトが存在しない場合に Varnish が返すシンセティックレスポンスであり、設定に応じて適切に設定する必要があります。ここには、お客様の HTML、CSS、JS を埋め込むことができます。外部の CSS や JS ドキュメントを参照する際には注意が必要です。オリジンがオフラインの場合は、それらも利用できない可能性があります。

1sub vcl_recv {
2  /* if shielding is enabled, the below code is required */
3  if (fastly.ff.visits_this_service != 0) {
4    set req.max_stale_while_revalidate = 0s;
5  }
6
7#FASTLY recv
8
9  if (req.method != "HEAD" && req.method != "GET" && req.method != "FASTLYPURGE") {
10    return(pass);
11  }
12
13  return(lookup);
14}
15
16sub vcl_fetch {
17  /* handle 5XX (or any other unwanted status code) */
18  if (beresp.status >= 500 && beresp.status < 600) {
19
20    /* deliver stale if the object is available */
21    if (stale.exists) {
22      return(deliver_stale);
23    }
24
25    if (req.restarts < 1 && (req.method == "GET" || req.method == "HEAD")) {
26      restart;
27    }
28
29    /* else go to vcl_error to deliver a synthetic */
30    error beresp.status;
31  }
32
33  /* set stale_if_error and stale_while_revalidate (customize these values) */
34  set beresp.stale_if_error = 86400s;
35  set beresp.stale_while_revalidate = 60s;
36
37#FASTLY fetch
38
39  if ((beresp.status == 500 || beresp.status == 503) && req.restarts < 1 && (req.method == "GET" || req.method == "HEAD")) {
40    restart;
41  }
42
43  if (req.restarts > 0) {
44    set beresp.http.Fastly-Restarts = req.restarts;
45  }
46
47  if (beresp.http.Set-Cookie) {
48    set req.http.Fastly-Cachetype = "SETCOOKIE";
49    return(pass);
50  }
51
52  if (beresp.http.Cache-Control ~ "private") {
53    set req.http.Fastly-Cachetype = "PRIVATE";
54    return(pass);
55  }
56
57  /* this code will never be run, commented out for clarity */
58  /* if (beresp.status == 500 || beresp.status == 503) {
59     set req.http.Fastly-Cachetype = "ERROR";
60     set beresp.ttl = 1s;
61     set beresp.grace = 5s;
62     return(deliver);
63  } */
64
65  if (beresp.http.Expires || beresp.http.Surrogate-Control ~ "max-age" || beresp.http.Cache-Control ~ "(s-maxage|max-age)") {
66    # keep the ttl here
67  } else {
68    # apply the default ttl
69    set beresp.ttl = 3600s;
70  }
71
72  return(deliver);
73}
74
75sub vcl_hit {
76#FASTLY hit
77
78  if (!obj.cacheable) {
79    return(pass);
80  }
81  return(deliver);
82}
83
84sub vcl_miss {
85#FASTLY miss
86  return(fetch);
87}
88
89sub vcl_deliver {
90
91#FASTLY deliver
92  return(deliver);
93}
94
95sub vcl_error {
96#FASTLY error
97
98  /* handle 503s */
99  if (obj.status >= 500 && obj.status < 600) {
100
101    /* deliver stale object if it is available */
102    if (stale.exists) {
103      return(deliver_stale);
104    }
105
106    /* otherwise, return a synthetic */
107
108    /* include your HTML response here */
109    synthetic {"<!DOCTYPE html><html>Replace this text with the error page you would like to serve to clients if your origin is offline.</html>"};
110    return(deliver);
111  }
112
113}
114
115sub vcl_pass {
116#FASTLY pass
117}
118
119sub vcl_log {
120#FASTLY log
121}