通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Azure PowerShell 将 Azure Front Door（经典）迁移到标准/高级层

  • 项目

重要

Azure Front Door（经典版）将于 2027 年 3 月 31 日停用。 为了避免任何服务中断，请务必在 2027 年 3 月之前将 Azure Front Door（经典版）配置文件迁移到 Azure Front Door 标准层或高级层。 有关详细信息，请参阅 Azure Front Door（经典版）停用。

Azure Front Door 标准和高级层为 Azure 带来了最新的云分发网络功能。 通过增强的安全功能和一体化服务，应用程序内容是安全的，并且更接近使用 Microsoft 全球网络的最终用户。 本文将指导完成迁移过程，以使用 Azure PowerShell 将 Azure Front Door（经典）配置文件移动到标准或高级层配置文件。

先决条件

  • 请查看关于 Front Door 层迁移一文。
  • 确保可以迁移 Front Door（经典）配置文件：
    • Azure Front Door 标准层和高级层要求所有自定义域都使用 HTTPS。 如果你没有自己的证书，可以使用 Azure Front Door 托管的证书。 该证书是免费的，并且无需你自行管理。
    • 在 Azure Front Door 标准或高级配置文件的源组设置中启用会话亲和性。 在 Azure Front Door（经典）中，会话亲和性是在域级别设置的。 作为迁移的一部分，会话亲和性基于 Front Door（经典）配置文件设置。 如果经典配置文件中有两个域共享相同的后端池（原始组），则会话亲和性必须在两个域之间保持一致，才能使迁移验证通过。
  • 最新的 Azure PowerShell 模块（本地安装）或 Azure Cloud Shell。 有关详细信息，请参阅安装和配置 Azure PowerShell。

注意

无需在迁移过程之前或迁移过程中进行任何 DNS 更改。 但是，一旦迁移完成并且流量通过新的 Azure Front Door 配置文件，就需要更新 DNS 记录。 有关详细信息，请参阅更新 DNS 记录。

验证兼容性

  1. 打开 Azure PowerShell 并连接到 Azure 帐户。 有关详细信息，请参阅连接到 Azure PowerShell。

  2. 测试 Azure Front Door（经典）配置文件，看看它是否与迁移兼容。 可以使用 Test-AzFrontDoorCdnProfileMigration 命令来测试配置文件。 将资源组名称和资源 ID 的值替换为自己的值。 使用 Get-AzFrontDoor 获取 Front Door（经典）配置文件的资源 ID。

    替换命令中的以下值：

    • <subscriptionId>：订阅 ID。
    • <resourceGroupName>：Front Door（经典）的资源组名称。
    • <frontdoorClassicName>：Front Door（经典）配置文件的名称。
    Test-AzFrontDoorCdnProfileMigration -ResourceGroupName <resourceGroupName> -ClassicResourceReferenceId /subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/Microsoft.Network/frontdoors/<frontdoorClassicName>

    如果迁移与迁移兼容，则会看到以下输出：

    CanMigrate DefaultSku
---------- ----------
True       Standard_AzureFrontDoor or Premium_AzureFrontDoor

    如果迁移不兼容，则会看到以下输出：

    CanMigrate DefaultSku
---------- ----------
False

准备迁移

注意

  • Azure 政府云中的 Azure Front Door 标准版或高级版目前不支持托管证书。 需要对 Azure 政府云中的 Azure Front Door 标准版或高级版使用 BYOC，或者等待此功能可用。

运行 Start-AzFrontDoorCdnProfilePrepareMigration 命令以准备迁移。 将资源组名称、资源 ID 和配置文件名称的值替换为自己的值。 对于 SkuName，请使用 Standard_AzureFrontDoor 或 Premium_AzureFrontDoor。 SkuName 基于 Test-AzFrontDoorCdnProfileMigration 命令的输出。

替换命令中的以下值：

  • <subscriptionId>：订阅 ID。
  • <resourceGroupName>：Front Door（经典）的资源组名称。
  • <frontdoorClassicName>：Front Door（经典）配置文件的名称。
Start-AzFrontDoorCdnProfilePrepareMigration -ResourceGroupName <resourceGroupName> -ClassicResourceReferenceId /subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/Microsoft.Network/frontdoors/<frontdoorClassicName> -ProfileName myAzureFrontDoor -SkuName Premium_AzureFrontDoor

输出与下面类似：

Starting the parameter validation process.
The parameters have been successfully validated.
Your new Front Door profile is being created. Please wait until the process has finished completely. This may take several minutes.

Your new Front Door profile with the configuration has been successfully created.

Migrate

运行 Enable-AzFrontDoorCdnProfileMigration 命令以迁移 Front Door（经典）。

Enable-AzFrontDoorCdnProfileMigration -ProfileName myAzureFrontDoor -ResourceGroupName myAFDResourceGroup

输出与下面类似：

Start to migrate.
This process will disable your Front Door (classic) profile and move all your traffic and configurations to the new Front Door profile.
Migrate succeeded.

更新 DNS 记录

旧的 Azure Front Door（经典）实例使用与 Azure Front Door 标准版和高级版不同的完全限定域名 (FQDN)。 例如，Azure Front Door（经典）终结点可能是 contoso.azurefd.net，而 Azure Front Door 标准版或高级版终结点可能是 contoso-mdjf2jfgjf82mnzx.z01.azurefd.net。 有关 Azure Front Door 标准版和高级版终结点的详细信息，请参阅 Azure Front Door 中的终结点。

在迁移过程之前或迁移过程中，无需更新 DNS 记录。 Azure Front Door 自动将在 Azure Front Door（经典）终结点上接收的流量发送到 Azure Front Door 标准版或高级版配置文件，而无需进行任何配置更改。

但是，迁移完成后，强烈建议更新 DNS 记录，将流量定向到新 Azure Front Door 标准或高级终结点。 更改 DNS 记录有助于确保你的配置文件在将来继续工作。 DNS 记录中的更改不会导致任何停机。 不需要提前计划此更新，可以在方便的时候安排。

后续步骤