Vytvoření prostředku Web PubSub
Požadavky
- Účet Azure s aktivním předplatným. Pokud ho ještě nemáte, vytvořte si bezplatný účet Azure.
Tip
Web PubSub obsahuje velkorysou úroveň Free, kterou lze použít k testování a produkčním účelům.
Vytvoření prostředku z webu Azure Portal
Vyberte tlačítko Nový v levém horním rohu portálu Azure Portal. Na obrazovce Nový zadejte do vyhledávacího pole Web PubSub a stiskněte Enter.
Ve výsledcích hledání vyberte Web PubSub a pak vyberte Vytvořit.
Zadejte následující nastavení.
Nastavení Navrhovaná hodnota Popis Název prostředku Globálně jedinečný název Globálně jedinečný název, který identifikuje novou instanci služby Web PubSub. Platné znaky jsou a-z
,A-Z
,0-9
a-
.Předplatné Vaše předplatné Předplatné Azure, ve kterém se vytvoří tato nová instance služby Web PubSub. [Skupina prostředků] myResourceGroup Název nové skupiny prostředků, ve které chcete vytvořit instanci služby Web PubSub. Místo USA – západ Zvolte oblast ve své blízkosti. Cenová úroveň Bezplatný Službu Azure Web PubSub si můžete vyzkoušet zdarma. Další informace o cenových úrovních služby Azure Web PubSub Počet jednotek - Počet jednotek určuje, kolik připojení může instance služby Web PubSub přijmout. Každá jednotka podporuje maximálně 1 000 souběžných připojení. To lze nakonfigurovat jen na úrovni Standard. Vyberte Vytvořit a zřiďte prostředek Web PubSub.
Vytvoření prostředku pomocí Azure CLI
Azure CLI je sada příkazů sloužících k vytváření a správě prostředků Azure Rozhraní příkazového řádku Azure je k dispozici napříč službami Azure a je navržené tak, aby vám umožnilo rychle pracovat s Azure, a to s důrazem na automatizaci.
Důležité
Tento rychlý start vyžaduje Azure CLI verze 2.22.0 nebo vyšší.
Vytvoření skupiny zdrojů
Skupina prostředků je logický kontejner, ve kterém se nasazují a spravují prostředky Azure. Pomocí příkazu az group create vytvořte skupinu prostředků s názvem myResourceGroup
v eastus
umístění.
az group create --name myResourceGroup --location EastUS
Vytvoření prostředku
Spuštěním příkazu az extension add nainstalujte nebo upgradujte rozšíření webpubsub na aktuální verzi.
az extension add --upgrade --name webpubsub
Pomocí příkazu az webpubsub az webpubsub vytvořte web pubSub ve skupině prostředků, kterou jste vytvořili. Následující příkaz vytvoří prostředek Free Web PubSub ve skupině prostředků myResourceGroup v eastUS:
Důležité
Každý prostředek Web PubSub musí mít jedinečný název. V následujících příkladech nahraďte <název_prostředku-unique-resource názvem> podsítě Web PubSub.
az webpubsub create --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --location "EastUS" --sku Free_F1
Výstup tohoto příkazu zobrazuje vlastnosti nově vytvořeného prostředku. Poznamenejte si hodnoty dvou vlastností uvedených níže:
- Název prostředku: Název, který jste zadali výše uvedenému parametru
--name
. - hostName: V příkladu je
<your-unique-resource-name>.webpubsub.azure.com/
název hostitele .
V tuto chvíli je váš účet Azure jediným autorizovaným k provádění jakýchkoli operací s tímto novým prostředkem.
Vytvoření prostředku pomocí šablony Bicep
Bicep je jazyk specifický pro doménu (DSL), který k nasazování prostředků Azure používá deklarativní syntaxi. Poskytuje stručnou syntaxi, spolehlivou bezpečnost typů a podporu pro opakované použití kódu. Bicep nabízí nejlepší prostředí pro vytváření obsahu pro řešení infrastruktury jako kódu v Azure.
Kontrola souboru Bicep
Šablona použitá v tomto rychlém startu je jednou z šablon pro rychlý start Azure.
/* This Bicep file deploys a new instance of Azure Web PubSub service. */
// Parameters
@description('The name for your new Web PubSub instance.')
@maxLength(63)
@minLength(3)
param wpsName string = uniqueString(resourceGroup().id)
@description('The region in which to create the new instance, defaults to the same location as the resource group.')
param location string = resourceGroup().location
@description('Unit count')
@allowed([
1
2
5
10
20
50
100
])
param unitCount int = 1
@description('SKU name')
@allowed([
'Standard_S1'
'Free_F1'
])
param sku string = 'Free_F1'
@description('Pricing tier')
@allowed([
'Free'
'Standard'
])
param pricingTier string = 'Free'
// Resource definition
resource webpubsub 'Microsoft.SignalRService/webPubSub@2021-10-01' = {
name: wpsName
location: location
sku: {
capacity: unitCount
name: sku
tier: pricingTier
}
identity: {
type: 'None'
}
properties: {
disableAadAuth: false
disableLocalAuth: false
liveTraceConfiguration: {
categories: [
{
enabled: 'false'
name: 'ConnectivityLogs'
}
{
enabled: 'false'
name: 'MessagingLogs'
}
]
enabled: 'false'
}
networkACLs: {
defaultAction: 'Deny'
publicNetwork: {
allow: [
'ServerConnection'
'ClientConnection'
'RESTAPI'
'Trace'
]
}
}
publicNetworkAccess: 'Enabled'
resourceLogConfiguration: {
categories: [
{
enabled: 'true'
name: 'ConnectivityLogs'
}
{
enabled: 'true'
name: 'MessagingLogs'
}
]
}
tls: {
clientCertEnabled: false
}
}
}
Nasazení souboru Bicep
Uložte soubor Bicep jako main.bicep do místního počítače.
Nasaďte soubor Bicep pomocí Azure CLI nebo Azure PowerShellu.
az group create --name exampleRG --location eastus az deployment group create --resource-group exampleRG --template-file main.bicep
Po dokončení nasazení by se měla zobrazit zpráva, že nasazení bylo úspěšné.
Kontrola nasazených prostředků
Pomocí webu Azure Portal, Azure CLI nebo Azure PowerShellu můžete zobrazit seznam nasazených prostředků ve skupině prostředků.
az resource list --resource-group exampleRG
Vyčištění prostředků
Pokud už ji nepotřebujete, odstraňte skupinu prostředků a její prostředky pomocí webu Azure Portal, Azure CLI nebo Azure PowerShellu.
az group delete --name exampleRG
Další krok
Teď, když jste vytvořili prostředek, jste připraveni ho použít. Dále se dozvíte, jak odebírat a publikovat zprávy mezi klienty.