Início Rápido: criar um hub de notificação usando o Bicep

Artigo
06/01/2023

Os Hubs de Notificação do Azure fornecem um mecanismo de push expansível e fácil de usar que permite que você envie notificações para qualquer plataforma (iOS, Android, Windows, Kindle etc.) de qualquer back-end (nuvem ou local). Para obter mais informações sobre o serviço, confira O que são os Hubs de Notificação do Azure?.

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.

Este início rápido usa o Bicep para criar um namespace dos Hubs de Notificação do Azure e um hub de notificação chamado MyHub dentro desse namespace.

Pré-requisitos

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Examinar o arquivo Bicep

O arquivo Bicep usado neste guia de início rápido vem dos Modelos de início rápido do Azure.

@description('The name of the Notification Hubs namespace.')
param namespaceName string

@description('The location in which the Notification Hubs resources should be deployed.')
param location string = resourceGroup().location

var hubName = 'MyHub'

resource namespace 'Microsoft.NotificationHubs/namespaces@2017-04-01' = {
  name: namespaceName
  location: location
  sku: {
    name: 'Free'
  }
}

resource notificationHub 'Microsoft.NotificationHubs/namespaces/notificationHubs@2017-04-01' = {
  name: hubName
  location: location
  parent: namespace
  properties: {
  }
}

O arquivo Bicep cria os dois recursos do Azure:

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.

CLI
PowerShell

az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters namespaceName=<namespace-name>

New-AzResourceGroup -Name exampleRG -Location eastus
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -namespaceName "<namespace-name>"

Observação

Substitua <namespace-name> pelo nome do namespace do Hub de Notificações.

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.

CLI
PowerShell

az resource list --resource-group exampleRG

Get-AzResource -ResourceGroupName exampleRG

Limpar os recursos

Quando não precisar mais do aplicativo lógico, use o portal do Azure, a CLI do Azure ou o Azure PowerShell para excluir o grupo de recursos e os respectivos recursos.

CLI
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Próximas etapas

Para obter um tutorial passo a passo que orienta você durante o processo de criação de um arquivo Bicep, confira:

Início Rápido: criar arquivos Bicep com o Visual Studio Code

Compartilhar via