Exercício - Usar a CLI do Azure para criar um hub de eventos

  • 10 minutos

Agora, está pronto para criar um novo hub de eventos. Depois de criá-lo com comandos da CLI do Azure, você usa o portal do Azure para exibir seu novo hub.

Criar um espaço de nomes dos Hubs de Eventos

Vamos criar um namespace de Hubs de Eventos usando a CLI do Azure e o Bash no Azure Cloud Shell à direita.

  1. Na janela do Azure Cloud Shell à direita, selecione Configurações na barra de menus e selecione Ir para a versão clássica. Alguns dos comandos usados neste módulo Learn funcionam apenas no modo Clássico.

    Captura de tela mostrando o item de menu para alternar o Azure Cloud Shell para o modo Clássico.

  2. Primeiro, vamos atribuir valores padrão que podem ser reutilizados para que você não precise inserir esses valores com cada comando. Em particular, vamos definir o grupo de recursos e a localização. Digite o seguinte comando no Cloud Shell e sinta-se à vontade para substituir o valor do local por uma região próxima a você.

    az configure --defaults group="<rgn>[sandbox resource group name]</rgn>" location=westus2

    O sandbox gratuito permite-lhe criar recursos num subconjunto das regiões globais do Azure. Selecione uma região desta lista quando criar recursos:

    • westus2
    • E.U.A Centro-Sul
    • centralus
    • eastus
    • westeurope
    • Sudeste Asiático
    • japaneast
    • brazilsouth
    • australiasoutheast
    • centralindia

    Gorjeta

    Pode utilizar o botão Copiar para copiar comandos para a área de transferência. Para colar, clique com o botão direito do mouse em uma nova linha no terminal do Cloud Shell e selecione Colar, ou use o atalho de teclado Shift+Insert (⌘+V no macOS).

  3. Crie o namespace Hubs de Eventos executando o seguinte comando da CLI do Azure, que usa estes parâmetros:

    Parâmetro Description
    --name (obrigatório) Um nome exclusivo para seu namespace de Hubs de Eventos. O nome deve ter de 6 a 50 caracteres, começar com uma letra, terminar com uma letra ou número e conter apenas letras, números e hífenes.
    --resource-group (obrigatório) Esse parâmetro pode ser omitido porque ele assume como padrão o grupo de recursos de área restrita fornecido pelo comando anterior.
    --location (opcional) Esse parâmetro pode ser omitido porque ele usa como padrão o local (região) fornecido pelo comando anterior.
    --sku (opcional) O valor padrão para esse parâmetro, se omitido, é Standard, que é o valor que desejamos. O sku determina as conexões e os limites de consumidor.

  4. Antes de executar o comando, porém, vamos definir o nome do namespace como uma variável de ambiente para que possamos reutilizá-lo.

    NS_NAME=ehubns-$RANDOM

  5. Agora, quando você executa esse comando, o nome do namespace já está definido para você e o comando CLI o cria.

    az eventhubs namespace create --name $NS_NAME

    Nota

    Pode levar algum tempo para que o namespace seja criado. O Azure validará o nome do namespace e, se o nome existir ou for inválido, a CLI retornará Solicitação incorreta. Nesse caso, tente um nome diferente executando novamente o comando Bash para definir a variável de ambiente e, em seguida, emita novamente o comando da CLI do Azure.

  6. Procure a cadeia de conexão e a chave primária para seu namespace executando o seguinte comando.

    az eventhubs namespace authorization-rule keys list \
    --name RootManageSharedAccessKey \
    --namespace-name $NS_NAME

    A saída desse comando está no formato JSON e contém detalhes que você precisa ao configurar seus aplicativos de editor e consumidor. Salve os seguintes valores para uso posterior.

    • primaryConnectionString
    • primaryKey

Criar um hub de eventos

Agora vamos criar seu hub de eventos.

  1. Primeiro, vamos definir o nome do hub de eventos como uma variável de ambiente executando o seguinte comando no Cloud Shell.

    HUB_NAME=hubname-$RANDOM

  2. Agora, execute o comando da CLI do Azure para criar um hub de eventos. Este comando precisa dos seguintes parâmetros.

    Parâmetro Description
    --name (obrigatório) O nome do hub de eventos é a variável de ambiente $HUB_NAME.
    --resource-group (obrigatório) O proprietário do grupo de recursos já está definido em uma variável de ambiente.
    --namespace-name (obrigatório) O namespace Hubs de Eventos é a variável de ambiente $NS_NAME. 
    az eventhubs eventhub create --name $HUB_NAME --namespace-name $NS_NAME

  3. Exiba os detalhes do seu hub de eventos executando o seguinte comando da CLI do Azure, que precisa dos seguintes parâmetros.

    Parâmetro Description
    --resource-group (obrigatório) O proprietário do grupo de recursos já está definido em uma variável de ambiente.
    --namespace-name (obrigatório) O namespace que você criou.
    --name (obrigatório) Nome do hub de eventos. 
    az eventhubs eventhub show --namespace-name $NS_NAME --name $HUB_NAME

Ver o hub de eventos no portal do Azure

Em seguida, vamos ver como é o nosso hub de eventos no portal do Azure.

  1. Inicie sessão no portal do Azure com a mesma conta que utilizou para ativar o sandbox.

  2. Na barra de pesquisa na parte superior do portal, insira Hubs de Eventos e pressione Enter. O painel Hubs de Eventos da sua subscrição é apresentado.

  3. Na lista de namespaces de Hubs de Eventos, procure seu namespace. Como atribuímos o namespace como uma variável de ambiente ehubns-RANDOM, procure ehubns-NNNNN. Selecione-a. A página Visão geral do namespace dos Hubs de Eventos é exibida.

  4. No painel de menu central, em Entidades, selecione Hubs de Eventos. O painel Hubs de Eventos aparece com a lista de hubs de eventos em seu namespace.

    Seu hub de eventos é listado, mostrando o status (Ativo) e os valores padrão esperados para Retenção de mensagens (7 dias (168 horas)) e Contagem de partições (4).

    Hub de Eventos exibido no portal do Azure.

Resumo

Você criou um novo hub de eventos e tem todas as informações necessárias prontas para configurar seus aplicativos de editor e consumidor.