使用 App Service 建立 SignalR 服務

這個範例指令碼會建立新的 Azure SignalR 服務資源，以供用來將即時內容更新推送給用戶端。 這個指令碼也會新增 Web 應用程式和 App Service 方案來裝載 ASP.NET Core Web 應用程式，以使用 SignalR Service。 Web 應用程式會透過名為 AzureSignalRConnectionString 的「應用程式設定」來設定，以連線至新的 SignalR 服務資源。

如果您沒有 Azure 帳戶，請在開始之前建立 免費帳戶 。

先決條件

• 在 Azure Cloud Shell 中使用 Bash 環境。 如需詳細資訊，請參閱開始使用 Azure Cloud Shell。

  

• 若要在本機執行 CLI 參考命令，請安裝 (部分機器翻譯) Azure CLI。 若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。 如需詳細資訊，請參閱如何在 Docker 容器中執行 Azure CLI。

  • 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。 請遵循您終端機上顯示的步驟，以完成驗證流程。 如需其他登入選項，請參閱 使用 Azure CLI 向 Azure 進行驗證。

  • 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。 如需擴充功能的詳細資訊，請參閱 使用和管理 Azure CLI 的擴充功能。

  • 執行 az version (部分機器翻譯) 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本，請執行 az upgrade。

重要事項

出現在本文中的原始連接字串，僅供示範之用。

連接字串包含應用程式存取 Azure SignalR Service 所需的授權資訊。 連接字串內的存取金鑰類似於您服務的根密碼。 在實際執行環境中，一律要保護您的存取金鑰。 使用 Azure Key Vault 安全地管理及輪替您的連接字串，並使用 Microsoft Entra ID 保護您的連接字串，以及使用 Microsoft Entra ID 來授權存取。

避免將存取金鑰散發給其他使用者、寫入程式碼，或將其以純文字儲存在他人可以存取的位置。 如果您認為金鑰可能已遭盜用，請輪替金鑰。

範例指令碼

啟動 Azure Cloud Shell

Azure Cloud Shell 是免費的互動式 Shell，可讓您用來執行本文中的步驟。 它具有預先安裝和設定的共用 Azure 工具，可與您的帳戶搭配使用。

若要開啟 Cloud Shell，只要選取程式碼區塊右上角的 [試試看] 即可。 您也可以移至 https://shell.azure.com，從另一個瀏覽器索引標籤啟動 Cloud Shell。

當開啟 Cloud Shell 時，請確認已為您的環境選取 Bash。 後續的工作階段將會在 Bash 環境中使用 Azure CLI，請選取 [複製] 以複製程式碼區塊，並將其貼到 Cloud Shell 中，然後按 Enter 鍵加以執行。

登入 Azure

系統會在登入的初始帳戶下自動驗證 Cloud Shell。 使用下列指令碼使用不同的訂用帳戶登入，並將 subscriptionId 取代為您的 Azure 訂用帳戶識別碼。

如果您沒有 Azure 帳戶，請在開始之前建立 免費帳戶 。

subscription="subscriptionId" # Set Azure subscription ID here

az account set -s $subscription # ...or use 'az login'

如需詳細資訊，請參閱設定使用中訂用帳戶 (部分機器翻譯) 或以互動方式登入 (部分機器翻譯)。

執行指令碼

出現在本文中的原始連接字串，僅供示範之用。 在實際執行環境中，一律要保護您的存取金鑰。 使用 Azure Key Vault 安全地管理及輪替您的連接字串，並使用 Microsoft Entra ID 保護您的連接字串，以及使用 Microsoft Entra ID 來授權存取。

# Create a SignalR Service with an App Service

# Variable block
let "randomIdentifier=$RANDOM*$RANDOM"
location="East US"
resourceGroup="msdocs-azure-signalr-rg-$randomIdentifier"
tag="create-signal-service-with-app-service"
signalRSvc="msdocs-signalr-svc-$randomIdentifier"
webApp="msdocs-web-app-signalr-$randomIdentifier"
appSvcPlan="msdocs-app-svc-plan-$randomIdentifier"
signalRSku="Standard_S1"
unitCount="1"
serviceMode="Default"
planSku="Free"

# Create a resource group
echo "Creating $resourceGroup in "$location"..."
az group create --name $resourceGroup --location "$location" --tag $tag

# Create the Azure SignalR Service resource
echo "Creating $signalRSvc"
az signalr create \
  --name $signalRSvc \
  --resource-group $resourceGroup \
  --sku $signalRSku \
  --unit-count $unitCount \
  --service-mode $serviceMode

# Create an App Service plan.
echo "Creating $appSvcPlan"
az appservice plan create --name $appSvcPlan --resource-group $resourceGroup --sku $planSku

# Create the Web App
echo "Creating $webApp"
az webapp create --name $webApp --resource-group $resourceGroup --plan $appSvcPlan

# Get the SignalR primary connection string
primaryConnectionString=$(az signalr key list --name $signalRSvc \
  --resource-group $resourceGroup --query primaryConnectionString -o tsv)
echo $primaryConnectionString

# Add an app setting to the web app for the SignalR connection
az webapp config appsettings set --name $webApp --resource-group $resourceGroup \
  --settings "AzureSignalRConnectionString=$primaryConnectionString"

清除資源

使用下列命令來移除資源群組及所有與其相關聯的資源，除非您持續需要這些資源，則請使用 az group delete 命令。 這其中某些資源可能需要一些時間才能建立和刪除。

az group delete --name $resourceGroup

範例參考

下表中的每個命令都會連結至命令特定的文件。 此指令碼會使用下列命令：

Command	注意
請輸入命令：az group create 來建立群組。	建立用來存放所有資源的資源群組。
az signalr create	建立 Azure SignalR 服務資源。
az signalr key list	列出應用程式在使用 SignalR 推送即時內容更新時，所會使用的金鑰。
az appservice plan create	建立用來裝載 Web 應用程式的 Azure App Service 方案。
az webapp create	使用 App Service 主控方案建立 Azure Web 應用程式。
az webapp config appsettings set	新增 Web 應用程式的應用程式設定。 此應用程式設定會用來儲存 SignalR 連接字串。

後續步驟

如需 Azure CLI 的詳細資訊，請參閱 Azure CLI 文件。

您可以在 Azure SignalR 服務文件中找到其他的 Azure SignalR 服務 CLI 指令碼範例。