Exercício – criar uma função do Azure acionada por um webhook

Concluído

Neste primeiro exercício, irá criar um código para analisar as mensagens de eventos wiki do GitHub nas Funções do Azure. Irá configurar a sua função para ser executada quando receber uma mensagem do webhook.

Criar uma aplicação de funções

1. Inicie sessão no portal do Azure com a sua conta do MS Learn.

2. Selecione Criar um recurso. O painel Criar um recurso é exibido.

3. No painel de menu esquerdo, em Categorias, selecione Computação e, na caixa de pesquisa Serviços de pesquisa e marketplace, procure e selecione Aplicativo de função. O painel Aplicativo de função é exibido.

4. Selecione Criar. O painel Criar aplicativo de função é exibido.

5. Na guia Noções básicas, insira os seguintes valores para cada configuração.

   Nota

   O Nome do Aplicativo de Função deve ser exclusivo. Sugerimos que utilize, por exemplo, <o seu nome ou iniciais>triggerapp. Utilize este nome sempre que vir <your-functionapp-name> neste exercício.

   Definição	valor
   Detalhes do Projeto
   Subscrição	Subscrição de Assistente
   Grupo de Recursos	Na lista suspensa, selecione o grupo de recursos da área restrita, [nome do grupo de recursos da área restrita].
   Detalhes da instância
   Nome do aplicativo da função	<your-functionapp-name>
   Publicar	Código
   Pilha de runtime	Node.js
   Versão	Aceitar padrão
   País/Região	Selecione a localização mais próxima de si, que também seja uma das Regiões do Sandbox permitidas.
   Sistema Operativo
   Sistema operativo	Windows
   Alojamento
   Opções e planos de hospedagem	Consumo (Sem servidor)

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

   • E.U.A. Oeste 2
   • E.U.A. Centro-Sul
   • E.U.A. Central
   • E.U.A. Leste
   • Europa Ocidental

   • Sudeste Asiático
   • Leste do Japão
   • Sul do Brasil
   • Austrália Sudeste
   • Índia Central

6. Selecione Avançar : Armazenamento para abrir a guia Armazenamento. Insira os seguintes valores para cada configuração.

   Definição	valor
   Armazenamento
   Storage account	(Novo) e aceite o nome predefinido.

7. Selecione Rever + criar.

8. O Azure verifica suas entradas. Quando verificado, selecione Criar.

Criar uma função acionada por um webhook

1. Quando a implementação for concluída, selecione Ir para recurso. O painel Visão geral é exibido para seu aplicativo de função.

2. Em Funções, selecione Criar no portal do Azure.

3. O painel de funções Criar é exibido.

4. Em Selecione um modelo, selecione Gatilho HTTP e, em seguida, selecione Criar. O painel HttpTrigger1 aparece para sua Função, exibindo elementos essenciais para seu novo gatilho.

5. No painel de menu esquerdo, em Desenvolvedor, selecione Código + Teste. O painel Código + Teste aparece para sua Função, exibindo o arquivo JavaScript que foi criado a partir do modelo. Ele deve se parecer com o código a seguir.

   module.exports = async function (context, req) {
       context.log('JavaScript HTTP trigger function processed a request.');
   
       const name = (req.query.name || (req.body && req.body.name));
       const responseMessage = name
           ? "Hello, " + name + ". This HTTP triggered function executed successfully."
           : "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.";
   
       context.res = {
           // status: 200, /* Defaults to 200 */
           body: responseMessage
       };
   }
   

   O arquivo index.js é a função JavaScript gerada pelo portal. A solicitação lê o nome, passado como uma cadeia de caracteres de consulta ou como parte do corpo da solicitação, e responde com uma mensagem "Olá".

6. Acima do código está o caminho com uma lista suspensa mostrando o nome do arquivo. Na lista suspensa, selecione function.json. O arquivo JSON que foi criado pelo modelo é exibido. Ele deve se parecer com o código a seguir.

   {
       "bindings": [
           {
               "authLevel": "function",
               "type": "httpTrigger",
               "direction": "in",
               "name": "req",
               "methods": [
                   "get",
                   "post"
               ]
           },
           {
               "type": "http",
               "direction": "out",
               "name": "res"
           }
       ]
   }
   

   As associações JSON especificam que a função é acionada por solicitações HTTP GET e POST direcionadas para a URL do aplicativo de função.

Testar o acionamento da função

1. Na barra de menu superior, selecione Obter URL da função.

2. Na caixa de diálogo Obter URL da função, na lista suspensa Chave, em Tecla de função, selecione padrão. No campo URL, selecione o ícone Copiar para área de transferência. O URL terá um aspeto semelhante ao seguinte:

   https://<your-functionapp-name>.azurewebsites.net/api/HttpTrigger1?code=aUjXIpqdJ0ZHPQuB0SzFegxGJu0nAXmsQBnmkCpJ6RYxleRaoxJ8cQ==
   

3. Cole esse URL em um navegador e, no final do URL, acrescente o parâmetro da cadeia de caracteres de consulta: &name=yourname>, por exemplo &name=<Dick e Jane.

4. Para executar a solicitação, pressione Enter. A resposta devolvida pela função é apresentada no browser. Terá um aspeto semelhante ao seguinte:

   Hello Dick and Jane. This HTTP triggered function executed successfully.
   

Parabéns! Tem agora uma função que pode ser acionada por um URL.