Azure CLI を使用して Azure Front Door でキャッシュを消去する
Azure Front Door は、アセットの Time-to-Live (TTL) が期限切れになるまで、そのアセットをキャッシュします。 クライアントが TTL の期限が切れたアセットを要求すると、Azure Front Door 環境はアセットの更新された最新コピーを取得し、要求に対応して、更新されたキャッシュを格納します。
ベスト プラクティスは、ユーザーが常にアセットの最新コピーを取得するようにすることです。 これを行うには、更新ごとにアセットにバージョンを付け、新しい URL として発行します。 Azure Front Door Standard/Premium では、次のクライアント要求のための新しいアセットが直ちに取得されます。 必要に応じて、すべてのエッジ ノードのキャッシュされたコンテンツを消去し、すべてのエッジ ノードが新しい更新されたアセットを取得するように強制することもできます。 キャッシュされたコンテンツを消去する理由としては、アプリケーションに対して新しい更新を行ったか、正しくない情報を含んでいるアセットを更新する場合が挙げられます。
前提条件
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 プロファイルを設けます。 Front Door を作成する方法については、「Front Door を作成する - CLI」を参照してください。
キャッシュの消去を構成する
次のような必要なパラメーターを入力した後、az afd endpoint purge を実行してキャッシュを消去します。
リソース グループの名前
消去する資産を含むリソース グループ内の Azure Front Door プロファイルの名前
消去する資産を含むエンドポイント
消去する資産を含むドメインまたはサブドメイン
重要
ワイルドカード ドメインのキャッシュの消去はサポートされていません。ワイルドカード ドメインのキャッシュを消去するサブドメインを指定する必要があります。 ワイルドカード ドメインの単一レベルのサブドメインを任意の数追加できます。 たとえば、ワイルドカード ドメイン
*.afdxgatest.azfdtest.xyz
の場合は、contoso.afdxgatest.azfdtest.xyz
またはcart.afdxgatest.azfdtest.xyz
などの形式でサブドメインを追加できます。 詳細については、Azure Front Door のワイルドカード ドメインに関する記事を参照してください。消去するコンテンツへのパス。
- 消去するパスの一覧では、次の形式がサポートされています。
- 1 つのパスの消去: (プロトコルとドメインを除く) アセットの完全なパスをファイル拡張子と共に指定して、個々のアセットを消去します (例: /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 を消去すると、そのすべてのクエリ文字列バリエーションが消去されます。
注意
キャッシュの消去は、ネットワーク全体およびすべてのエッジの場所に反映されるまでに最大 10 分かかる場合があります。
次のステップ
Azure Front Door プロファイルを作成する方法について学習します。