Exercício - Criar uma função do Azure acionada por um webhook

Concluído

Neste primeiro exercício, você criará seu código para analisar as mensagens de evento wiki do GitHub no Azure Functions. Você configurará sua função para ser executada quando uma mensagem de webhook for recebida.

Criar um aplicativo de função

1. Entre no portal do Azure usando sua conta do Microsoft 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 procurar serviços e marketplace, procure e selecione App de Função. O painel Aplicativo de função é exibido. Selecione Criar.

4. Selecione Consumo e, em seguida, selecione o botão Selecionar . O painel Criar aplicativo de função é exibido.

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

   Observação

   O Nome da Aplicação de Função deve ser único. Sugerimos usar algo como <seu nome ou iniciais>triggerapp. Use este nome sempre que vir <your-functionapp-name> neste exercício.

   Cenário	Valor
   Detalhes do Projeto
   Subscrição	Subscrição do Concierge
   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	<seu-nome-funçãoapp->
   Sistema Operativo	Mac OS
   Pilha de tempo de execução	Node.js
   Versão	Aceitar padrão
   Região	Escolha o local mais próximo de você que também seja uma das regiões de Sandbox permitidas.

   A sandbox gratuita permite criar recursos em um subconjunto das regiões globais do Azure. Selecione uma região na lista a seguir ao criar recursos:

   • Oeste dos EUA 2
   • Centro-Sul dos EUA
   • EUA centrais
   • Leste dos EUA
   • Europa Ocidental

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

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

   Cenário	Valor
   Armazenamento
   Conta de armazenamento	(Novo) e aceite o nome padrão.

7. Selecione Rever + criar.

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

Criar uma função acionada por webhook

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

2. Em Funções no painel central, selecione Criar função em Criar no portal do Azure.

3. O painel função Criar aparece.

4. Em Selecione um modelo, selecione Gatilho HTTP e, em seguida, selecione Avançar.

5. Aceite o nome da função padrão e o nível de autorização. Selecione Criar. O painel HttpTrigger1 aparece para a sua Função, exibindo os elementos essenciais para o seu novo gatilho.

6. Selecione Código + Teste na parte superior da janela. 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á".

7. Acima do código, encontra-se o caminho com uma lista suspensa que mostra 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.

Teste a ativar a sua 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, selecione o ícone Copiar para a área de transferência no campo padrão (Tecla de função). O URL terá a seguinte aparência:

   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 retornada pela função aparece no navegador. Será mais ou menos assim:

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

Parabéns;! Agora você tem uma função que pode ser acionada por uma URL.