練習 - 使用 Azure CLI 建立事件中樞

已完成

您現在可以開始建立新的事件中樞。 使用 Azure CLI 命令建立之後，您可以使用 Azure 入口網站來檢視新的中樞。

建立事件中樞命名空間

使用右側的 Azure CLI 與 Azure Cloud Shell 中的 Bash，建立事件中樞命名空間。

1. 在右側的 [Azure Cloud Shell] 視窗中，選取 功能表欄上的 [設定]，然後選取 [前往傳統版]。 此 Learn 課程模組中使用的部分命令僅適用於「傳統」模式。

   

2. 首先，指派可重複使用的預設值，如此一來您就不需要為每個命令輸入這些值。 特別是，讓我們設定 resource group 和 location。 在 Cloud Shell 中輸入下列命令，並隨意將位置值取代為您附近的區域。

   az configure --defaults group="<rgn>[sandbox resource group name]</rgn>" location=westus2  
   

   免費的沙箱可讓您在 Azure 全球區域的一部分區域建立資源。 建立資源時，從下列清單中選取區域：

   • westus2
   • 美國中南部
   • centralus
   • eastus
   • westeurope

   • 東南亞
   • japaneast
   • brazilsouth
   • australiasoutheast
   • centralindia

   提示

   您可以使用 [複製] 按鈕將命令複製到剪貼簿。 要貼上命令，請在 Cloud Shell 終端中，以滑鼠右鍵按一下新行，然後選取 [貼上]，或使用 Shift+Insert 鍵盤快速鍵 (在 macOS 上為 ⌘+V)。

3. 執行下列 Azure CLI 命令來建立事件中樞命名空間，會採用下列參數：

   參數	描述
   --name (必要)	事件中樞命名空間的唯一名稱。 名稱長度必須介於 6-50 個字元之間，開頭必須為字母，結尾必須為字母或數字，且僅能包含字母、數字與連字號。
   --resource-group (必要)	您可以省略此參數，因為它預設為上一個命令所提供的沙箱資源群組。
   --location (選擇性)	您可以省略此參數，因為它預設為上一個命令所提供的位置 (區域)。
   --sku (選擇性)	此參數的預設值為 Standard (若省略)，這是我們所需的值。 此 SKU 可決定連線與取用者閾值。

4. 不過，在執行命令前，請先將命名空間名稱設定為環境變數，以利重複使用。

   NS_NAME=ehubns-$RANDOM
   

5. 現在，當您執行此命令時，系統已為您定義命名空間名稱，且 CLI 命令會協助建立命名空間。

   az eventhubs namespace create --name $NS_NAME
   

   注意

   您的命名空間可能需要一些時間才能建立。 Azure 將會驗證命名空間名稱，若名稱已存在或無效，則 CLI 會傳回不正確的要求。 在此情況下，請重新執行 Bash 命令以設定環境變數，然後重新發出 Azure CLI 命令，以嘗試不同的名稱。

6. 執行下列命令，以擷取命名空間的連接字串與主索引鍵。

   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 命令以建立事件中樞。 此命令需要下列參數。

   參數	描述
   --name (必要)	事件中樞的名稱為環境變數 $HUB_NAME。
   --resource-group (必要)	資源群組擁有者已在環境變數中定義。
   --namespace-name (必要)	事件中樞命名空間為環境變數 $NS_NAME。

   az eventhubs eventhub create --name $HUB_NAME --namespace-name $NS_NAME
   

3. 執行下列 Azure CLI 命令以檢視事件中樞的詳細資料。為此，需要下列參數。

   參數	描述
   --resource-group (必要)	資源群組擁有者已在環境變數中定義。
   --namespace-name (必要)	您建立的命名空間。
   --name (必要)	事件中樞的名稱。

   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」)。

   

摘要

您已建立新的事件中樞，且擁有設定發行者與取用者應用程式所需的所有必要資訊。