キャッシュパージ

速盾网络チーム

キャッシュパージは、Sudunエッジサーバーからキャッシュされたコンテンツを削除し、オリジンから新しいコンテンツを取得するよう強制します。このガイドでは、パージ方法、ベストプラクティス、自動化オプションについて説明します。

キャッシュをパージするタイミング

キャッシュパージが必要となる一般的なシナリオ：

シナリオ	パージタイプ	例
コンテンツ更新	単一URL	ブログ記事の更新
サイトリデザイン	すべてをパージ	新しいCSS/JSのデプロイ
緊急修正	URLまたはタグ	セキュリティパッチ
アセットバージョン変更	プレフィックスパージ	/assets/v2/*

パージ方法

URLによるパージ

キャッシュから特定のURLを削除：

code

https://example.com/blog/post-1
https://example.com/images/hero.jpg
https://example.com/css/styles.css

最適な用途：個別のコンテンツ更新、ターゲットを絞ったキャッシュクリア

プレフィックスによるパージ

パスプレフィックスに一致するすべてのURLを削除：

code

https://example.com/blog/*
https://example.com/images/*
https://example.com/api/v1/*

最適な用途：セクション更新、バージョン管理されたアセットのデプロイ

キャッシュタグによるパージ

関連付けられたタグでコンテンツを削除：

code

Tags: product-123, category-electronics, homepage

最適な用途：動的コンテンツの関連性、CMS統合

すべてをパージ

ドメインのすべてのキャッシュされたコンテンツを削除：

code

Domain: example.com
Action: Purge All

警告：すべてをパージすると、オリジンへのリクエストが急増します。控えめに使用し、可能であればトラフィックの少ない時間帯に実行してください。

ダッシュボードの使用

単一URLのパージ

ドメイン → 対象ドメインを選択
キャッシング → キャッシュパージに移動
URLでパージを選択
パージする完全なURLを入力
パージをクリック

プレフィックスによるパージ

キャッシング → キャッシュパージに移動
プレフィックスでパージを選択
URLプレフィックスを入力（例：https://example.com/blog/）
パージをクリック

すべてをパージ

キャッシュ → キャッシュパージに移動
すべてをパージを選択
ドメイン名を入力して確認
すべてパージをクリック

キャッシュタグ

キャッシュタグを使用すると、正確なURLを知らなくても、コンテンツベースでパージできます。

キャッシュタグの設定

オリジンからのレスポンスヘッダーでタグを追加：

http

Cache-Tag: product-123, category-shoes, homepage

またはSudunで設定：

json

{
  "cache_tags": {
    "rules": [
      {
        "match": { "path": "/products/*" },
        "tags": ["products", "catalog"]
      },
      {
        "match": { "path": "/blog/*" },
        "tags": ["blog", "content"]
      }
    ]
  }
}

タグによるパージ

bash

# タグ "product-123" を持つすべてのコンテンツをパージ
curl -X POST https://api.Sudun.com/v1/domains/example.com/purge \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["product-123"]}'

タグのベストプラクティス

タグタイプ	例	ユースケース
エンティティID	`product-123`	商品更新時のパージ
カテゴリ	`category-electronics`	カテゴリページのパージ
コンテンツタイプ	`blog-posts`	すべてのブログコンテンツのパージ
テンプレート	`template-homepage`	テンプレート変更後のパージ

パージの伝播

パージを開始した後：

code

パージリクエスト → Sudun API → グローバルPoP
                                  │
                          ┌───────┴───────┐
                          │               │
                     ~1-5秒          ~30秒
                     (ほとんどのPoP)   (すべてのPoP)

パージタイプ	典型的な伝播時間
単一URL	1-5秒
プレフィックス	5-15秒
キャッシュタグ	5-15秒
すべて	15-60秒

ソフトパージ vs ハードパージ

ハードパージ（デフォルト）

キャッシュからコンテンツを直ちに削除：

code

キャッシュ状態: MISS
オリジンリクエスト: 必要

ソフトパージ

コンテンツを古いとマークするが、利用可能な状態を維持：

code

キャッシュ状態: STALE
オリジンリクエスト: バックグラウンドでの再検証

ソフトパージの利点:

オリジンサーバーへの過負荷を防止
ユーザーは古いコンテンツを即時に閲覧可能
再検証後に新しいコンテンツが配信

bash

# API経由のソフトパージ
curl -X POST https://api.Sudun.com/v1/domains/example.com/purge \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"urls": ["https://example.com/page"], "soft": true}'

パージ自動化

Webhooks

CMSやデプロイパイプラインからパージをトリガー:

bash

# WordPress例: 投稿更新時にパージ
curl -X POST https://api.Sudun.com/v1/domains/example.com/purge \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"tags": ["post-${POST_ID}"]}'

CI/CD連携

デプロイ後にパージ:

yaml

# GitHub Actions例
- name: CDNキャッシュパージ
  run: |
    curl -X POST https://api.Sudun.com/v1/domains/$DOMAIN/purge \
      -H "Authorization: Bearer $YESudunPI_KEY" \
      -d '{"prefix": "https://$DOMAIN/assets/"}'

スケジュールパージ

自動パージスケジュールを設定:

キャッシュ → スケジュールタスク に移動
スケジュール追加 をクリック
設定:

- 頻度: 毎日、毎週、カスタム

- 時間: トラフィック少ない時間帯を選択

- パージタイプ: プレフィックスまたはタグ

レート制限

システム保護のためパージ操作に制限あり:

プラン	URLパージ/分	プレフィックスパージ/時	全パージ/日
スターター	100	10	5
ビジネス	1,000	50	20
エンタープライズ	10,000	500	無制限

パージ履歴

ダッシュボードでパージ履歴を確認:

キャッシュ → パージ履歴 に移動
日付、タイプ、ステータスでフィルター
詳細を表示:

- タイムスタンプ

- パージタイプ

- 影響を受けたURL/タグ

- 伝播ステータス

- 開始者（ユーザーまたはAPI）

トラブルシューティング

パージ後もコンテンツがキャッシュされる

URL完全一致の確認: パージURLはキャッシュURLと完全一致が必要

```

キャッシュ: https://example.com/page?v=1

パージ: https://example.com/page ← 一致しない!

```

クエリ文字列のバリエーション: キャッシュにクエリ文字列を含む場合、全バリエーションをパージ
ブラウザキャッシュ: ブラウザキャッシュをクリア、またはシークレットモード使用
伝播遅延: グローバル伝播まで30-60秒待機

パージリクエスト失敗

エラー	原因	解決策
401 認証エラー	APIキー無効	API認証情報を確認
403 アクセス拒否	権限不足	アカウントアクセスを確認
429 リクエスト過多	レート制限超過	待機後再試行
400 不正リクエスト	URL形式不正	URL構文を確認

全パージ後のオリジン過負荷

全パージ後にオリジンサーバーが負荷に苦しむ場合:

ハードパージの代わりにソフトパージを使用
低トラフィック時間帯にパージを実行
プレフィックス別の段階的パージを実装
追加保護のためオリジンシールドを有効化

APIリファレンス

URL指定パージ

bash

curl -X POST https://api.Sudun.com/v1/domains/example.com/purge \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://example.com/page1",
      "https://example.com/page2"
    ]
  }'

プレフィックス指定パージ

bash

curl -X POST https://api.Sudun.com/v1/domains/example.com/purge \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"prefix": "https://example.com/blog/"}'

タグ指定パージ

bash

curl -X POST https://api.Sudun.com/v1/domains/example.com/purge \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"tags": ["product-123", "homepage"]}'

全パージ

bash

curl -X POST https://api.Sudun.com/v1/domains/example.com/purge \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"purge_everything": true}'

キャッシュパージでお困りですか？ support@Sudun.com までご連絡ください