Migración de una instancia de Azure Digital Twins a otra región de Azure

En este artículo se proporcionan instrucciones sobre cómo realizar un traslado completo de una instancia de Azure Digital Twins a otra región de Azure y copiar todo para que la nueva instancia coincida con el original.

Si necesita trasladar la instancia de Azure Digital Twins de una región a otra, el proceso actual consiste en volver a crear los recursos en la región nueva. Una vez que los recursos se vuelven a crear en la nueva región, se eliminan los recursos originales. Al final de este proceso, tiene una nueva instancia de Azure Digital Twins idéntica a la primera, excepto la ubicación actualizada.

Requisitos previos

Antes de volver a crear la instancia de Azure Digital Twins, revise los componentes de la instancia original para obtener una idea clara de todas las piezas que necesita volver a crear.

A continuación enumeramos algunas preguntas que conviene responder:

• ¿Cuáles son los modelos cargados en mi instancia? ¿Cuántos hay?

• ¿Cuáles son los gemelos de mi instancia? ¿Cuántos hay?

• ¿Cuál es la forma general del grafo en mi instancia? ¿Cuántas relaciones hay?

• ¿Qué puntos de conexión tengo en mi instancia?

• ¿Qué rutas tengo en mi instancia? ¿Tienen filtros?

• ¿Dónde la instancia se conecta a otros servicios de Azure? Entre los puntos de integración comunes se incluyen:

  • Azure Event Grid, Azure Event Hubs o Azure Service Bus
  • Funciones de Azure
  • Azure Logic Apps
  • Explorador de Datos de Azure
  • Azure Maps
  • Servicio Azure IoT Hub Device Provisioning

• ¿Qué otras aplicaciones personales o empresariales tengo que conectar a mi instancia?

Para recopilar esta información se pueden usar Azure Portal, las API y los SDK de Azure Digital Twins, los comandos de la CLI de Azure Digital Twins o Azure Digital Twins Explorer.

Preparación mediante la descarga de elementos de grafos

En esta sección, se prepara para volver a crear la instancia descargando los modelos originales, gemelos y grafo de la instancia original. En este artículo se usa Azure Digital Twins Explorer para esta tarea.

Nota:

Es posible que ya tenga en la instancia archivos que contengan los modelos o el grafo. Si es así, no es necesario volver a descargar, solo las partes que faltan o aquello que pueda haber cambiado desde que se cargaron originalmente estos archivos. Por ejemplo, puede que tenga gemelos que se hayan actualizado con nuevos datos.

Descarga de modelos, gemelos y grafos con Azure Digital Twins Explorer

En primer lugar, abra Azure Digital Twins Explorer para la instancia de Azure Digital Twins en Azure Portal. Para hacerlo, vaya a la instancia de Azure Digital Twins en el portal y busque su nombre en la barra de búsquedas. A continuación, seleccione el botón Azure Digital Twins Explorer (versión preliminar).

Al seleccionar este botón se abre una ventana de Azure Digital Twins Explorer conectada a esta instancia.

Siga las instrucciones de Azure Digital Twins Explorer que se indican en Exportación de grafos y modelos. Si sigue estas instrucciones, puede descargar un archivo JSON en la máquina que contiene el código de los modelos, gemelos y relaciones (incluidos los modelos que no se usan actualmente en el gráfico).

Creación y rellenado de una nueva instancia en la región de destino

A continuación, complete el "movimiento" de la instancia mediante la creación de una nueva instancia en la región de destino. A continuación, se rellena con los datos y los componentes de la instancia original.

Cree una nueva instancia de

En primer lugar, crear una instancia de Azure Digital Twins en la región de destino. Siga los pasos que se describen en Configuración de una instancia y autenticación. Tenga en cuenta estas sugerencias:

• Si la nueva instancia está en otro grupo de recursos, puede reutilizar el nombre de la instancia original. Si la nueva instancia está en el mismo grupo de recursos que la instancia original, la nueva instancia necesita su propio nombre distinto.
• Cuando se le solicite una ubicación durante la configuración de la instancia de Azure Digital Twins, escriba la nueva región de destino.

Más adelante, necesita el nombre de host de su nueva instancia para seguir configurarla con sus datos. Si no ha anotado el nombre de host durante la configuración, siga estas instrucciones para obtenerlo ahora desde Azure Portal.

A continuación, configure los datos de la nueva instancia para que sea una copia de la instancia original.

Carga de modelos, gemelos y grafos con Azure Digital Twins Explorer

En esta sección, vuelves a cargar tus modelos, gemelos y el grafo a la nueva instancia. Si no tiene ningún modelo, gemelos o relaciones en la instancia original o no quiere moverlos a la nueva instancia, puede ir directamente a la sección siguiente.

En primer lugar, vaya a Azure Digital Twins Explorer para la nueva instancia desde Azure Portal.

Importe a la instancia nueva el archivo JSON que descargó anteriormente en este artículo. Para obtener instrucciones detalladas, consulte Importación de un archivo a Azure Digital Twins Explorer. Estos pasos le permiten cargar todos los modelos, gemelos y relaciones de la instancia original en la nueva instancia.

Para comprobar que todo se cargó correctamente, abra la pestaña Twin Graph y seleccione el botón Ejecutar consulta en el panel Explorador de consultas para ejecutar la consulta predeterminada que muestra todos los gemelos y relaciones en el gráfico. Esta acción también actualiza la lista de modelos del panel Models (Modelos).

Debería ver el grafo con todos sus gemelos y relaciones en el cuadro Twin Graph (Grafo gemelo). También verá los modelos enumerados en el panel Models (Modelos).

Estas vistas confirman que los modelos, los gemelos y el gráfico se han vuelto a cargar en la nueva instancia en la región de destino.

Nueva creación de puntos de conexión y rutas

Si tiene puntos de conexión o rutas en la instancia original, debe volver a crearlos en la nueva instancia. Si no tiene ningún punto de conexión o rutas en la instancia original o no quiere moverlos a la nueva instancia, puede ir directamente a la sección siguiente.

Para volver a crear puntos de conexión y rutas, siga los pasos descritos en Creación de puntos de conexión y, a continuación, Cree rutas y filtros. Tenga en cuenta estas sugerencias:

• No necesita volver a crear el recurso Event Grid, Event Hubs o Service Bus que usa para el punto de conexión. Solo tiene que volver a crear el punto de conexión en la instancia de Azure Digital Twins.
• Puede reutilizar los nombres de punto de conexión y ruta, ya que se limitan a una instancia diferente.
• Recuerde agregar los filtros necesarios a las rutas que cree.

Volver a vincular los recursos conectados

Si tiene otras aplicaciones o recursos de Azure que están conectados a la instancia original de Azure Digital Twins, debe editar la conexión para que accedan a la nueva instancia en su lugar. Estos recursos pueden incluir otros servicios de Azure, o aplicaciones personales o de empresa que haya configurado para trabajar con Azure Digital Twins.

Si no tiene ningún otro recurso conectado a la instancia original o no desea migrarlos a la nueva instancia, puede ir directamente a la siguiente sección.

Para empezar a volver a vincular los recursos conectados, primero identifique los recursos conectados en su escenario. Normalmente no es necesario eliminar y volver a crear los propios recursos conectados, pero solo tiene que editar los puntos en los que se conectan a una instancia de Azure Digital Twins a través de su nombre de host. Debe actualizar estos puntos para usar el nombre de host de la nueva instancia en lugar de la instancia original.

Los recursos exactos que necesita editar dependen de los detalles de la solución, pero estos son algunos puntos de integración comunes:

• Azure Functions. Si tiene una función de Azure cuyo código incluye el nombre de host de la instancia original, actualice este valor al nombre de host de la nueva instancia y vuelva a publicar la función.
• Event Grid, Event Hubs o Service Bus.
• Logic Apps.
• Azure Data Explorer.
• Azure Maps.
• Servicio de aprovisionamiento de dispositivos de IoT Hub.
• Aplicaciones personales o empresariales fuera de Azure, como la aplicación cliente que se creó en Programación de una aplicación cliente, que se conecta a la instancia y llama a las API de Azure Digital Twins
• Registros de aplicaciones de Microsoft Entra (no es necesario volver a crear). Si usa un registro de aplicaciones para conectarse a las API de Azure Digital Twins, puede volver a usar el mismo registro de aplicaciones con la nueva instancia.

Después de finalizar este paso, la nueva instancia de la región de destino debe ser una copia rellenada de la instancia original.

Comprobación de transferencia correcta

Para comprobar que la nueva instancia se ha configurado correctamente, use las siguientes herramientas:

• Azure Portal. El portal es adecuado para comprobar que la nueva instancia existe y se encuentra en la región de destino correcta. También es conveniente comprobar los puntos de conexión, las rutas y las conexiones a otros servicios de Azure.
• Comandos de la CLI de Azure Digital Twins. Estos comandos son adecuados para comprobar que la nueva instancia existe y se encuentra en la región de destino correcta. También se pueden usar para comprobar los datos de la instancia.
• Azure Digital Twins Explorer. Azure Digital Twins Explorer es adecuado para comprobar los datos de la instancia, como modelos, gemelos y grafos.
• API y SDK de Azure Digital Twins. Estos recursos son adecuados para comprobar los datos de la instancia, como modelos, gemelos y grafos. También lo son para comprobar los puntos de conexión y las rutas.

También puede intentar ejecutar cualquier aplicación personalizada o flujo de un extremo a otro que haya ejecutado con la instancia original, con el fin de ayudarle a comprobar que funcionan correctamente con la nueva instancia.

Limpieza de los recursos de origen

Ahora que la nueva instancia está configurada en la región de destino con una copia de los datos y las conexiones de la instancia original, puede eliminar la instancia original.

Puede usar Azure Portal, la CLI de Azure o las API del plano de control.

Para eliminar la instancia mediante Azure Portal, abra el portal en una ventana del explorador y vaya a la instancia original de Azure Digital Twins; para ello, busque el nombre en la barra de búsqueda del portal.

Seleccione el botón Eliminar y siga las indicaciones para finalizar la eliminación.