Snabbstart: Använda en ARM-mall för att distribuera Azure SignalR Service
Den här snabbstarten beskriver hur du använder en Azure Resource Manager mall (ARM-mall) för att skapa en Azure SignalR Service. Du kan distribuera Azure SignalR Service via Azure Portal, PowerShell eller CLI.
En ARM-mall är en JSON-fil (JavaScript Object Notation) som definierar infrastrukturen och konfigurationen för ditt projekt. Mallen använder deklarativ syntax. I deklarativ syntax beskriver du din avsedda distribution utan att skriva sekvensen med programmeringskommandon för att skapa den.
Om din miljö uppfyller förhandskraven och du är van att använda ARM-mallar väljer du knappen Distribuera till Azure. Mallen öppnas i Azure Portal när du loggar in.
Förutsättningar
Ett Azure-konto med en aktiv prenumeration. Skapa ett utan kostnad.
Granska mallen
Mallen som används i den här snabbstarten kommer från Azure-snabbstartsmallar.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"name": {
"type": "string",
"defaultValue": "[uniqueString(resourceGroup().id)]",
"metadata": {
"description": "The globally unique name of the SignalR resource to create."
}
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]",
"metadata": {
"description": "Location for the SignalR resource."
}
},
"pricingTier": {
"type": "string",
"defaultValue": "Standard_S1",
"allowedValues": [
"Free_F1",
"Standard_S1"
],
"metadata": {
"description": "The pricing tier of the SignalR resource."
}
},
"capacity": {
"type": "int",
"defaultValue": 1,
"allowedValues": [
1,
2,
5,
10,
20,
50,
100
],
"metadata": {
"description": "The number of SignalR Unit."
}
},
"serviceMode": {
"type": "string",
"defaultValue": "Default",
"allowedValues": [
"Default",
"Serverless",
"Classic"
],
"metadata": {
"description": "Visit https://github.com/Azure/azure-signalr/blob/dev/docs/faq.md#service-mode to understand SignalR Service Mode."
}
},
"enableConnectivityLogs": {
"type": "string",
"defaultValue": "true",
"allowedValues": [
"true",
"false"
]
},
"enableMessagingLogs": {
"type": "string",
"defaultValue": "true",
"allowedValues": [
"true",
"false"
]
},
"enableLiveTrace": {
"type": "string",
"defaultValue": "true",
"allowedValues": [
"true",
"false"
]
},
"allowedOrigins": {
"type": "array",
"defaultValue": [
"https://foo.com",
"https://bar.com"
],
"metadata": {
"description": "Set the list of origins that should be allowed to make cross-origin calls."
}
}
},
"resources": [
{
"type": "Microsoft.SignalRService/SignalR",
"apiVersion": "2020-07-01-preview",
"name": "[parameters('name')]",
"location": "[parameters('location')]",
"sku": {
"capacity": "[parameters('capacity')]",
"name": "[parameters('pricingTier')]"
},
"kind": "SignalR",
"identity": {
"type": "SystemAssigned"
},
"properties": {
"tls": {
"clientCertEnabled": false
},
"features": [
{
"flag": "ServiceMode",
"value": "[parameters('serviceMode')]"
},
{
"flag": "EnableConnectivityLogs",
"value": "[parameters('enableConnectivityLogs')]"
},
{
"flag": "EnableMessagingLogs",
"value": "[parameters('enableMessagingLogs')]"
},
{
"flag": "EnableLiveTrace",
"value": "[parameters('enableLiveTrace')]"
}
],
"cors": {
"allowedOrigins": "[parameters('allowedOrigins')]"
},
"networkACLs": {
"defaultAction": "deny",
"publicNetwork": {
"allow": [
"ClientConnection"
]
},
"privateEndpoints": [
{
"name": "mySignalRService.1fa229cd-bf3f-47f0-8c49-afb36723997e",
"allow": [
"ServerConnection"
]
}
]
},
"upstream": {
"templates": [
{
"categoryPattern": "*",
"eventPattern": "connect,disconnect",
"hubPattern": "*",
"urlTemplate": "https://example.com/chat/api/connect"
}
]
}
}
}
]
}
Mallen definierar en Azure-resurs:
Distribuera mallen
Välj följande länk för att distribuera Azure SignalR Service med arm-mallen i Azure Portal:
På sidan Distribuera en Azure SignalR Service:
Om du vill kan du ändra Prenumeration från standardvärdet.
För Resursgrupp väljer du Skapa ny, anger ett namn för den nya resursgruppen och väljer OK.
Om du har skapat en ny resursgrupp väljer du en Region för resursgruppen.
Om du vill anger du ett nytt Namn och Plats (till exempel eastus2) för Azure SignalR Service. Om du inte anger något namn genereras det automatiskt. Platsen för Azure SignalR Service kan vara samma som eller en annan än regionen för resursgruppen. Om du inte anger en plats anges den till samma region som resursgruppen.
Välj Prisnivå (Free_F1 eller Standard_S1), ange Kapacitet (antal SignalR-enheter) och välj tjänstläget Standard (kräver hubbserver), Serverlös (tillåter inte serveranslutning) eller Klassisk (dirigeras endast till hubbservern om hubben har en serveranslutning). Välj sedan om du vill aktivera anslutningsloggar eller Aktivera meddelandeloggar.
Anteckning
För Free_F1 prisnivån är kapaciteten begränsad till 1 enhet.
Välj Granska + skapa.
Läs villkoren och välj sedan Skapa.
Anteckning
Det kan ta några minuter att slutföra distributionen. Anteckna namnen för Azure SignalR Service resursgruppen, som du använder för att granska de distribuerade resurserna senare.
Granska distribuerade resurser
Följ dessa steg om du vill se en översikt över din Azure SignalR Service:
I Azure Portaldu efter och väljer SignalR.
I listan SignalR väljer du din nya tjänst. Sidan Översikt för den nya Azure SignalR Service visas.
Rensa resurser
När den inte längre behövs tar du bort resursgruppen, vilket tar bort resurserna i resursgruppen.
I Azure Portaldu efter och väljer Resursgrupper.
Välj namnet på resursgruppen i listan med resursgrupper.
På sidan Översikt för resursgruppen väljer du Ta bort resursgrupp.
I bekräftelsedialogrutan skriver du namnet på resursgruppen och väljer sedan Ta bort.
Nästa steg
En stegvis självstudiekurs som vägleder dig genom processen för att skapa en ARM-mall finns i: