Migración de zonas privadas de Azure DNS heredadas al nuevo modelo de recursosMigrating legacy Azure DNS private zones to new resource model

Durante la versión preliminar pública, las zonas DNS privadas se crearon mediante el recurso "dnszones" con la propiedad "zoneType" establecida en "Private".During public preview, private DNS zones were created using “dnszones” resource with “zoneType” property set to “Private”. Estas zonas no se admitirán después del 31 de diciembre de 2019 y deben migrarse al modelo de recursos de disponibilidad general, que hace uso del tipo de recurso "privateDnsZones" en lugar de "dnszones".Such zones will not be supported after December 31, 2019 and must be migrated to GA resource model which makes use of “privateDnsZones” resource type instead of “dnszones”. El proceso de migración es sencillo y le proporcionaremos un script de PowerShell para automatizar el proceso.The migration process is simple, and we've provided a PowerShell script to automate this process. En esta guía se proporcionan instrucciones paso a paso para migrar las zonas privadas de Azure DNS al nuevo modelo de recursos.This guide provides step by step instruction to migrate your Azure DNS private zones to the new resource model.

Para averiguar los recursos de dnszones que requieren migración, ejecute el comando siguiente en la CLI de Azure.To find out the dnszones resources that require migration; execute the below command in Azure CLI.

az account set --subscription <SubscriptionId>
az network dns zone list --query "[?zoneType=='Private']"

PrerequisitesPrerequisites

Asegúrese de que ha instalado la versión más reciente de Azure PowerShell.Make sure you have installed latest version of Azure PowerShell. Para obtener más información sobre Azure PowerShell (Az) y cómo instalarlo, visite https://docs.microsoft.com/powershell/azure/new-azureps-module-az.For more information on Azure PowerShell (Az) and how to install it visit https://docs.microsoft.com/powershell/azure/new-azureps-module-az

Asegúrese de que ha instalado el módulo Az.PrivateDns para Azure PowerShell.Make sure that you've Az.PrivateDns module for the Azure PowerShell installed. Para instalar este módulo, abra una ventana de PowerShell con privilegios elevados (modo administrativo) y escriba el siguiente comandoTo install this module, open an elevated PowerShell window (Administrative mode) and enter following command

Install-Module -Name Az.PrivateDns

Importante

El proceso de migración está completamente automatizado y no se espera que ocasione tiempo de inactividad.The migration process is fully automated and isn't expected to cause any downtime. Sin embargo, si usa las zonas privadas de Azure DNS (versión preliminar) en un entorno de producción crítico, debe ejecutar el siguiente proceso de migración durante un período de mantenimiento planeado.However, if you're using Azure DNS private zones (preview) in a critical production environment you should execute the following migration process during a planned maintenance time window. Asegúrese de no modificar la configuración ni los conjuntos de registros de las zonas DNS privadas mientras se ejecuta el script de migración.Make sure that you don't modify the configuration or record-sets of a private DNS zones while you're running the migration script.

Instalación del scriptInstalling the script

Abra una ventana de PowerShell con privilegios elevados (modo administrativo) y ejecute el siguiente comandoOpen an elevated PowerShell window (Administrative mode) and run following command

install-script PrivateDnsMigrationScript

Escriba "A" cuando se le pida que instale el script.Enter “A” when prompted to install the script

Instalación del script

También puede obtener la versión más reciente del script de PowerShell manualmente desde https://www.powershellgallery.com/packages/PrivateDnsMigrationScript.You can also manually obtain the latest version of PowerShell script at https://www.powershellgallery.com/packages/PrivateDnsMigrationScript

Importante

El script de migración no debe ejecutarse en Azure Cloud Shell sino en una máquina virtual o en una máquina local conectada a Internet.The migration script must not be run in Azure cloud shell and must be executed in a VM or local machine connected to internet.

Ejecutar el scriptRunning the script

Ejecute el siguiente comando para ejecutar el script.Execute following command to run the script

PrivateDnsMigrationScript.ps1

Ejecutar el script

Escriba el identificador de la suscripción e inicie sesión en Azure.Enter the subscription ID and sign-in to Azure

Se le pedirá que escriba el Id. de suscripción que contiene las zonas DNS privadas que quiere migrar.You’ll be prompted to enter subscription ID containing the private DNS zones that you intend to migrate. Se le pedirá que inicie sesión en su cuenta de Azure.You’ll be asked to sign-in to your Azure account. Complete el inicio de sesión para que el script pueda acceder a los recursos de zona DNS privada en la suscripción.Complete the sign-in so that script can access the private DNS zone resources in the subscription.

Inicio de sesión en Azure

Seleccione las zonas DNS que quiere migrar.Select the DNS zones you want to migrate

El script obtendrá la lista de todas las zonas DNS privadas en la suscripción y le pedirá que confirme cuáles quiere migrar.The script with get the list of all private DNS zones in the subscription and prompt you to confirm which ones you want to migrate. Escriba "A" para migrar todas las zonas DNS privadas.Enter “A” to migrate all private DNS zones. Una vez que haya realizado este paso, el script creará nuevas zonas DNS privadas con el nuevo modelo de recursos y copiará los datos en la nueva zona DNS.Once you execute this step, the script will create new private DNS zones using new resource model and copy the data into the new DSN zone. Este paso no afectará de ninguna forma a las zonas DNS privadas existentes.This step will not alter your existing private DNS zones in anyway.

Seleccionar zonas DNS

Cambio de la resolución DNS a las nuevas zonas DNSSwitching DNS resolution to the new DNS zones

Una vez que se han copiado las zonas y los registros al nuevo modelo de recursos, el script le pedirá que cambie la resolución DNS a las nuevas zonas DNS.Once the zones and records have been copied to the new resource model, the script will prompt you to switch the DNS resolution to new DNS zones. Este paso quita la asociación entre las zonas DNS privadas heredadas y las redes virtuales.This step removes the association between legacy private DNS zones and your virtual networks. Cuando la zona heredada se desvincula de las redes virtuales, las nuevas zonas DNS creadas en el paso anterior automáticamente toman el control de la resolución DNS para esas redes virtuales.When the legacy zone is unlinked from the virtual networks, the new DNS zones created in above step would automatically take over the DNS resolution for those virtual networks.

Seleccione "A" para cambiar la resolución de DNS para todas las redes virtuales.Select ‘A’ to switch the DNS resolution for all virtual networks.

Cambiar la resolución de nombres

Comprobación de la resolución DNSVerify the DNS resolution

Antes de continuar, compruebe que la resolución DNS en las zonas DNS funciona según lo previsto.Before proceeding further, verify that DNS resolution on your DNS zones is working as expected. Puede iniciar sesión en las máquinas virtuales de Azure y enviar una consulta nslookup a las zonas migradas para comprobar que la resolución DNS está funcionando.You can sign-in to your azure VMs and issue nslookup query against the migrated zones to verify that DNS resolution is working.

Verificar la resolución de nombres

Si descubre que las consultas de DNS no se resuelven, espere unos minutos y vuelva a intentar las consultas.If you find that DNS queries aren't resolving, wait for a few minutes and retry the queries. Si las consultas de DNS funcionan según lo previsto, escriba "Y" cuando el script se lo pida para quitar la red virtual de la zona DNS privada.If DNS queries are working as expected, enter ‘Y’ when script prompts you to remove the virtual network from the private DNS zone.

Confirmar resolución de nombres

Importante

Si por cualquier motivo la resolución DNS de las zonas migradas no funciona según lo previsto, escriba "N" en el paso anterior y el script volverá a cambiar la resolución DNS a las zonas heredadas.If because of any reason DNS resolution against the migrated zones isn't working as expected, enter ‘N’ in above step and script will switch the DNS resolution back to legacy zones. Cree una incidencia de soporte técnico y podremos ayudarle con la migración de las zonas DNS.Create a support ticket and we can help you with migration of your DNS zones.

LimpiezaCleanup

Este paso eliminarán las zonas DNS heredadas y solo se debe ejecutar después comprobar que la resolución DNS funciona según lo previsto.This step will delete the legacy DNS zones and should be executed only after you've verified that DNS resolution is working as expected. Se le pedirá que elimine todas las zonas DNS privadas.You’ll be prompted to delete each private DNS zone. Escriba "Y" en cada símbolo del sistema después de comprobar que la resolución DNS para esas zonas funciona correctamente.Enter ‘Y’ at every prompt after verifying that DNS resolution for that zones is working properly.

Limpieza

Actualización de la automatizaciónUpdate Your automation

Si está usando automatización que incluye plantillas, scripts de PowerShell o código personalizado desarrollado con el SDK, debe actualizar la automatización para que use el nuevo modelo de recursos para las zonas DNS privadas.If you're using automation including templates, PowerShell scripts or custom code developed using SDK, you must update your automation to use the new resource model for the private DNS zones. A continuación se incluyen los vínculos a la documentación de los nuevos CLI, PowerShell y SDK de DNS privados.Below are the links to new private DNS CLI/PS/SDK documentation.

Ayuda adicionalNeed further help

Cree una incidencia de soporte técnico si necesita ayuda adicional con el proceso de migración o si por cualquier motivo los pasos enumerados anteriormente no funcionan.Create a support ticket if you need further help with the migration process or because of any reason the above listed steps don't work for you. Incluya el archivo de transcripción generado por el script de PowerShell con su incidencia de soporte técnico.Include the transcript file generated by the PowerShell script with your support ticket.

Pasos siguientesNext steps