練習 - 使用 Azure CLI 建立事件中樞
您現在可以開始建立新的事件中樞。 使用 Azure CLI 命令建立之後,您可以使用 Azure 入口網站 來檢視新的中樞。
建立事件中樞命名空間
讓我們在右側的 Azure Cloud Shell 中使用 Azure CLI 和 Bash 建立事件中樞命名空間。
首先,讓我們指派可重複使用的預設值,讓您不必使用每個命令來輸入這些值。 特別是,讓我們設定 resource group 和 location。 在 Cloud Shell 中輸入下列命令,並隨意將位置值取代為您附近的區域。
az configure --defaults group=<rgn>[sandbox Resource Group]</rgn> location=westus2
免費的沙箱可讓您在 Azure 全球區域的一部分區域建立資源。 建立資源時,從下列清單中選取區域:
- westus2
- 美國中南部
- centralus
- eastus
- westeurope
- 東南亞
- japaneast
- brazilsouth
- australiasoutheast
- centralindia
提示
您可以使用 [複製] 按鈕將命令複製到剪貼簿。 要貼上命令,請在 Cloud Shell 終端中,以滑鼠右鍵按一下新行,然後選取 [貼上],或使用 Shift+Insert 鍵盤快速鍵 (在 macOS 上為 ⌘+V)。
執行下列 Azure CLI 命令來建立事件中樞命名空間,會採用下列參數:
參數 描述 --name (必要) 事件中樞命名空間的唯一名稱。 名稱長度必須介於 6-50 個字元之間,開頭必須為字母,結尾必須為字母或數字,且僅能包含字母、數字與連字號。 --resource-group (必要) 您可以省略此參數,因為它預設為上一個命令所提供的沙箱資源群組。 --location (選擇性) 您可以省略此參數,因為它預設為上一個命令所提供的位置 (區域)。 --sku (選擇性) 如果省略此參數的預設值為 Standard,這是我們想要的值。 此 SKU 可決定連線與取用者閾值。 不過,在執行命令前,請先將命名空間名稱設定為環境變數,以利重複使用。
NS_NAME=ehubns-$RANDOM
現在,當您執行此命令時,命名空間名稱已經為您定義,而 CLI 命令會建立它。
az eventhubs namespace create --name $NS_NAME
注意
您的命名空間可能需要一些時間才能建立。 Azure 將會驗證命名空間名稱,若名稱已存在或無效,則 CLI 會傳回不正確的要求。 在此情況下,請重新執行 Bash 命令以設定環境變數,然後重新發出 Azure CLI 命令,以嘗試不同的名稱。
執行下列命令,以擷取命名空間的連接字串與主索引鍵。
az eventhubs namespace authorization-rule keys list \ --name RootManageSharedAccessKey \ --namespace-name $NS_NAME
此命令的輸出格式為 JSON 格式,其中包含您在設定發行者和取用者應用程式時所需的詳細數據。 儲存下列值以利後續使用。
- primaryConnectionString
- primaryKey
建立事件中樞
現在,建立您的事件中樞。
首先,讓我們在 Cloud Shell 中執行下列命令,將事件中樞名稱定義為環境變數。
HUB_NAME=hubname-$RANDOM
現在,執行 Azure CLI 命令以建立事件中樞。 此命令需要下列參數。
參數 描述 --name (必要) 事件中樞的名稱是環境變數 $HUB_NAME。 --resource-group (必要) 資源群組擁有者已在環境變數中定義。 --namespace-name (必要) 事件中樞命名空間是環境變數 $NS_NAME。 az eventhubs eventhub create --name $HUB_NAME --namespace-name $NS_NAME
執行下列 Azure CLI 命令以檢視事件中樞的詳細資料。為此,需要下列參數。
參數 描述 --resource-group (必要) 資源群組擁有者已在環境變數中定義。 --namespace-name (必要) 您建立的命名空間。 --name (必要) 事件中樞的名稱。 az eventhubs eventhub show --namespace-name $NS_NAME --name $HUB_NAME
在 Azure 入口網站中檢視事件中樞
接下來,我們要查看事件中樞在 Azure 入口網站中的模樣。
使用啟用沙箱時所用的相同帳戶來登入 Azure 入口網站。
在入口網站頂端的搜尋列中,輸入「事件中樞」,然後按 [Enter]。 隨即出現訂用帳戶的 [事件中樞] 窗格。
在事件中樞命名空間清單中,尋找您的命名空間。 由於我們將命名空間指派為環境變數 ehubns-RANDOM,因此請尋找 ehubns-NNNNN。 選取該連結。 隨即出現事件中樞命名空間的 [概觀] 頁面。
在中間功能表窗格的 [實體] 下,選取 [事件中樞]。 隨即出現 [事件中樞] 窗格,其中包含命名空間中的事件中樞清單。
您的事件中樞會列出,其中顯示狀態 (作用中),以及訊息保留的預期預設值 (7 天 (168 小時)] 和 [數據分割計數] (4)。
摘要
您已建立新的事件中樞,而且您已準備好設定發行者和取用者應用程式所需的所有資訊。