対象:✔️ Front Door(クラシック) ✔️ Microsoft(クラシック)のCDN標準
Azure Front Door(classic)またはCDN StandardからMicrosoft(classic)からAzure Front Door StandardまたはPremiumへ移行した後、DevOpsパイプラインスクリプトを更新して新しいFront Door StandardまたはPremiumリソースを展開・管理してください。 以下のガイダンスを様々なツールやパイプラインタイプに適用してください。
テラフォーム
[前提条件]
- Terraform CLI がインストールされていることを確認します。 「Terraform のインストール」を参照してください。
- 既存の Azure リソースを Terraform テンプレートにエクスポートするために、Terraform 用の Azure Resource Manager エクスポート拡張機能をインストールします。 「Azure Export for Terraform の概要」を参照してください。
ステップス
移行後、すべてのクラシックAzure Front DoorリソースはAzure Front Door StandardおよびPremiumに移行されます。 その後、以下を実行します。
- 新しいAzure Front Door StandardまたはPremium構成をエクスポートする:Azureのエクスポートツールを使って、新しいFront Door StandardまたはPremiumリソースのTerraform構成を生成してください。 クイックスタートに従う:Azure Export for Terraformを使って最初のリソースをエクスポートし、Front DoorのStandardまたはPremiumリソースをTerraformファイルにエクスポートしてください。
-
パイプライン内のTerraformテンプレートを更新:Front Doorクラシックリソースへの参照をエクスポートしたStandardまたはPremium構成に置き換えてください。
- Azure Front Door(クラシック)では、Terraformリソースは
azurerm_frontdoorです。 - MicrosoftのCDN Standard(classic)では、
azurerm_cdn_*リソースを活用してください。 - スタンダードまたはプレミアム(AFDx)Azure Front Doorは、
azurerm_cdn_frontdoor_*リソースを活用してください。
- Azure Front Door(クラシック)では、Terraformリソースは
- 更新されたTerraformコードをパイプラインに入力し、プランを実行して新しいフロントドアの管理をTerraform経由で始めましょう。
ARM テンプレート
ステップス
移行後、すべてのクラシックAzure Front DoorリソースはAzure Front Door StandardおよびPremiumに移行されます。
- 以下のいずれかの方法を用いて、Front Door Standard/Premium用のARMテンプレートをエクスポートします:
- Azure portal: Azure portal でテンプレートをエクスポートします。
- Azure CLI: Azure CLI でテンプレートをエクスポートします。
- Azure PowerShell: Azure PowerShell でテンプレートをエクスポートします。
- パイプライン内のARMテンプレートを、 Front Door(クラシック)テンプレートの代わりに新しいFront Door Standard/Premiumテンプレートを使うように更新してください。 Azure DevOpsやGitHub Actionsで、デプロイステップでテンプレートパスとパラメータを更新し、新しいテンプレートをデプロイしてください。
- 検証する: 混乱を避けるために、クラシック Front Door テンプレートへの参照を削除またはアーカイブします。
Bicep
[前提条件]
- Bicep CLI およびツールをインストールします。 Bicep の開発環境とデプロイ環境の設定に関するページを参照してください。
ステップス
移行後、すべてのクラシックAzure Front DoorリソースはAzure Front Door StandardおよびPremiumに移行されます。
- エクスポートされた ARM テンプレートを逆コンパイルして、Front Door Standard/Premium 用の Bicep テンプレートを生成します。 「ARM テンプレート JSON を Bicep に逆コンパイルする」を参照してください。
-
パイプライン内のBicepファイルを更新してください:Front Door(クラシック)の定義をStandard/Premiumに置き換えてください。 この代替には、
Microsoft.Cdn/profilesリソースや子リソース(エンドポイントやルートなど)などのリソースタイプの更新が含まれる場合があります。 -
テスト デプロイ (たとえば、
az deployment group create) を行い、Azure Front Door Standard または Premium のプロビジョニングを確認します。
PowerShell
[前提条件]
最新のAzure PowerShell Azモジュール(Azure Front Door StandardまたはPremiumをサポートするAz.Cdnモジュールバージョン)をインストールしていることを確認してください。 「Azure PowerShell をインストールする」を参照してください。
ステップス
- PowerShell deployment scriptsを更新してください:Azure Front Door (classic) cmdletをAzure Front Door StandardまたはPremium cmdletに置き換えてください。 例については、Azure Front Door PowerShell のクイックスタートを参照してください。
- 新しい設定を取り入れ、古い参照を削除:スクリプトが必要なコンポーネント(オリジン、オリジングループ、ルート、ルールなど)を構成していることを確認しましょう。 Azure Front Door (classic)を管理するコマンドを削除またはコメントしてください。
- コマンド グループ マッピング:
- Az.Cdn module下にあるAzFrontDoorCdnコマンドはAzure Front Door StandardまたはPremium用です。
- Az.Cdnモジュール内のAzCdnコマンドは、Microsoft(classic)のCDN標準用です。
- Az.FrontDoorモジュールはAzure Front Door(classic)用です。
- スクリプトを(ローカルまたはテストパイプライン内で)テストして、Azure Front Door StandardやPremiumの作成や更新を確認し、その後パイプラインに変更をコミットしてください。
CLI
[前提条件]
- Azure CLI がインストールされ、
afdコマンド グループをサポートするバージョン (例: 2.63.0 以降) に更新されていることを確認します。 Azure CLI のインストールに関するページを参照してください。 - ログイン (
az login) し、適切なサブスクリプション コンテキストを設定します。
ステップス
-
スクリプトで CLI コマンドを更新する: 次の Azure Front Door Standard/Premium コマンド グループを使用します:
az afd。 -
Front Door(クラシック)CLIの使用を置き換えまたは削除する:
- Microsoft(classic)のCDN標準コマンド:
az cdn - Azure Front Door (classic) コマンド:
az network front-door
- Microsoft(classic)のCDN標準コマンド:
- 更新された CLI スクリプトを手動で、またはステージング パイプラインで検証して、Front Door Standard/Premium が正常に構成されたことを確認します。