Перемещение экземпляра Azure Digital Twins в другой регион Azure

В этой статье описано, как выполнить полный переход экземпляра Azure Digital Twins в другой регион Azure и скопировать все, что потребуется, чтобы новый экземпляр соответствовал исходному.

Если вам нужно переместить инстанцию Azure Digital Twins из одного региона в другой, текущий процесс заключается в том, чтобы воссоздать ваши ресурсы в новом регионе. После повторного создания ресурсов в новом регионе исходные ресурсы удаляются. В результате вы будете работать с новым экземпляром Azure Digital Twins, который идентичен первому, за исключением расположения.

Предварительные условия

Прежде чем пытаться повторно создать экземпляр Azure Digital Twins, перейдите к компонентам исходного экземпляра, чтобы получить четкое представление обо всех элементах, которые потребуется повторно создать.

Вот несколько вопросов, которые стоит учесть:

• Какие модели загружаются в мой экземпляр? Сколько их?

• Кто такие близнецы в моем случае? Сколько их?

• Какова общая форма графика в моем случае? Сколько отношений?

• Какие конечные точки имеются в моем экземпляре?

• Какие маршруты имеются в моей системе? У них есть фильтры?

• К каким другим службам Azure подключается мой экземпляр? Ниже перечислены распространенные точки интеграции:

  • Сетка событий Azure, Центры событий Azure или Служебная шина Azure
  • Функции Azure
  • Приложения логики Azure
  • Azure Data Explorer (поисковая система данных Azure)
  • Azure Maps
  • Служба подготовки устройств для Центра Интернета вещей Azure

• Какие другие персональные или корпоративные приложения подключены к моему экземпляру?

Эти сведения можно получить с помощью портала Azure, API-интерфейсов и пакетов SDK для Azure Digital Twins, команд интерфейса командной строки Azure Digital Twins или Azure Digital Twins Explorer.

Подготовка путем скачивания элементов графа

В этом разделе описана подготовка к повторному созданию экземпляра, скачав исходные модели, двойники и граф из исходного экземпляра. В этой статье для этой задачи используется обозреватель Azure Digital Twins Explorer.

Скачивайте модели, двойники и графы с помощью Azure Digital Twins Explorer

Сначала откройте Azure Digital Twins Explorer для своего экземпляра Azure Digital Twins на портале Azure. Для этого перейдите к экземпляру Azure Digital Twins на портале, найдите его имя в строке поиска на портале. Затем нажмите кнопку Open Azure Digital Twins Explorer (предварительная версия).

При нажатии этой кнопки откроется окно Azure Digital Twins Explorer, подключенное к этому экземпляру.

Выполните инструкции в Azure Digital Twins Explorer, чтобы экспортировать графы и модели. Следуя этим инструкциям, вы сможете скачать JSON-файл на компьютер, содержащий код для моделей, двойников и связей (включая модели, которые в настоящее время не используются в графе).

Создайте новый экземпляр и повторно заполните его в целевом регионе.

Далее вы завершите "перемещение" экземпляра, создав новый экземпляр в целевом регионе. После этого заполните его данными и компонентами из исходного экземпляра.

Создание нового экземпляра

Сначала создайте новый экземпляр Azure Digital Twins в целевом регионе. Следуйте шагам в Настройка экземпляра и проверка подлинности. Необходимо учитывать следующие особенности.

• Вы можете сохранить одно и то же имя для нового экземпляра, если он находится в другой группе ресурсов. Если необходимо использовать ту же группу ресурсов, в которой находится исходный экземпляр, то новому экземпляру потребуется собственное уникальное имя.
• При появлении запроса на выбор расположения введите новый целевой регион.

После этого вам потребуется имя хоста вашего нового экземпляра, чтобы продолжить его настройку с вашими данными. Если вы не записали имя узла во время установки, выполните следующие инструкции, чтобы получить его на портале Azure.

После этого настройте данные нового экземпляра таким образом, чтобы он был копией исходного.

Отправка моделей, двойников и графов с помощью обозревателя Azure Digital Twins Explorer

В этом разделе вы можете повторно загрузить свои модели, двойники и граф в новый экземпляр. Если в исходном экземпляре отсутствуют модели, графы и двойники или вы не хотите перемещать их в новый экземпляр, перейдите к следующему разделу.

Сначала откройте Azure Digital Twins Explorer для нового экземпляра на портале Azure.

Импортируйте JSON-файл, который был загружен ранее в этой статье, в новую инстанцию. Для этого выполните действия, описанные в инструкции Azure Digital Twins Explorer для импорта файла в Azure Digital Twins Explorer. Эти шаги позволят загрузить все модели, двойники и связи из вашего исходного экземпляра в новый.

Чтобы убедиться, что все успешно отправлено, вернитесь на вкладку графа цифровых двойников и нажмите кнопку Выполнить запрос на панели обозревателя запросов, чтобы запустить запрос по умолчанию, выводящий все двойники и связи в графе. Это действие также обновляет список моделей на панели Модели.

На панели графа цифровых двойников вы должны увидеть граф со всеми двойниками и связями. Вы также должны увидеть список моделей на панели Модели.

Эти обзоры подтверждают, что ваши модели, двойники и граф были повторно загружены в новый экземпляр в целевом регионе.

Повторное создание конечных точек и маршрутов

Если у вас есть конечные точки или маршруты в исходном экземпляре, необходимо повторно создать их в новом экземпляре. В противном случае, если у вас нет конечных точек или маршрутов в исходном экземпляре или вы не хотите перемещать их в новый экземпляр, можно перейти к следующему разделу.

В противном случае выполните действия, описанные в разделе "Создание конечных точек" , а затем создание маршрутов и фильтров. Необходимо учитывать следующие особенности.

• Вам не нужно повторно создавать Event Grid, Event Hubs или ресурс Service Bus, который вы используете для конечной точки. Необходимо воссоздать конечную точку в экземпляре Azure Digital Twins.
• Можно повторно использовать конечные точки и имена маршрутов, так как они относятся к разным экземплярам.
• Не забудьте добавить необходимые фильтры для создаваемых маршрутов.

Повторное связывание подключенных ресурсов

Если у вас есть другие приложения или ресурсы Azure, подключенные к исходному экземпляру Azure Digital Twins, необходимо изменить подключение, чтобы они могли достичь нового экземпляра. Эти ресурсы могут включать другие службы Azure, персональные или корпоративные приложения, настроенные для работы с Azure Digital Twins.

Если у вас нет других ресурсов, подключенных к исходному экземпляру или вы не хотите перемещать их в новый экземпляр, перейдите к следующему разделу.

В противном случае рассмотрите подключенные ресурсы в вашем сценарии. Вам не нужно удалять и повторно создавать подключенные ресурсы. Вместо этого нужно просто изменить точки, в которых они подключаются к экземпляру Azure Digital Twins с помощью имени узла. После этого обновите эти параметры, чтобы использовать имя хоста нового экземпляра вместо исходного.

Конкретные ресурсы, которые необходимо изменить, зависят от выбранного сценария, но далее приведены некоторые общие точки интеграции.

• Функции Azure. Если у вас есть функция Azure, код которой содержит имя узла исходного экземпляра, следует изменить это значение на имя узла нового экземпляра и повторно опубликовать функцию.
• Event Grid, Event Hubs, или Service Bus.
• Logic Apps.
• Azure Data Explorer.
• Azure Maps.
• Служба подготовки устройств к добавлению в Центр Интернета вещей.
• Личные или корпоративные приложения за пределами Azure, такие как клиентское приложение, созданное в разделе Создание кода клиентского приложения, которые подключаются к экземпляру и вызывают API Azure Digital Twins.
• Перерегистрация приложений Microsoft Entra не требуется. Если вы используете регистрацию приложения для подключения к API-интерфейсам Azure Digital Twins, вы можете повторно использовать ту же регистрацию приложения для нового экземпляра.

После завершения этого этапа новый экземпляр в целевом регионе должен быть копией исходного экземпляра.

Проверка успешной передачи

Чтобы убедиться, что новый инстанс настроен правильно, используйте следующие инструменты.

• Портал Azure. Портал хорошо подходит для проверки того, что ваш новый экземпляр существует и находится в правильном целевом регионе. Кроме того, он хорошо подходит для проверки конечных точек и маршрутов, а также подключений к другим службам Azure.
• Команды интерфейса командной строки Azure Digital Twins. Эти команды хороши для проверки существования нового экземпляра и его нахождения в правильном целевом регионе. Они также могут использоваться для проверки данных экземпляра.
• Azure Digital Twins Explorer. Обозреватель Azure Digital Twins Explorer отлично подходит для проверки данных экземпляра, например, моделей, цифровых двойников и графиков.
• Интерфейсы API и пакеты SDK для Azure Digital Twins. Эти ресурсы хорошо подходят для проверки данных экземпляра, например моделей, двойников и графов. Они также хорошо подходят для проверки конечных точек и маршрутов.

Вы также можете попробовать запустить любые пользовательские приложения или сквозные потоки, которые у вас работали с исходным экземпляром, чтобы помочь вам убедиться, что они правильно работают с новым экземпляром.

Очистка исходных ресурсов

Теперь, когда новый экземпляр настроен в целевом регионе и содержит копии данных и подключений исходного экземпляра, исходный экземпляр можно удалить.

Вы можете использовать портал Azure, Azure CLIили API-интерфейсы уровня управления.

Чтобы удалить экземпляр с помощью портала Azure, откройте портал в окне браузера и перейдите к исходному экземпляру Azure Digital Twins, выполнив поиск по имени на панели поиска портала.

Нажмите кнопку Удалить и выполните инструкции на экране, чтобы завершить удаление.