Exercício – Enviar pedidos através de uma ligação híbrida do Azure Relay

Concluído

O código nas aplicações cliente tem de ser ligado e autenticado no Azure Relay para que as aplicações possam enviar e receber mensagens.

Criou um reencaminhamento para o seu serviço de verificação de crédito. Agora, quer ativar o componente de serviço de escuta no local para ligar ao reencaminhamento, para que possa receber pedidos e enviar respostas. Também quer concluir o código na aplicação cliente, que irá enviar pedidos de verificação de crédito para o reencaminhamento e aguardar as respostas. Ao ligar ao serviço de reencaminhamento desta forma, expõe o serviço aos componentes na cloud, sem ter de abrir uma porta na firewall no local. Esta abordagem ajuda a proteger o serviço de verificação de crédito.

Nesta unidade, irá escrever o código do Azure Relay nas aplicações de remetente e de serviço de escuta.

Clonar as aplicações de exemplo

Tem duas aplicações de linha de comandos que irão enviar e escutar mensagens a partir do reencaminhamento que criou anteriormente. A maioria do código está concluída, mas tem de adicionar o código do Azure Relay às aplicações. Vamos começar por obter o código:

  • No Azure Cloud Shell, à direita, utilize git para clonar as aplicações de exemplo:

    git clone https://github.com/MicrosoftDocs/mslearn-expose-hybrid-services-with-azure-relay.git
    

Configurar a aplicação de serviço de escuta

Primeiro, vamos garantir que a aplicação de serviço de escuta consegue ligar ao reencaminhamento. A aplicação precisa do endereço do espaço de nomes, do nome da ligação híbrida, do nome chave e da chave de ligação primária, que guardou anteriormente num ficheiro de texto.

  1. Altere o diretório para o código de arranque da aplicação de serviço de escuta e, em seguida, inicie o editor de código:

    cd ~/mslearn-expose-hybrid-services-with-azure-relay/starter/listener
    code Program.cs
    
  2. No código, procure o comentário "// Details of the Azure Relay". Imediatamente a seguir ao comentário, adicione este código:

    private const string RelayNamespace = "<namespace>.servicebus.windows.net";
    private const string ConnectionName = "creditcheckconnection";
    private const string KeyName = "RootManageSharedAccessKey";
    private const string Key = "<your key here>";
    
  3. No código, substitua <namespace> pelo nome do reencaminhamento que criou anteriormente, copie a chave do ficheiro AccessKeys.txt e, em seguida, cole-a para substituir <your key here>.

A aplicação de serviço de escuta tem agora todas as informações de que precisa para se ligar e autenticar no reencaminhamento no Azure.

Responder aos pedidos na aplicação de serviço de escuta

Tem de adicionar o serviço de verificação de crédito ao reencaminhamento como serviço de escuta, para receber os pedidos enviados para o reencaminhamento. O código tem de configurar o serviço de escuta para subscrever eventos, processar pedidos e formular respostas. O serviço de verificação de crédito, por exemplo, tem de obter o nome do pedido e, em seguida, responder com o histórico de crédito para essa pessoa. Quando tiver configurado o serviço de escuta, chame o método OpenAsync() para começar a escutar os pedidos.

  1. No ficheiro de código Program.cs da aplicação de serviço de escuta, procure o comentário "// Subscribe to the status events". Imediatamente a seguir ao comentário, adicione este código:

    listener.Connecting += (o, e) => { Console.WriteLine("Connecting"); };
    listener.Offline += (o, e) => { Console.WriteLine("Credit check service is offline"); };
    listener.Online += (o, e) => { Console.WriteLine("Credit check service is online"); };
    
  2. Procure o comentário "// Obtain the name from the request". Imediatamente a seguir ao comentário, adicione este código:

    TextReader tr = new StreamReader(context.Request.InputStream);
    String requestedName = tr.ReadToEnd();
    Console.WriteLine("A request was received to check credit for: " + requestedName);
    
  3. Procure o comentário "// Formulate and send the response". Imediatamente a seguir ao comentário, adicione este código:

    context.Response.StatusCode = HttpStatusCode.OK;
    context.Response.StatusDescription = "Credit check successful";
    using (var sw = new StreamWriter(context.Response.OutputStream))
    {
        sw.WriteLine("Credit check for {0}: {1}", requestedName, creditStatuses[index]);
    }
    
  4. Procure o comentário "// Open the listener". Imediatamente a seguir ao comentário, adicione este código:

    await listener.OpenAsync();
    Console.WriteLine("Server listening");
    
  5. Para guardar as alterações, prima Ctrl+S e, em seguida, prima Ctrl+Q para fechar o editor.

Configurar a aplicação de remetente

As aplicações que queiram verificar o registo de crédito de um cliente enviam um pedido para o reencaminhamento, que o reencaminha para o serviço de escuta. Quanto ao serviço de escuta, configura a aplicação de remetente com os detalhes de ligação do reencaminhamento.

  1. No Cloud Shell, altere o diretório para o código de arranque da aplicação de remetente e, em seguida, inicie o editor de código:

    cd ~/mslearn-expose-hybrid-services-with-azure-relay/starter/sender
    code Program.cs
    
  2. Na janela FILES, selecione Program.cs.

  3. Procure o comentário "// Details of the Azure Relay". Imediatamente a seguir ao comentário, adicione este código:

    private const string RelayNamespace = "<namespace>.servicebus.windows.net";
    private const string ConnectionName = "creditcheckconnection";
    private const string KeyName = "RootManageSharedAccessKey";
    private const string Key = "<your key here>";
    
  4. No código, substitua <namespace> pelo nome do reencaminhamento que criou anteriormente, copie a chave do ficheiro AccessKeys.txt que guardou anteriormente e, em seguida, cole-a para substituir <your key here>.

A aplicação de remetente tem agora todas as informações de que precisa para se ligar e autenticar no reencaminhamento no Azure.

Enviar pedidos a partir da aplicação de remetente

Para pedir uma verificação de crédito, a aplicação de remetente envia um nome num pedido HTTP GET para o reencaminhamento. Vamos escrever o código que formula esse pedido.

  1. No ficheiro de código Program.cs da aplicação de remetente, procure o comentário "// Create an HttpClient and formulate the request". Imediatamente a seguir ao comentário, adicione este código:

    var client = new HttpClient();
    var request = new HttpRequestMessage()
    {
        RequestUri = uri,
        Method = HttpMethod.Get,
        Content = new StringContent(name)
    };
    request.Headers.Add("ServiceBusAuthorization", token);
    
  2. Procure o comentário "// Send the request". Imediatamente a seguir ao comentário, adicione este código:

    var response = await client.SendAsync(request);
    
  3. Procure o comentário "// Display the result". Imediatamente a seguir ao comentário, adicione este código:

    Console.WriteLine(await response.Content.ReadAsStringAsync());
    
  4. Para guardar as alterações, prima Ctrl+S e, em seguida, prima Ctrl+Q para fechar o editor.

Iniciar as aplicações

As aplicações de serviço de escuta e remetente estão concluídas. Agora pode executar ambas as aplicações, utilizar o remetente para pedir uma verificação de crédito e, em seguida, observar os resultados em ambas as aplicações. Para executar ambas as aplicações de uma só vez, irá utilizar uma segunda instância do Cloud Shell para alojar o remetente.

  1. No Cloud Shell, para criar e executar a aplicação de serviço de escuta, execute estes comandos:

    cd ~/mslearn-expose-hybrid-services-with-azure-relay/starter/listener
    dotnet run
    
  2. Quando receber a mensagem "Servidor a escutar", pode iniciar o remetente. Abra uma nova instância do browser e aceda à página Bem-vindo ao Azure Cloud Shell.

  3. Se lhe for pedido para selecionar um diretório, selecione Microsoft Learn Sandbox.

  4. Para criar e executar a aplicação de remetente, execute estes comandos:

    cd ~/mslearn-expose-hybrid-services-with-azure-relay/starter/sender
    dotnet run
    

Testar as aplicações

Agora que as aplicações estão em execução em instâncias separadas do Cloud Shell, vamos testá-las através da verificação de um registo de crédito.

  1. Organize as janelas do browser para que possa ver ambas.

  2. Na aplicação de remetente, escreva um nome e, em seguida, prima Enter.

    Na aplicação de serviço de escuta, o nome introduzido deverá ser apresentado.

    Na aplicação de remetente, a resposta do serviço de escuta aparece com o resultado da verificação de crédito.

  3. Para sair da aplicação de remetente, prima Enter. Pode executar a aplicação novamente para verificar outros nomes. Quando terminar, feche a janela do browser.

  4. Para sair da aplicação de serviço de escuta, selecione Ctrl+C.