将 Azure 事件中心命名空间移到另一个区域

本文介绍如何导出现有事件中心命名空间的 Azure 资源管理器模板,然后使用该模板在另一个区域中创建具有相同配置设置的命名空间。 但是,此过程不会移动尚未处理的事件。 你需要先处理原始命名空间中的事件,然后再将其删除。

如果在包含事件中心命名空间的 Azure 资源组中还有其他资源,则可能需要在资源组级别导出模板,以便可以通过一个步骤将所有相关资源移动到新区域。 本文中的步骤演示如何将命名空间导出到模板。 将资源组导出到模板的步骤类似。

先决条件

  • 确保帐户使用的服务和功能在目标区域中受支持。

  • 如果已为命名空间中的事件中心启用“捕获功能”,请移动 Azure 存储或 Azure Data Lake Store Gen 2。 还可以按照与本文所述步骤类似的步骤,将包含存储和事件中心命名空间的资源组移到另一个区域。

  • 如果事件中心命名空间位于事件中心群集中,则在执行本文中的步骤之前,请将专用群集移到目标区域。 还可以使用 GitHub 上的快速入门模板创建事件中心群集。 在模板中,删除 JSON 的命名空间部分以仅创建群集。

准备

若要开始,请导出资源管理器模板。 此模板包含描述事件中心命名空间的设置。

  1. 登录到 Azure 门户

  2. 选择“所有资源”,然后选择你的事件中心命名空间。

  3. 选择“设置” > “导出模板”。

  4. 选择“导出模板”页中的“下载”。

    下载资源管理器模板

  5. 找到从门户下载的 .zip 文件,并将该文件解压缩到所选的文件夹。

    此 zip 文件包含 .json 文件,后者包括模板和用于部署模板的脚本。

移动

部署模板以在目标区域中创建事件中心命名空间。

  1. 在 Azure 门户中,选择“创建资源”。
  2. 在“搜索市场”中,键入“模板部署”并选择“模板部署(使用自定义模板进行部署)” 。
  3. 选择“在编辑器中生成自己的模板”。
  4. 选择“加载文件”,然后按说明加载在上一部分下载的 template.json 文件。
  5. 更新 location 属性的值以指向新区域。 若要获取位置代码,请参阅 Azure 位置。 区域的代码是不带空格的区域名称,例如 China East 等同于 chinaeast
  6. 选择“保存”以保存该模板。
  7. 在“自定义部署”页上执行以下步骤:
    1. 选择 Azure 订阅。
    2. 选择现有的 资源组 或创建一个资源组。 如果源命名空间位于事件中心群集中,请在目标区域中选择包含群集的资源组。
    3. 选择目标位置或区域。 如果选择了现有资源组,则此设置为只读。
    4. 在“设置”部分中,执行以下步骤:
      1. 输入新命名空间名称。

        部署资源管理器模板

      2. 如果源命名空间位于事件中心群集中,请输入资源组和事件中心群集的名称,作为“外部 ID”的一部分。

        /subscriptions/<AZURE SUBSCRIPTION ID>/resourceGroups/<CLUSTER'S RESOURCE GROUP>/providers/Microsoft.EventHub/clusters/<CLUSTER NAME>
        
      3. 如果命名空间中的事件中心使用存储帐户来捕获事件,请为 StorageAccounts_<original storage account name>_external 字段指定资源组名称和存储帐户。

        /subscriptions/0000000000-0000-0000-0000-0000000000000/resourceGroups/<STORAGE'S RESOURCE GROUP>/providers/Microsoft.Storage/storageAccounts/<STORAGE ACCOUNT NAME>
        
    5. 在页面底部选择“查看 + 创建”。
    6. 在“查看 + 创建”页上查看设置,然后选择“创建” 。

丢弃或清理

部署后,如果要重新开始,则可以删除目标事件中心命名空间,并重复执行本文的准备移动部分中所述的步骤。

若要提交更改并完成事件中心命名空间的移动,请删除原始区域中的事件中心命名空间。 请确保在删除命名空间前处理了该命名空间中的所有事件。

若要使用 Azure 门户删除事件中心命名空间(源或目标),请执行以下操作:

  1. 在 Azure 门户顶部的搜索窗口中,键入“事件中心”,然后从搜索结果中选择“事件中心”。 此时会在列表中看到事件中心命名空间。

  2. 选择要删除的目标命名空间,并从工具栏中选择“删除”。

    删除命名空间 - 按钮

  3. 在“删除命名空间”页上,键入命名空间名称,然后选择“删除”以确认删除 。

后续步骤

在本教程中,你已将一个 Azure 事件中心命名空间从一个区域移到了另一个区域,并清理了源资源。 若要详细了解如何在区域之间移动资源,以及如何在 Azure 中进行灾难恢复,请参阅: