Azure CLI を使用した Azure Front Door でのキャッシュの削除

有効期限 (TTL) が切れるまで、Azure Front Door によって資産がキャッシュされます。 クライアントから TTL の有効期限が切れた資産に対して要求すると、Azure Front Door により、資産の新しいコピーが取得され、その要求が処理され、キャッシュが更新されます。

ユーザーが常に最新の資産を取得できるようにするには、更新ごとに資産にバージョンを付け、それを新しい URL で発行します。 Azure Front Door は、後続のクライアント要求に対して新しい資産をフェッチします。 場合によっては、更新された資産を強制的に取得するために、すべてのエッジ ノードからキャッシュされたコンテンツを消去する必要があります。 このアクションが役に立つのは、アプリケーションに更新が行われた場合や、誤った情報を修正する必要がある場合です。

前提条件

• Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。

  

• CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。 詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。

  • ローカル インストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、Azure CLI でのサインインに関するページを参照してください。

  • 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。 拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。

  • az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。

• 「Azure Front Door でのキャッシュ」を確認して、キャッシュのしくみを理解します。
• 必ず機能する Azure Front Door プロファイルを用意します。 「Azure Front Door を作成する - CLI」を参照して作成方法を確認してください。

キャッシュの消去を構成する

次の必要なパラメーターを指定して az afd endpoint purge を実行します。

• リソース グループ名
• リソース グループ内の Azure Front Door プロファイル名
• 消去する資産があるエンドポイント
• 消去する資産があるドメインまたはサブドメイン

• 消去するコンテンツのパス。
  • サポートされる形式:
    • 単一パス消去: ファイル拡張子を含む、アセットの完全なパスを指定します (プロトコルとドメインを除く)。例: /pictures/strasbourg.png。
    • ルート ドメインの消去: パスに "/*" を付けてエンドポイントのルートを削除します。

az afd endpoint purge \
    --resource-group myRGFD \
    --profile-name contosoafd \
    --endpoint-name myendpoint \
    --domains www.contoso.com \
    --content-paths '/scripts/*'

Azure Front Door プロファイルのキャッシュの消去では、大文字と小文字が区別されず、クエリ文字列に依存しません。つまり、ある URL を消去すると、そのクエリ文字列のすべてのバリエーションが消去されます。

次のステップ

次は、Azure Front Door プロファイルを作成する方法について学習します。