练习 - 使用 Azure CLI 创建事件中心

已完成

现在已准备好新建事件中心。 使用 Azure CLI 命令创建它后,可以使用 Azure 门户查看新中心。

创建事件中心命名空间

我们可以使用右侧 Azure Cloud Shell 中的 Azure CLI 和 Bash 创建一个事件中心命名空间。

  1. 首先,指定可重用的默认值,这样就无需在每个命令中输入这些值。 具体而言,我们来设置“资源组”和“位置”。 在 Cloud Shell 中输入以下命令,并可随时将位置值替换为靠近自己的区域。

    az configure --defaults group=<rgn>[sandbox Resource Group]</rgn> location=westus2  
    

    使用免费沙盒,可以在部分 Azure 全球区域中创建资源。 创建资源时,请从此列表中选择一个区域:

    • 美国西部2
    • 美国中南部
    • 美国中部
    • 美国东部
    • 欧洲西部
    • 亚洲东南部
    • 日本东部
    • 巴西南部
    • 澳大利亚东南部
    • centralindia

    提示

    可以使用“复制”按钮将命令复制到剪贴板。 要粘贴,请右键单击 Cloud Shell 终端中的新行,然后选择“粘贴”,或使用 Shift+Insert 键盘快捷方式(在 macOS 上为 ⌘+V)。

  2. 通过运行以下 Azure CLI 命令创建事件中心命名空间,该命令采用以下参数:

    参数 说明
    -- 名称(必填) 事件中心命名空间的唯一名称。 名称长度必须介于 6 到 50 个字符之间,必须以字母开头,并以字母或数字结尾,而且只能包含字母、数字和连字符。
    -- 资源组(必填) 可以省略此参数,因为它将默认为上一命令提供的沙盒资源组。
    -- 位置(可选) 可以省略此参数,因为它将默认为上一命令提供的位置(区域)。
    --sku(可选) 此参数的默认值(如果省略)为 Standard,这也是我们需要的值。 此 sku 将确定连接和使用阈值。
  3. 但在运行该命令之前,让我们将命名空间名称设置为环境变量,以便我们可以重复使用它。

    NS_NAME=ehubns-$RANDOM
    
  4. 现在,在运行此命令时,已经为你定义了命名空间名称,并且 CLI 命令将会创建它。

    az eventhubs namespace create --name $NS_NAME
    

    注意

    创建命名空间可能需要一些时间。 Azure 会验证命名空间名称,如果名称已存在或无效,CLI 会返回“错误请求”。 在这种情况下,请通过重新运行 Bash 命令来设置环境变量,然后重新发出 Azure CLI 命令来尝试使用其他名称。

  5. 通过运行以下命令获取命名空间的连接字符串和主密钥。

    az eventhubs namespace authorization-rule keys list \
        --name RootManageSharedAccessKey \
        --namespace-name $NS_NAME
    

    此命令的输出采用 JSON 格式,并且包含配置发布者和使用者应用程序时所需的详细信息。 保存以下值供以后使用。

    • primaryConnectionString
    • primaryKey

创建事件中心

现在来创建事件中心。

  1. 首先,通过在 Cloud Shell 中运行以下命令将事件中心名称定义为环境变量。

    HUB_NAME=hubname-$RANDOM
    
  2. 现在,运行 Azure CLI 命令来创建事件中心。 此命令需要以下参数。

    参数 说明
    -- 名称(必填) 事件中心的名称为环境变量 $HUB_NAME。
    -- 资源组(必填) 环境变量中已经定义了资源组所有者。
    -- 命名空间名称(必填) 事件中心命名空间为环境变量 $NS_NAME。
    az eventhubs eventhub create --name $HUB_NAME --namespace-name $NS_NAME
    
  3. 通过运行以下 Azure CLI 命令来查看事件中心的详细信息,该命令需要以下参数。

    参数 说明
    -- 资源组(必填) 环境变量中已经定义了资源组所有者。
    -- 命名空间名称(必填) 创建的命名空间。
    -- 名称(必填) 事件中心的名称。
    az eventhubs eventhub show --namespace-name $NS_NAME --name $HUB_NAME
    

在 Azure 门户中查看事件中心

接下来,让我们看一下事件中心在 Azure 门户中的情况。

  1. 使用激活沙盒时所用的同一帐户登录到 Azure 门户

  2. 在门户顶部的搜索栏中,输入“事件中心”,然后按 Enter。 此时将显示订阅的“事件中心”窗格。

  3. 在事件中心命名空间列表中,查找命名空间。 由于我们已将命名空间指定为环境变量 ehubns-RANDOM,因此查找 ehubns-NNNNN。 选择该文件夹。 此时将显示事件中心命名空间的“概述”页面。

  4. 在中间菜单窗格的“实体”下,选择“事件中心”。 此时将显示“事件中心”窗格,其中列出了命名空间中的事件中心。

    你的事件中心将会列出,并显示状态(“活动”),以及“消息保持期”(“7 天 [168 小时]”)和“分区计数”(“4 个”)的预期默认值

    Event Hub displayed in the Azure portal.

总结

你已创建新的事件中心,并拥有配置发布者和使用者应用程序所需的全部信息。