Guia de início rápido: criar um hub de notificação usando o Bicep

Artigo
06/14/2024

Os Hubs de Notificação do Azure fornecem um mecanismo de push fácil de usar e dimensionado que permite enviar 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, consulte O que são os Hubs de Notificação do Azure.

O Bicep é uma linguagem específica do domínio que utiliza sintaxe declarativa para implementar recursos do Azure. Fornece sintaxe concisa, segurança de tipos fiá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 guia de 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 não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Revise o arquivo Bicep

O arquivo Bicep usado neste início rápido é de 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:

Implantar o arquivo Bicep

Salve o arquivo Bicep como main.bicep em seu computador local.

Implante o arquivo Bicep usando 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>"

Nota

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

Quando a implantação terminar, você verá uma mensagem indicando que a implantação foi bem-sucedida.

Rever os recursos implementados

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

Clean up resources (Limpar 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 seus recursos.

CLI
PowerShell

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Próximos passos

Para obter um tutorial passo a passo que o orienta pelo processo de criação de um arquivo Bicep, consulte:

Guia de início rápido: criar arquivos Bicep com o Visual Studio Code

Partilhar via