Criar um recurso do Web PubSub
Pré-requisitos
- Uma conta do Azure com uma assinatura ativa. Criar uma conta Azure gratuita, se ainda não tiver uma.
Dica
O Azure Web PubSub inclui um nível gratuito generoso que pode ser usado para fins de teste e produção.
Criar um recurso a partir do portal do Azure
Selecione no botão Novo localizado no canto superior esquerdo do portal do Azure. Na tela Novo, digite Web PubSub na caixa de pesquisa e pressione Enter.
Selecione Web PubSub nos resultados da pesquisa e escolha Criar.
Insira as configurações a seguir.
Configuração Valor sugerido Descrição Nome do recurso Nome globalmente exclusivo O Nome globalmente exclusivo que identifica a nova instância do serviço Azure Web PubSub. Os caracteres válidos são a-z,A-Z,0-9e-.Assinatura Sua assinatura A assinatura do Azure na qual essa nova instância do serviço Azure Web PubSub será criada. [Grupo de Recursos] myResourceGroup Nome do novo grupo de recursos no qual a instância do serviço Azure Web PubSub será criada. Localidade Oeste dos EUA Selecione uma região perto de você. Tipo de preços Grátis Primeiro, você pode experimentar o serviço Azure Web PubSub gratuitamente. Saiba mais detalhes sobre os tipos de preços do serviço Azure Web PubSub Contagem de unidades - A contagem de unidades especifica quantas conexões a instância do serviço Azure Web PubSub pode aceitar. Cada unidade dá suporte a, no máximo, 1.000 conexões simultâneas. Só é configurável na camada Standard. 
Selecione Criar para provisionar seu recurso do Azure Web PubSub.
Criar um recurso usando a CLI do Azure
CLI do Azure é um conjunto de comandos usados para criar e gerenciar recursos do Azure. A CLI do Azure está disponível nos serviços do Azure e foi criada para ajudar você a trabalhar de maneira rápida com o Azure, com ênfase na automação.
Importante
Este guia de início rápido exige a CLI do Azure versão 2.22.0 ou superior.
Criar um grupo de recursos
Um grupo de recursos é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados. Use o comando az group create para criar um grupo de recursos chamado myResourceGroup no local eastus.
az group create --name myResourceGroup --location EastUS
Criar um recurso
Execute az extension add para instalar ou atualizar a extensão webpubsub para a versão atual.
az extension add --upgrade --name webpubsub
Use o comando az webpubsub create da CLI do Azure para criar um Web PubSub no grupo de recursos criado. O seguinte comando cria um recurso gratuito do Web PubSub no grupo de recursos myResourceGroup no EastUS:
Importante
Cada recurso Web PubSub precisa ter um nome exclusivo. Substitua <nome-de recurso-exclusivo> pelo nome do Web PubSub nos exemplos a seguir.
az webpubsub create --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --location "EastUS" --sku Free_F1
A saída deste comando mostra as propriedades do recurso recém-criado. Anote as duas propriedades listadas abaixo:
- Nome do Recurso: o nome que você forneceu ao parâmetro
--nameacima. - hostName: no exemplo, o nome do host é
<your-unique-resource-name>.webpubsub.azure.com/.
Nesse ponto, sua conta do Azure é a única autorizada a executar qualquer operação nesse novo recurso.
Criar um recurso usando modelo do Bicep
O Bicep é um DSL (linguagem específica de domínio) que usa sintaxe declarativa para implantar recursos do Azure. Ele fornece sintaxe concisa, segurança de tipos confiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para suas soluções de infraestrutura como código no Azure.
Examinar o arquivo Bicep
O modelo usado neste início rápido é proveniente dos Modelos de Início Rápido do 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
}
}
}
Implante o arquivo Bicep
Salve o arquivo Bicep como main.bicep em seu computador local.
Para implantar o arquivo Bicep, use a CLI do Azure ou o Azure PowerShell.
az group create --name exampleRG --location eastus az deployment group create --resource-group exampleRG --template-file main.bicep
Quando a implantação for concluída, você deverá ver uma mensagem indicando que ela foi bem-sucedida.
Examinar os recursos implantados
Use o portal do Azure, a CLI do Azure ou o Azure PowerShell para listar os recursos implantados no grupo de recursos.
az resource list --resource-group exampleRG
Limpar os recursos
Quando não for mais necessário, use o portal do Azure, a CLI do Azure ou o Azure PowerShell para excluir o grupo de recursos e seus recursos.
az group delete --name exampleRG
Próxima etapa
Agora que você criou um recurso, você está pronto para colocá-lo em uso. A seguir, você aprenderá como assinar e publicar mensagens entre seus clientes.