キャッシュルール

リクエスト → エッジサーバー → キャッシュチェック
                            │
                    ┌───────┴───────┐
                    │               │
               キャッシュヒット   キャッシュミス
                    │               │
               キャッシュ済み    オリジンから取得
                コンテンツを返す   レスポンスをキャッシュ
                                  ユーザーに返す

# 完全一致
/images/logo.png

# プレフィックス一致
/static/*

# ワイルドカード一致
/api/*/public

# 正規表現一致 (上級者向け)
^/blog/[0-9]{4}/.*$

{
  "match": {
    "file_extension": ["jpg", "jpeg", "png", "gif", "webp", "css", "js"]
  },
  "action": "cache",
  "ttl": 86400
}

{
  "match": {
    "path": "/search",
    "query_string": {
      "contains": "category"
    }
  }
}

{
  "match": {
    "headers": {
      "Accept": "application/json"
    }
  },
  "action": "bypass"
}

{
  "match": { "path": "/static/*" },
  "action": "cache",
  "ttl": 604800,
  "settings": {
    "browser_ttl": 86400,
    "serve_stale": true
  }
}

{
  "match": { "path": "/api/*" },
  "action": "bypass"
}

{
  "match": { "path": "/assets/*" },
  "action": "override",
  "ttl": 2592000,
  "ignore_origin_headers": true
}

{
  "edge_ttl": 86400,
  "browser_ttl": 3600
}

https://example.com/page?sort=date&page=1
         │            │        │
      スキーム      パス    クエリ文字列

{
  "cache_key": {
    "query_string": {
      "include": ["category", "page"]
    }
  }
}

{
  "cache_key": {
    "headers": ["Accept-Language", "Accept-Encoding"]
  }
}

{
  "cache_key": {
    "cookies": ["session_type", "user_tier"]
  }
}

{
  "serve_stale": {
    "while_revalidate": true,
    "on_error": true,
    "max_stale_age": 86400
  }
}

オリジンエラー (5xx) → 古いコンテンツを提供 → エラーを記録

{
  "match": { "path": "/static/*" },
  "action": "cache",
  "ttl": 86400,
  "respect_origin_headers": false
}

ルール1: /api/* → バイパス (優先度: 1)
ルール2: /api/public/* → キャッシュ (優先度: 2)
ルール3: /* → キャッシュ (優先度: 3)

リクエスト: /api/users → ルール1に一致 → バイパス
リクエスト: /api/public/data → ルール1に一致 → バイパス (ルール2ではありません！)

{
  "name": "静的アセット",
  "match": {
    "file_extension": ["css", "js", "jpg", "png", "gif", "ico", "woff2"]
  },
  "action": "cache",
  "ttl": 2592000,
  "browser_ttl": 86400
}

{
  "name": "APIバイパス",
  "match": { "path": "/api/*" },
  "action": "bypass"
}

{
  "name": "HTMLページ",
  "match": {
    "file_extension": ["html"],
    "path": "/*"
  },
  "action": "cache",
  "ttl": 300,
  "serve_stale": true
}

{
  "name": "バージョン管理アセット",
  "match": {
    "path": "/assets/v*/*"
  },
  "action": "cache",
  "ttl": 31536000,
  "immutable": true
}

# キャッシュステータスを確認
curl -I https://example.com/static/style.css

# レスポンスヘッダー
X-Cache-Status: HIT
Cache-Control: max-age=86400
Age: 3600

# キャッシュルールを一覧表示
curl -X GET https://api.Sudun.com/v1/domains/example.com/cache-rules \
  -H "Authorization: Bearer YOUR_API_KEY"

# キャッシュルールを作成
curl -X POST https://api.yeSudunom/v1/domains/example.com/cache-rules \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "静的アセット",
    "match": {"file_extension": ["css", "js", "png"]},
    "action": "cache",
    "ttl": 86400
  }'