Computação Sem Servidor Do Azure

Computação
sem servidor
do Azure
Livro de receitas Segunda Edição
Receitas para criar e monitorar aplicativos controlados por evento usando

o Azure Functions
www.packt.com
Praveen Kumar Sreeram
Livro de receitas da computação
sem servidor do Azure
Segunda Edição
Receitas para criar e monitorar aplicativos controlados

por evento usando o Azure Functions
Praveen Kumar Sreeram
BIRMINGHAM – MUMBAI
Livro de receitas da computação sem servidor do Azure
Segunda Edição
Copyright © 2018 Packt Publishing
Todos os direitos reservados. Nenhuma parte deste livro pode ser reproduzida,
armazenada em um sistema de recuperação ou transmitida sob qualquer forma
ou por qualquer meio sem a permissão prévia por escrito da editora, exceto no caso
de breves citações incorporadas em artigos críticos ou comentários.
Não se poupou esforços na preparação deste livro para garantir a precisão das
informações apresentadas. No entanto, as informações contidas neste livro são vendidas
sem garantia, expressa ou implícita. O autor, a Packt Publishing e seus revendedores
e distribuidores não serão responsabilizados por quaisquer danos causados ou
supostamente causados de forma direta ou indireta por este livro.
A Packt Publishing empenha-se em fornecer informações de marca registrada sobre

todas as empresas e produtos mencionados neste livro pelo uso adequado de capitais.
No entanto, a Packt Publishing não garante a precisão dessas informações.
Editor de comissionamento: Vijin Boricha

Editor de aquisições: Shrilekha Inani
Editores de desenvolvimento de conteúdo: Nithin George Varghese
Editor técnico: Komal Karne
Editora: Safis Editing
Coordenador de projetos: Drashti Panchal
Revisor: Safis Editing
Indexadores: Mariammal Chettiyar
Gráficos: Tom Scaria
Coordenadora de produção: Aparna Bhagat
Primeira publicação: agosto de 2017

Segunda edição: novembro de 2018
Referência de produção: 1301118
Publicado pela Packt Publishing Ltd.

Livery Place
35 Livery Street
Birmingham B3 2PB, UK.
ISBN 978-1-78961-526-5
www.packtpub.com
Não teria sido possível concluir o livro sem o apoio da minha melhor
metade, minha esposa, Haritha, e do meu lindo anjinho, Rithwika Sreeram
mapt.io
O Mapt é uma biblioteca digital online que lhe oferece acesso total a mais
de 5.000 livros e vídeos, bem como a ferramentas líderes da indústria para
ajudá-lo a planejar seu desenvolvimento pessoal e avançar em sua carreira.
Para obter mais informações, visite nosso site.
Por que se inscrever?

• Gaste menos tempo aprendendo e mais tempo codificando com e-books
e vídeos práticos de mais de 4.000 profissionais da indústria
• Aprenda melhor com planos de habilidade criados especialmente para você
• Receba um e-book ou vídeo gratuito todo mês
• O Mapt é totalmente pesquisável
• Copie e cole, imprima e marque conteúdos
PacktPub.com
Você sabia que a Packt oferece versões e-book de todos os livros publicados,
com arquivos disponíveis em ePub e PDF? Você pode fazer um upgrade para
a versão e-book em www.PacktPub.com e, como cliente de livro impresso, você
tem direito a um desconto na cópia do e-book. Entre em contato conosco pelo
e-mail service@packtpub.com para obter mais detalhes.
Em www.PacktPub.com, você também pode ler uma coleção de artigos técnicos

gratuitamente, inscrever-se em vários boletins informativos grátis e receber
descontos exclusivos e ofertas de livros e e-books da Packt.
Colaboradores
Sobre o autor
Praveen Kumar Sreeram trabalha como arquiteto do Azure, instrutor em uma
MNC líder. Ele tem mais de 14 anos de experiência no campo de desenvolvimento,
análise, design e entrega de aplicativos, incluindo desenvolvimento personalizado para
Web usando ASP.NET e MVC para a criação de aplicativos móveis usando o Xamarin
para domínios, como seguro, telecomunicações e gerenciamento de despesas em fio.
Ele foi reconhecido duas vezes como MVP por um dos principais sites de comunidade
social, CSharpCorner. Ele é um blogueiro ávido que escreve sobre o seu aprendizado
em seu blog chamado Praveen Kumar Sreeram. Seu foco atual é na análise de
problemas de negócios e no fornecimento de soluções técnicas para vários projetos
relacionados ao Microsoft Azure e .NET Core. Sua ID no twitter é @PrawinSreeram.
Primeiramente, gostaria de agradecer à equipe da Packt Publishing,

incluindo Shrilekha Inani, Nithin George Varghese e Komal Karne.
Gostaria de agradecer minha avó, Neelavatamma, meu pai, Kamalakar,

e minha mãe, Seetha, por fazerem parte da minha vida e me darem coragem
o tempo todo.
Gostaria de expressar minha mais profunda gratidão a Bhagyamma

(minha avó), Kamala Kumar (meu tio materno), seus irmãos e ao restante
da família, que têm me apoiado o tempo todo.
Sobre os revisores
Kasam Shaikh, entusiasta do Microsoft Azure, é um profissional experiente com
uma atitude "Poderia ser", com 10 anos de experiência na indústria trabalhando
como arquiteto de nuvem com uma das principais empresas de TI em Mumbai,
Índia. Ele é um arquiteto certificado para o Azure e foi reconhecido como um MVP
por uma comunidade online líder, além de ser palestrante global de IA. Ele foi autor
de livros sobre o Azure Cognitive, Azure Bots e Microsoft Bot Frameworks. Ele lidera
a comunidade do Azure India (AZINDIA), a comunidade online de crescimento mais
rápido de aprendizado do Azure. Ele também é fundador do site Dear Azure.
Em primeiro lugar, gostaria de agradecer a Almighty Allah, minha família

e, especialmente, a minha cara-metade, por me motivarem ao longo de todo
este processo. Sou muito grato a Packt Publishing por acreditar em mim
e por me considerar para esta oportunidade.
Michael Sync (SOE Htike) é um engenheiro sênior que trabalha na Readify na

Austrália. Ele foi um MVP (Microsoft Valuable Professional) por 7 anos. Participou
como palestrante, mentor e ajudante em vários eventos comunitários. Também
é autor e revisor de livros técnicos. Ele publicou dois livros com Manning e revisou
vários livros para diversas editoras. Ele trabalha na indústria de software há mais
de 16 anos.
A Packt está à procura de autores

como você
Se você está interessado em se tornar um autor para a Packt, visite authors.
packtpub.com e candidate-se hoje. Temos trabalhado com milhares de
desenvolvedores e profissionais de tecnologia, assim como você, para ajudá-los
a compartilhar sua visão com a comunidade de tecnologia global. Você pode
fazer uma candidatura geral, candidatar-se para um assunto específico para
o qual estamos recrutando um autor ou enviar a sua própria ideia.
Sumário
Prefácioxiii
Capítulo 1: Desenvolver aplicativos de nuvem usando
associações e gatilhos de função 1
Introdução1
Criar uma API Web de back-end usando gatilhos HTTP 2
Preparação3
Como fazer isso… 3
Como funciona… 8
Consulte também 8
Persistir detalhes de funcionários usando associações
de saída da tabela de Armazenamento do Azure 8
Preparação9
Como fazer isso... 9
Como funciona... 13
Noções básicas sobre a conexão de armazenamento 14
O que é o serviço de armazenamento de Tabelas do Azure? 15
Chave de partição e chave de linha 15
E mais... 15
Salvar as imagens de perfil em Filas usando Associações
de saída de fila 15
Preparação16
Como funciona… 18
Armazenar a imagem no Armazenamento de Blobs do Azure 18
Preparação18
Como funciona... 20
E mais... 21
[i]
Sumário
Capítulo 2: Trabalhar com notificações usando os serviços

SendGrid e Twilio 23
Introdução23
Enviar uma notificação por email ao administrador de um site
usando o serviço SendGrid 24
Preparação24
Criar uma conta do SendGrid 24
Gerar uma chave de API a partir do portal SendGrid 27
Configurar a chave de API do SendGrid com o aplicativo de Função do Azure 28
Criar associação de Fila de Armazenamento para o Gatilho HTTP 29
Criar Gatilho de Fila para processar a mensagem do Gatilho HTTP 30
Criar associação de saída do SendGrid para o Gatilho de Fila 31
Como funciona... 33
E mais 34
Enviar uma notificação por email dinamicamente ao usuário final 34
Preparação34
Aceitar o novo Parâmetro de email na função RegisterUser 35
Recuperar as informações de UserProfile no gatilho de SendNotifications 36
Como funciona... 37
E mais... 38
Implementar log de email no Armazenamento de Blobs do Azure 39
Como funciona... 41
Modificar o conteúdo do email para incluir um anexo 41
Preparação42
Personalizar o nome do arquivo de log usando a interface IBinder 42
Adicionar um anexo ao email 43
Enviar uma notificação por SMS ao usuário final usando o serviço Twilio 44
Preparação45
Como funciona... 49
Capítulo 3: Integração perfeita do Azure Functions
com os Serviços do Azure 51
Introdução 51
Usar os Serviços Cognitivos para localizar rostos em imagens 52
Preparação52
Criar uma nova conta da API da Pesquisa Visual Computacional 52
Definir as configurações do aplicativo 53
[ ii ]
Sumário

Como funciona... 60
E mais... 60
Interações do Banco de dados SQL do Azure usando o Azure Functions 61
Preparação61
Como funciona... 66
Monitorar Tweets com Aplicativos Lógicos e notificar quando
um usuário popular tweetar 66
Preparação67
Criar um novo Aplicativo Lógico 67
Criar o Aplicativo Lógico com conectores do Twitter e do Gmail 69
Testar a funcionalidade do Aplicativo Lógico 73
Como funciona... 74
Integrar Aplicativos Lógicos com funções sem servidor 74
E mais... 79
Consulte também 80
Auditar dados do Cosmos DB usando gatilhos de feed de alterações 80
Preparação80
Criar uma nova conta do Cosmos DB 81
Criar uma nova coleção do Cosmos DB 81
Como funciona... 86
E mais... 86
Capítulo 4: Noções básicas sobre a experiência integrada
de desenvolvedor de Ferramentas do Visual Studio 87
Introdução87
Criação de um aplicativo de função usando o Visual Studio 2017 88
Preparação88
Como funciona... 92
E mais... 92
Depuração de C# do Azure Functions em um ambiente local
de preparação usando o Visual Studio 2017 92
Preparação93
Como funciona... 97
E mais... 97
[ iii ]
Sumário
Conexão à nuvem de armazenamento do Azure a partir

do ambiente local do Visual Studio 98
Preparação98
Como funciona... 102
E mais... 102
Implantação do aplicativo Azure Functions para a Nuvem do Azure
usando o Visual Studio 103
E mais... 107
Depuração de um C# do Azure Functions ao vivo, hospedada
no ambiente de Nuvem do Microsoft Azure, usando o Visual Studio 107
Preparação108
Implantação do Azure Functions em um contêiner 111
Preparação112
Criando um ACR 113
Criação de uma imagem do Docker para o aplicativo de função 115
Como mover a imagem do Docker para o ACR 116
Criação um novo aplicativo de função com o Docker 118
Capítulo 5: Exploração de ferramentas de testes para
a validação do Azure Functions 121
Introdução121
Testes do Azure Functions 122
Preparação122
Testes de gatilhos HTTP usando o Postman 123
Testes de um gatilho de blob usando o Gerenciador de Armazenamento do Microsoft 125
Testes do gatilho de fila usando o portal de gerenciamento do Azure 128
E mais... 131
Testes de um Azure Functions em um ambiente de teste
utilizando slots de implantação 131
E mais... 139
Testes de carga do Azure Functions usando o Azure DevOps 139
Preparação140
E mais... 143
Consulte também 144
[ iv ]
Sumário
Criação e testes locais do Azure Functions usando ferramentas

da CLI do Azure 144
Preparação144
Testes e validação da capacidade de resposta do Azure
Functions usando o Application Insights 147
Preparação148
E mais... 152
Desenvolvimento de testes de unidade para o Azure Functions
com gatilhos HTTP 152
Preparação153
Capítulo 6: Como monitorar e solucionar problemas de serviços
sem servidor no Azure 157
Introdução 157
Solução de problemas do Azure Functions 158
Visualização de logs de aplicativos em tempo real 158
Diagnóstico do aplicativo de função inteiro 160
E mais... 161
Integração do Azure Functions com o Application Insights 163
Preparação163
E mais... 166
Monitoramento do Azure Functions 166
Envio de detalhes de telemetria personalizados para o Application
Insights Analytics 168
Preparação170
Criação de uma função do Application Insights 171
Configuração de chaves de acesso 172
Integração e teste de uma consulta do Application Insights 174
Configuração do relatório métrico derivado personalizado 176
Envio de detalhes de telemetria do aplicativo via e-mail 179
Preparação179
[v]
Sumário

E mais... 182
Integração de dados de monitoramento do Application Insights
em tempo real com Power BI usando o Azure Functions 182
Preparação183
Configuração do Power BI com um painel, um conjunto de dados e o URI de envio por push 184
Criação de um Power BI em tempo real do Azure Application Insights — função C# 190
E mais... 193
Capítulo 7: Desenvolver aplicativos confiáveis sem
servidor usando o Durable Functions 195
Introdução 195
Configurar o Durable Functions no Portal de Gerenciamento do Azure 196
Preparação196
E mais... 198
Criar um aplicativo Hello World do Durable Functions 199
Preparação199
Criar uma função HttpStart no cliente Orchestrator 200
Criar a função do Orchestrator 202
Criar uma função de atividade 204
E mais... 205
Testar e solucionar problemas do Durable Functions 205
Preparação206
Implementar aplicativos confiáveis multi-threaded usando
o Durable Functions 208
Preparação208
Criar a função do Orchestrator 209
Criar uma função de atividade GetAllCustomers 210
Criar uma função de atividade CreateBARCodeImagesPerCustomer 211
E mais... 213
Capítulo 8: Importação em massa de dados usando
o Azure Durable Functions e o Cosmos DB 215
Introdução 215
Problema de negócios 216
[ vi ]
Sumário
Maneira sem servidor do Durable de implementar uma importação do Excel 217

Carregar dados de funcionários no Armazenamento de Blobs 217
E mais... 222
Criar um gatilho de blob 222
Preparação222
E mais... 226
Criar o Orquestrador do Durable e acioná-lo para cada
importação do Excel 227
E mais... 230
Ler dados do Excel usando funções de atividade 231
Preparação231
Ler dados do Armazenamento de Blob 232
Ler dados do Excel do fluxo 233
Criar a função de atividade 234
E mais... 236
Escalar automaticamente a taxa de transferência do Cosmos DB 237
Preparação237
E mais... 241
Inserir dados em massa no Cosmos DB 241
E mais... 242
Capítulo 9: Implementação de práticas recomendadas para
o Azure Functions 243
Adição de várias mensagens a uma fila usando a função
IAsyncCollector244
Preparação244
E mais... 247
Implementação de aplicativos de defesa usando o Azure Functions
e gatilhos de fila 247
Preparação248
CreateQueueMessage – aplicativo de console C# 248
[ vii ]
Sumário
Desenvolvimento do Azure Function – gatilho de fila 249

Execução de testes usando o aplicativo de console 250
E mais... 251
Manipulação de ingresso massivo usando Hubs de Eventos para IoT
e outros cenários semelhantes 252
Preparação252
Como criar um gatilho de hub de eventos do Azure Function 252
Desenvolvimento de um aplicativo de console que simula dados da IoT 253
Como evitar partidas a frio ao aquecer o aplicativo em intervalos
regulares 256
Preparação256
Como criar um gatilho HTTP 257
Como criar um gatilho de timer 257
E mais... 258
Como habilitar a autorização para aplicativos de função 258
Preparação258
E mais... 260
Controle de acesso ao Azure Functions usando teclas de função 260
Como configurar a tecla de função para cada aplicativo 261
Configuração de uma tecla host para todas as funções em um único aplicativo de função 262
E mais... 264
Como proteger o Azure Functions usando o Azure Active Directory 264
Preparação265
Configuração do Azure AD para o aplicativo de função 265
Como registrar o aplicativo cliente no Azure AD 266
Como conceder ao aplicativo cliente acesso ao aplicativo de back-end 269
Como testar a funcionalidade de autenticação usando um token JWT 269
Configuração da limitação do Azure Functions usando
o Gerenciamento de API 271
Preparação272
Como integrar Azure Functions ao Gerenciamento de API 273
Configuração da limitação de solicitações usando políticas de entrada 276
Como testar a configuração de política de entrada de limite de taxa 278
[ viii ]
Sumário
Como acessar com segurança o Banco de Dados SQL

do Azure Functions usando Identidade de Serviço Gerenciada 280
Preparação280
Criação de um aplicativo de função usando o Visual Studio 2017 com
o tempo de execução V1 281
Como criar um SQL Server lógico e um Banco de Dados SQL 284
Como habilitar a identidade de serviço gerenciada 284
E mais... 287
Código compartilhado no Azure Functions usando bibliotecas de classe 287
E mais... 291
Uso de classes fortemente tipadas no Azure Functions 291
Preparação291
E mais... 294
Capítulo 10: Configuração de aplicativos sem servidor
no ambiente de produção 295
Introdução 295
Implantar o Azure Functions usando Run From Package 296
Preparação297
E mais... 299
Implantar o Azure Functions usando modelos ARM 299
Preparação299
E mais... 303
Configurar o domínio personalizado para o Azure Functions 303
Preparação304
Configuração do aplicativo de função com um domínio existente 306
Técnicas para acessar Configurações do Aplicativo 308
Preparação308
Acesso a Configurações do Aplicativo e cadeias de conexão no código do Azure Function 308
Configuração do aplicativo – expressões de associação 311
[ ix ]
Sumário
Criar e gerar especificações de API abertas usando o Swagger 311

Preparação312
Quebrar APIs grandes em pequenos subconjuntos de APIs
usando proxies 316
Preparação316
Criação de microsserviços 318
Criação dos proxies de gateway 318
Teste das URLs de proxy 321
E mais... 321
Mover itens de configuração de um ambiente para outro usando recursos 322
Preparação323
Capítulo 11: Como implementar e implantar a integração
contínua usando o Azure DevOps 329
Introdução329
Pré-requisitos 330
Integração contínua – criar uma definição de build 331
Preparação332
E mais... 338
Integração contínua – enfileirar um build e acioná-lo manualmente 338
Preparação338
Configurar e acionar um build automatizado 341
E mais... 344
Integração contínua – executar casos de teste de unidade no pipeline 345
E mais... 348
Criar uma definição da versão 348
Preparação349
[x]
Sumário

E mais... 358
Acionar a versão automaticamente 360
Preparação360
E mais... 362
Outros livros que você pode gostar 363
[ xi ]
Prefácio
Prefácio
A computação sem servidor é a abstração do gerenciamento de infraestrutura e permite
que os desenvolvedores aumentem o foco na lógica de negócios para que possam oferecer
mais recursos e inovação por ciclo. Ao criar aplicativos sem servidor, você não precisa
investir tempo em provisionamento ou gerenciamento de infraestrutura (por exemplo,
criação de servidores, instalação de atualizações, aplicação de patch do sistema operacional,
gerenciamento de como o aplicativo será escalado). Em vez disso, você usa um conjunto
de serviços de nuvem totalmente gerenciados e altamente escaláveis que cuidam dessa
parte do trabalho.
Os benefícios da computação sem servidor abrangem toda a organização e todo o ciclo

de desenvolvimento:
• Para o desenvolvedor, ela representa o foco total no valor. A criação de

aplicativos sem servidor aumenta a capacidade individual de contribuir
com mais eficácia para o centro do negócio.
• Para a equipe de desenvolvimento, ela significa tempo mais rápido de
lançamento no mercado. Uma abordagem sem servidor agiliza a agregação
de mais valor por ciclo de desenvolvimento.
• Para a organização, ela é um facilitador da inovação proveniente de uma base
sólida. Graças à combinação de capacidade liberada e serviços disruptivos, toda
a organização pode atuar nos primeiros sinais para desenvolver ou diversificar
seu modelo de negócios e cumprir sua agenda de inovação.
Ao falar sobre aplicativos sem servidor, podemos identificar alguns padrões de aplicativos
que valem a pena ser mencionados aqui. Enquanto cada um deles compartilha os benefícios
mencionados acima, eles também têm características específicas e benefícios adicionais que
os tornam únicos e uma opção melhor para determinados cenários. Aqui estão os padrões
de aplicativos sem servidor que podemos observar:
• Aplicativos Web, que hospedam o lado do cliente e back-end em um serviço

totalmente gerenciado que lida com os requisitos de escala automática, segurança
e conformidade, com Serviço de Aplicativo.
[ xiii ]
Prefácio
• Aplicativos direcionados a eventos que usam funções sem servidor, aproveitando

o modelo de programação exclusivo (com base em gatilhos para responder a
eventos e associações para integrar outros serviços) e um modelo de faturamento
de pagamento por execução, com Azure Functions.
• Fluxos de trabalho de código baixo para uma orquestração fácil e rápida de
tarefas combinadas que resolvem um problema de negócios (geralmente
integrando serviços diferentes, tanto na nuvem quanto na infraestrutura local,
para trabalhar em conjunto) sem realmente codificar essas integrações, nem
programar novas APIs ou especificações, com Aplicativos Lógicos.
• Contêineres sem servidor, o que leva os contêineres que você tiver a uma
orquestração de Kubernetes totalmente gerenciada com o Serviço de Kubernetes
do Azure, que pode impulsionar o escalonamento com nós virtuais e Instâncias
de Contêiner do Azure quando o volume de workload for escalado de forma
repentina ou acelerada.
A Microsoft fornece uma solução para a execução fácil de pequenos segmentos de código
na nuvem com o Azure Functions. O Azure Functions fornece soluções para processamento
de dados, integração de sistemas e criação de APIs e microsserviços simples.
O livro começa com receitas de nível intermediário em computação sem servidor,

juntamente com alguns casos de uso sobre os benefícios e os principais recursos do Azure
Functions. Em seguida, exploraremos os principais aspectos do Azure Functions, como os
serviços que ele oferece, como você pode desenvolver e gravar Azure Functions e como
monitorar e solucionar os problemas apresentados.
Prosseguindo, você receberá receitas práticas sobre como integrar o DevOps com o Azure
Functions e como fornecer implantação contínua com o Azure DevOps (anteriormente
Visual Studio Team Services). O livro também fornece etapas e tutoriais práticos com base
em casos de uso sem servidor do mundo real para guiá-lo pela configuração e instalação
de ambientes sem servidor com facilidade. Por último, você verá como gerenciar o Azure
Functions, proporcionando segurança e conformidade de nível empresarial para sua
arquitetura de código sem servidor.
Você também aprenderá como criar rapidamente aplicativos que são confiáveis
e duráveis usando Durable Functions, com um exemplo de caso de uso em tempo
real muito comum.
No fim deste livro, você terá todas as habilidades necessárias para trabalhar com
arquiteturas de código sem servidor, fornecendo entrega contínua aos seus usuários.
A quem este livro se destina

Se você for um administrador de nuvem, arquiteto ou desenvolvedor que deseja
criar sistemas escaláveis e implantar aplicativos sem servidor com o Azure Functions,
o Livro de receitas da computação sem servidor do Azure é para você.
[ xiv ]
Prefácio
Tópicos abordados
Capítulo 1, Desenvolver aplicativos de nuvem usando associações e gatilhos de função, apresenta
como o tempo de execução do Azure Functions fornece modelos que podem ser usados
para integrar rapidamente diferentes serviços do Azure para as necessidades de seus
aplicativos. Ele reduz todo o código de conexão para que você possa se concentrar apenas
na lógica do aplicativo. Neste capítulo, você aprenderá como criar APIs e associações
da Web relacionadas aos Serviços de Armazenamento do Azure.
Capítulo 2, Trabalhar com notificações usando os serviços SendGrid e Twilio, lida com a forma
como a comunicação é um dos aspectos mais críticos de qualquer requisito de negócios.
Neste capítulo, você aprenderá como é fácil conectar seus requisitos de negócios escritos
no Azure Functions com os serviços de comunicação mais populares, como SendGrid
(para email) e Twilio (para SMS).
Capítulo 3, Integração perfeita do Azure Functions com os Serviços do Azure, discute como o
Azure fornece muitos conectores que você pode aproveitar para integrar seus aplicativos
de negócios com outros sistemas com muita facilidade. Neste capítulo, você aprenderá
como integrar o Azure Functions com serviços cognitivos e Aplicativos Lógicos.
Capítulo 4, Noções básicas sobre a experiência integrada de desenvolvedor de Ferramentas

do Visual Studio, ensina como desenvolver o Azure Functions usando o Visual Studio,
que fornece muitos recursos, como IntelliSense, depuração local e remota e a maioria
dos recursos de desenvolvimento regular.
Capítulo 5, Exploração de ferramentas de teste para a validação do Azure Functions, ajuda você
a entender diferentes ferramentas e processos que ajudam a agilizar os processos de
desenvolvimento e controle de qualidade. Você também aprenderá como criar cargas
usando o teste de carga do Azure DevOps (anteriormente, VSTS) e verá como monitorar
a performance do Azure Functions usando os relatórios fornecidos pelo Application
Insights. Por último, você também aprenderá como configurar alertas que notificam
quando os aplicativos não são responsivos.
Capítulo 6, Como monitorar e solucionar problemas de serviços sem servidor no Azure, ensina
como monitorar continuamente os aplicativos, analisar a performance e revisar os logs
para entender se há problemas que os usuários finais estão enfrentando. O Azure fornece
várias ferramentas para atender a todos os requisitos de monitoramento, desde os
estágios de desenvolvimento e manutenção do aplicativo.
Capítulo 7, Como desenvolver aplicativos confiáveis sem servidor usando Durable Functions,
mostra como desenvolver soluções dinâmicas de longa duração em ambientes sem
servidor usando Durable Functions, que tem recursos avançados que foram lançados
como uma extensão para o Azure Functions.
[ xv ]
Prefácio
Capítulo 8, Importação em massa de dados usando o Azure Durable Functions e o Cosmos DB,
ensina como aproveitar o Azure Durable Functions para ler e importar os dados do
armazenamento de Blobs e despejar os dados no Cosmos DB.
Capítulo 9, Implementação de práticas recomendadas para Azure Functions, ensina algumas das
práticas recomendadas que você deve seguir para melhorar a performance e a segurança
enquanto trabalha no Azure Functions.
Capítulo 10, Configuração de aplicativos sem servidor no ambiente de produção, demonstra

como implantar um aplicativo de função de maneira eficiente e copiar/mover as
configurações de maneira mais inteligente para evitar erros humanos. Você também
aprenderá como configurar um domínio personalizado que poderá compartilhar com
seus clientes ou usuários finais no lugar do domínio padrão que é criado como parte
do provisionamento do aplicativo de função.
Capítulo 11, Como implementar e implantar a integração contínua usando o Azure DevOps,
ajuda você a aprender como implementar a integração e entrega contínua do seu
código do Azure Functions com a ajuda do Visual Studio e do Azure DevOps.
Aproveite ao máximo este livro

O conhecimento prévio e a experiência prática com os serviços principais
do Microsoft Azure são necessários.
Download dos arquivos de exemplo de

código
Você pode fazer download dos arquivos de exemplo de código para este livro em sua
conta em http://www.packtpub.com. Se comprou este livro em outro lugar, você
pode visitar http://www.packtpub.com/support e registrar-se para ter os arquivos
enviados por email diretamente para você.
Você pode fazer download dos arquivos de código seguindo as seguintes etapas:
1. Faça logon ou registre-se em http://www.packtpub.com.

2. Selecione a aba SUPPORT.
3. Clique em Downloads de código e Errata.
4. Digite o nome do livro na caixa de Pesquisa e siga as instruções na tela.
[ xvi ]
Prefácio
Assim que o arquivo é baixado, certifique-se de descompactar ou extrair a pasta usando

a versão mais recente do:
• WinRAR / 7-Zip para Windows

• Zipeg / iZip / UnRarX para Mac
• 7-zip / PeaZip para Linux
O pacote de código para o livro também está hospedado no GitHub em

https://github.com/PacktPublishing/Azure-Serverless-Computing-
Cookbook-Second-Edition. Também temos outros pacotes de código em
nosso rico catálogo de manuais e vídeos disponíveis em https://github.com/
PacktPublishing/. Dê uma olhada neles!
Download dos arquivos EPUB/mobi

e exemplo de código
Uma versão EPUB e mobi deste livro está disponível gratuitamente no GitHub.
Download das imagens coloridas

Também fornecemos a você um arquivo de PDF com as imagens coloridas das capturas
de tela/diagramas utilizados neste livro. Você pode fazer download deles aqui:
https://www.packtpub.com/sites/default/files/downloads/9781789615265_
ColorImages.pdf.
Convenções usadas
Existem várias convenções de texto usadas ao longo de todo este livro.
CodeInText: indica palavras de código em texto, nomes de tabela de banco de dados,

nomes de pastas e arquivos, extensões de arquivo, nomes de caminhos, URLs fictícios,
entrada do usuário e usuários do Twitter. Aqui está um exemplo: "Monte o arquivo
de imagem de disco WebStorm-10*.dmg baixado como outro disco em seu sistema".
Um bloco de código é definido da seguinte forma:

using System.Net;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Primitives;
using Newtonsoft.Json;
[ xvii ]
Prefácio
Quando desejamos chamar a atenção para uma parte específica de um bloco de código,
as linhas ou itens relevantes são definidos em negrito:
using System.Net;
Qualquer entrada de linha de comando ou saída é escrita como segue:

docker tag functionsindocker cookbookregistry.azurecr.io/
functionsindocker:v1
Negrito: indica um novo termo, uma palavra importante ou palavras que você vê na tela,
por exemplo, em menus ou caixas de diálogo, também aparece em texto como este. Aqui
está um exemplo: "Durante a instalação, escolha Desenvolvimento do Azure na seção
Workloads.»
Avisos ou notas importantes aparecem desta

forma.
Dicas e truques aparecem desta forma.
Seções
Neste livro, você encontrará vários títulos que aparecem com frequência (Preparação,
Como fazer isso..., Como funciona..., Há mais... e Consulte também).
Para fornecer instruções claras sobre como concluir uma receita, use estas seções
da seguinte forma:
Preparação
Esta seção informa o que esperar na receita e descreve como configurar qualquer
software ou configuração preliminar necessária para a receita.
Como fazer isso…

Esta seção contém as etapas necessárias para seguir a receita.
[ xviii ]
Prefácio
Como funciona…
Esta seção geralmente consiste em uma explicação detalhada do que aconteceu na seção
anterior.
E mais...
Esta seção consiste em informações adicionais sobre a receita para que você possa
adquira mais conhecimento sobre ela.
Consulte também
Esta seção fornece links úteis para outras informações úteis para a receita.
Entre em contato
Os comentários dos nossos leitores são sempre bem-vindos.
Comentários gerais: enviar email para feedback@packtpub.com e mencionar o título

do livro no assunto de sua mensagem. Se você tiver dúvidas sobre qualquer aspecto deste
livro, envie um email para questions@packtpub.com.
Errata: embora tomemos o máximo de cuidado para garantir a precisão de nosso

conteúdo, erros acontecem. Se você encontrou um erro neste livro, ficaríamos gratos
se você nos relatasse. Visite http://www.packtpub.com/submit-errata, selecione
seu livro, clique no link Formulário de envio de errata e insira os detalhes.
Pirataria: se você se deparar com cópias ilegais de nossas obras em qualquer forma
na Internet, ficaríamos gratos se você nos enviasse o endereço do local ou nome do site.
Entre em contato conosco pelo e-mail copyright@packtpub.com com um link para
o material.
Se você está interessado em se tornar um autor: se há um tópico no qual você

tem experiência e está interessado em escrever ou contribuir para um livro, visite
http://authors.packtpub.com.
[ xix ]
Prefácio
Comentários
Por favor, deixe um comentário. Depois de ler e usar este livro, que tal deixar um
comentário sobre o site no qual você o comprou? Potenciais leitores poderão ver e usar
sua opinião imparcial para fazer decisões de compra, a Packt pode entender o que
você acha sobre nossos produtos e nossos autores podem ver seus comentários sobre
seu livro. Obrigado!
Para obter mais informações sobre o Packt, acesse packtpub.com.
[ xx ]
Desenvolver aplicativos
de nuvem usando associações
e gatilhos de função
Neste capítulo, vamos abordar as seguintes receitas:
• Criar uma API Web de back-end usando gatilhos HTTP

• Persistir detalhes de funcionários usando associações de saída da tabela de
Armazenamento do Azure
• Salvar as imagens de perfil em Filas usando Associações de saída de fila
• Armazenar a imagem no Armazenamento de Blobs do Azure
Introdução
Todo aplicativo de software precisa de componentes de back-end que são responsáveis
por cuidar da lógica de negócios e armazenar os dados em algum tipo de repositório,
como bancos de dados e sistemas de arquivos. Cada um desses componentes de back-
end pode ser desenvolvido usando tecnologias diferentes. A tecnologia sem servidor
do Azure também nos permite desenvolver essas APIs de back-end usando o Azure
Functions.
[1]
Desenvolver aplicativos de nuvem usando associações e gatilhos de função
O Azure Functions fornece muitos modelos prontos para uso que resolvem os problemas
mais comuns, como conectar-se ao armazenamento, criar APIs Web e cortar imagens. Neste
capítulo, aprenderemos a usar esses modelos internos. Além de aprender os conceitos
relacionados à computação sem servidor do Azure, também vamos tentar implementar
uma solução para um problema de domínio básico: a criação de componentes necessários
para qualquer organização gerenciar as informações de funcionários internos.
A seguir, um diagrama simples que ajuda a compreender o que alcançaremos neste

capítulo:
Criar uma API Web de back-end usando

gatilhos HTTP
Usaremos a arquitetura sem servidor do Azure para criar uma API Web usando gatilhos
HTTP. Esses gatilhos HTTP podem ser consumidos por qualquer aplicativo de front-end
que seja capaz de fazer chamadas HTTP.
[2]
Capítulo 1
Preparação
Vamos começar nossa jornada de compreensão da computação sem servidor do Azure
usando o Azure Functions, criando uma API Web de back-end básica que responda
a solicitações HTTP:
• Consulte https://azure.microsoft.com/free/?&wt.mc_id=AID607363_
SEM_8y6Q27AS para criar uma conta gratuita do Azure.
• Visite https://docs.microsoft.com/azure/azure-functions/
functions-create-function-app-portal para entender passo a passo o
processo de criação de um aplicativo de função e https://docs.microsoft.
com/azure/azure-functions/functions-create-first-azure-function
para criar uma função. Ao criar uma função, uma Conta de Armazenamento
também é criada para armazenar todos os arquivos. Lembre-se do nome da
Conta de Armazenamento, pois ela será usada posteriormente nos outros
capítulos.
• Depois de criar o Aplicativo de Função, examine os conceitos básicos de Gatilhos
e Associações que são os conceitos fundamentais de como o Azure Functions
funciona. Eu recomendo que você examine o artigo https://docs.microsoft.
com/azure/azure-functions/functions-triggers-bindings antes de
prosseguir.
Vamos usar o C# como a linguagem de programação em todo

o livro. A maioria das funções é desenvolvida usando o tempo
de execução do Azure Functions V2. No entanto, algumas
receitas ainda não têm suporte no tempo de execução da V2, o
que é mencionado na respectiva receita. Esperamos que, quando
você estiver lendo este livro, a Microsoft já tenha disponibilizado
esses recursos para o tempo de execução da V2 também.
Como fazer isso…

Execute as seguintes etapas:
1. Navegue até a página de listagem do Aplicativo de Função clicando no menu

Aplicativos de Funções, que está disponível no lado esquerdo.
2. Crie uma nova função clicando no ícone +:
[3]
3. Você verá a página Azure Functions para .NET – introdução na qual será
solicitado a escolher o tipo de ferramentas que gostaria de usar. Você pode
escolher o que for do seu interesse. Nos primeiros capítulos, usaremos a opção
No Portal na qual é possível criar Funções do Azure com rapidez diretamente
do portal sem nenhuma ferramenta. Posteriormente, nos outros capítulos,
usaremos o Visual Studio e o Azure Functions Core Tools para criar as Funções:
4. Na próxima etapa, selecione Mais modelos e clique em Concluir e exibir

modelos, como mostrado na captura de tela a seguir:
[4]
Capítulo 1
5. Na seção Escolha um modelo abaixo ou acesse o início rápido, escolha Gatilho

HTTP para criar uma nova função de gatilho de HTTP:
[5]
6. Forneça um nome significativo. Para este exemplo, usei RegisterUser como

o nome da Função do Azure.
7. No menu suspenso Nível de autorização, escolha a opção Anônimo.
Vamos aprender mais sobre todos os níveis de autorização no Capítulo 9,
Implementar práticas recomendadas para o Azure Functions:
8. Clique no botão Criar para criar a função de gatilho de HTTP.

9. Assim que você criar a função, todos os arquivos de configuração e códigos
necessários serão criados automaticamente e o arquivo run.csx será aberto
para edição do código. Remova o código padrão e substitua-o pelo código
a seguir. Adicionei dois parâmetros (firstname e lastname) que seriam
exibidos na saída quando o Gatilho HTTP fosse acionado:
#r "Newtonsoft.Json"
using System.Net;
public static async Task<IActionResult> Run(

HttpRequest req,
ILogger log)
{
log.LogInformation("C# HTTP trigger function processed a
request.");
string firstname=null,lastname = null;
string requestBody = await new StreamReader(req.Body).
ReadToEndAsync();
dynamic inputJson = JsonConvert.DeserializeObject(requestBody);

firstname = firstname ?? inputJson?.firstname;
lastname = inputJson?.lastname;
return (lastname + firstname) != null

? (ActionResult)new OkObjectResult($"Hello, {firstname + " " +
lastname}")
: new BadRequestObjectResult("Please pass a name on the query" +
"string or in the request body");
}
[6]
Capítulo 1
10. Salve as alterações clicando no botão Salvar disponível logo acima do editor
de código.
11. Vamos tentar testar a função RegisterUser usando o console de Testes.
Clique na guia Testar para abrir o console de Testes:
12. Insira os valores para firstname e lastname na seção Corpo da solicitação:
Selecione POST no menu suspenso Método HTTP.
13. Depois de revisar os parâmetros de entrada, clique no botão Executar disponível

na parte inferior do console de Testes:
[7]
14. Se o workload da solicitação de entrada for transmitido corretamente com todos

os parâmetros necessários, você verá um Status 200 OK, e a saída na janela
Saída será conforme mostrado na captura de tela anterior.
Como funciona…
Criamos a primeira Função básica do Azure usando gatilhos HTTP e fizemos
algumas modificações no código padrão. O código apenas aceita os parâmetros
firstname e lastname e imprime o nome do usuário final com uma mensagem
Hello {firstname} {lastname} como resposta. Também aprendemos a testar
a função de gatilho de HTTP diretamente do portal de Gerenciamento do Azure.
Por uma questão de simplicidade, não executei validações

do parâmetro de entrada. Não se esqueça de validar todos
os parâmetros de entrada nos aplicativos em execução no
seu ambiente de produção.
Consulte também
A receita Permitir a autorização para aplicativos de função no Capítulo 9, Implementar práticas
recomendadas para o Azure Functions
Persistir detalhes de funcionários

usando associações de saída da tabela
de Armazenamento do Azure
Na receita anterior, você aprendeu a criar um gatilho de HTTP e aceitar os parâmetros
de entrada. Agora vamos trabalhar em algo interessante, ou seja, onde armazenar
os dados de entrada em um meio persistente. O Azure Functions oferece suporte
ao armazenamento de dados de várias formas. Para este exemplo, armazenaremos
os dados no armazenamento de Tabelas do Azure.
[8]
Capítulo 1
Preparação
Nesta receita, você verá como é fácil integrar um gatilho de HTTP e o serviço de
armazenamento de Tabelas do Azure usando associações de saída. A função de gatilho
de HTTP do Azure recebe os dados de várias fontes e armazena os dados do perfil
do usuário em uma tabela de armazenamento chamada tblUserProfile. Vamos
seguir os pré-requisitos listados abaixo:
• Nesta receita, vamos usar o mesmo gatilho de HTTP que criamos na receita
anterior.
• Vamos usar o Gerenciador de Armazenamento do Azure, que é uma
ferramenta que nos ajuda a trabalhar com os dados armazenados
na conta de Armazenamento do Azure. Faça download dele em
http://storageexplorer.com/.
• Você pode saber mais sobre como se conectar à Conta de Armazenamento
usando o Gerenciador de Armazenamento do Azure em https://docs.
microsoft.com/azure/vs-azure-tools-storage-manage-with-storage-
explorer.
Como fazer isso...

1. Navegue até a guia Integrar da função de gatilho de HTTP RegisterUser.

2. Clique no botão Nova Saída, selecione Armazenamento de Tabelas do Azure e,
em seguida, clique no botão Selecionar:
[9]
3. Você será solicitado a instalar as associações, clique em Instalar, o que levará

alguns minutos. Depois que as associações forem instaladas, escolha as seguintes
configurações das associações de saída do armazenamento de Tabelas do Azure:
°° Nome do parâmetro da tabela: este é o nome do parâmetro que você
usará no método Run da Função do Azure. Para este exemplo, forneça
objUserProfileTable como o valor.
°° Nome da tabela: uma nova tabela no armazenamento de Tabelas do
Azure será criada para persistir os dados. Se a tabela não existir ainda,
o Azure automaticamente criará uma para você! Para este exemplo,
forneça tblUserProfile como o nome da tabela.
°° Conexão da conta de armazenamento: se você não vir a string
de Conexão da conta de armazenamento, clique em nova (conforme
mostrado na captura de tela a seguir) para criar uma nova ou escolher
uma conta de armazenamento existente.
°° As associações de saída do armazenamento de Tabelas do Azure
devem ser conforme mostrado na captura de tela a seguir:
4. Clique em Salvar para salvar as alterações.

5. Navegue até o editor de código clicando no nome da função e cole o código
a seguir. Ele aceita a entrada transmitida pelo usuário final e a salva no
Armazenamento de Tabelas:
#r "Microsoft.WindowsAzure.Storage"
using System.Net;
using Microsoft.WindowsAzure.Storage.Table;
[ 10 ]
Capítulo 1

HttpRequest req,
CloudTable objUserProfileTable,
ILogger log)
{
request.");
ReadToEndAsync();
dynamic inputJson = JsonConvert.DeserializeObject(requestBody);
firstname = firstname ?? inputJson?.firstname;
lastname = inputJson?.lastname;
UserProfile objUserProfile = new UserProfile(firstname,
lastname);
TableOperation objTblOperationInsert = TableOperation.
Insert(objUserProfile);
await objUserProfileTable.ExecuteAsync(objTblOperationInsert);
? (ActionResult)new OkObjectResult($"Hello, {firstname + " " +
lastname}")
: new BadRequestObjectResult("Please pass a name on the query" +
}
class UserProfile : TableEntity

{
public UserProfile(string firstName,string lastName)
{
this.PartitionKey = "p1";
this.RowKey = Guid.NewGuid().ToString();
this.FirstName = firstName;
this.LastName = lastName;
}
UserProfile() { }
public string FirstName { get; set; }
public string LastName { get; set; }
}
[ 11 ]
6. Vamos executar a função clicando no botão Executar da guia Testar,

transmitindo os parâmetros firstname e lastname no Corpo da
solicitação:
7. Se tudo correr bem, você receberá uma mensagem Status 200 OK na caixa
Saída, conforme mostrado na captura de tela anterior. Vamos navegar até
o Gerenciador de Armazenamento do Azure e visualizar o armazenamento
de tabelas para ver se a tabela denominada tblUserProfile foi criada
com êxito:
[ 12 ]
Capítulo 1
Como funciona...
O Azure Functions nos permite integrar facilmente a outros serviços do Azure apenas
adicionando uma associação de saída ao gatilho. Para este exemplo, integramos o gatilho
de HTTP à associação de tabelas do Armazenamento do Azure e também configuramos
a conta de Armazenamento do Azure fornecendo a string de conexão de armazenamento
e o nome da tabela de Armazenamento do Azure na qual gostaríamos de criar um
registro para cada uma das solicitações HTTP recebidas pelo gatilho de HTTP.
Também adicionamos mais um parâmetro para lidar com o armazenamento de tabelas,

denominado objUserProfileTable, do tipo CloudTable, para o método Run.
Podemos executar todas as operações no armazenamento de Tabelas do Azure usando
objUserProfileTable.
Os parâmetros de entrada não estão validados no exemplo

de código. No entanto, no seu ambiente de produção, é
importante validá-los antes de armazená-los em qualquer
tipo de meio persistente.
Também criamos um objeto UserProfile, que foi preenchido com os valores recebidos
no objeto de solicitação e, em seguida, transmitido a uma operação de tabela.
Você pode saber mais sobre como lidar com operações no serviço
de armazenamento de Tabelas do Azure em https://docs.
microsoft.com/en-us/azure/storage/storage-dotnet-
how-to-use-tables.
[ 13 ]
Noções básicas sobre a conexão de

armazenamento
Quando você criar uma nova conexão de armazenamento (consulte a etapa 3 da seção
Como fazer isso... desta receita), novas Configurações de aplicativo serão criadas:
Você pode navegar até as Configurações de aplicativo clicando no menu Configurações

de aplicativo disponível na seção CONFIGURAÇÕES GERAIS da guia Recursos
da plataforma:
[ 14 ]
Capítulo 1
O que é o serviço de armazenamento de Tabelas do

Azure?
O serviço de armazenamento de Tabelas do Azure é um meio persistente de chave-valor
NoSQL para armazenar dados semiestruturados.
Saiba mais sobre ele em https://azure.microsoft.com/

services/storage/tables/.
Chave de partição e chave de linha

A chave primária da tabela do armazenamento de Tabelas do Azure tem duas partes:
• Chave de partição: os registros do armazenamento de Tabelas do Azure são

classificados e organizados em partições. Todo registro localizado em uma
partição terá a mesma chave de partição (p1 no nosso exemplo).
• Chave de linha: um valor exclusivo deve ser atribuído a cada uma das linhas.
E mais...
A seguir, as primeiras linhas do código nesta receita:
#r "Newtonsoft.json"
As linhas de código anteriores instruem a função de tempo de execução a incluir uma

referência à biblioteca especificada para o contexto atual.
Salvar as imagens de perfil em Filas

usando Associações de saída de fila
Na receita anterior, você aprendeu a receber dois parâmetros de cadeia de caracteres,
firstname e lastname, no Corpo da solicitação e armazená-los no armazenamento
de Tabelas do Azure. Nesta receita, vamos adicionar um novo parâmetro chamado
ProfilePicUrl para a imagem de perfil do usuário que é acessível publicamente
por meio da Internet. Você aprenderá a receber uma URL de uma imagem e salvá-la
no contêiner de Blob de uma conta de Armazenamento do Azure.
[ 15 ]
Talvez você esteja pensando que o parâmetro de entrada ProfilePicUrl poderia ter
sido usado para fazer download da imagem da Internet na receita anterior, Persistir
detalhes de funcionários usando associações de saída da tabela de Armazenamento do Azure. Não
fizemos isso porque o tamanho das imagens de perfil pode ser enorme com a tecnologia
moderna, portanto, o processamento de imagens em tempo real nas solicitações HTTP
pode prejudicar a performance do aplicativo em geral. Por esse motivo, vamos apenas
pegar a URL da imagem de perfil e armazená-la na Fila. Posteriormente, podemos
processar a imagem e armazená-la no Blob.
Preparação
Vamos atualizar o código da função RegisterUser que usamos nas receitas anteriores.
Como fazer isso…

1. Navegue até a guia Integrar da função de gatilho de HTTP RegisterUser.

2. Clique no botão Nova Saída, selecione Armazenamento de Filas do Azure e,
em seguida, clique no botão Selecionar.
3. Forneça os seguintes parâmetros nas configurações de saída do Armazenamento
de Filas do Azure:
°° Nome do parâmetro da mensagem: defina o nome do parâmetro como
objUserProfileQueueItem, que será usado no método Run
°° Nome da fila: defina o valor do Nome da fila como
userprofileimagesqueue
°° Conexão da conta de armazenamento: selecione a conta de
armazenamento certa no campo Conexão da conta de armazenamento
4. Clique em Salvar para criar a nova associação de saída.

5. Navegue de volta para o editor de código clicando no nome da função
(RegisterUser neste exemplo) ou no arquivo run.csx e faça as alterações
marcadas em negrito no código abaixo:
HttpRequest req,
IAsyncCollector<string> objUserProfileQueueItem,
ILogger log)
{
....
[ 16 ]
Capítulo 1
string firstname= inputJson.firstname;

string profilePicUrl = inputJson.ProfilePicUrl;
await objUserProfileQueueItem.AddAsync(profilePicUrl);
....
objUserProfileTable.Execute(objTblOperationInsert);
}
6. No código anterior, acrescentamos Associações de Saída de Fila, adicionando

o parâmetro IAsyncCollecter ao método Run e apenas transmitindo a
mensagem necessária ao método AddAsync. As associações de saída salvarão o
ProfilePicUrl na Fila. Agora, clique em Salvar para salvar as alterações de
código no editor de código do arquivo run.csx.
7. Vamos testar o código adicionando outro parâmetro, ProfilePicUrl, ao Corpo
da solicitação e, em seguida, clicar no botão Executar na guia Testar da janela
do editor de código da Função do Azure. A imagem usada no JSON a seguir
pode não existir quando você estiver lendo este livro. Portanto, forneça uma URL
válida da imagem:
{
"firstname": "Bill",
"lastname": "Gates",
"ProfilePicUrl":"https://upload.wikimedia.org/wikipedia/
commons/1/19/Bill_Gates_June_2015.jpg"
}
8. Se tudo correr bem, você verá a mensagem Status 200 OK, em seguida,
a URL da imagem que você transmitiu como um parâmetro de entrada
no Corpo da solicitação será criada como uma Mensagem da fila no
serviço de Fila de Armazenamento do Azure. Vamos navegar até o
Gerenciador de Armazenamento do Azure e visualizar a Fila chamada
userprofileimagesqueue, que é o Nome da fila que fornecemos na etapa 3.
Veja a seguir uma captura de tela da Mensagem da fila que foi criada:
[ 17 ]
Como funciona…
Nesta receita, adicionamos a associação de saída da Mensagem da fila e fizemos
as seguintes alterações no código:
• Adicionamos um novo parâmetro denominado out string

objUserProfileQueueItem, que é usado para associar a URL da imagem
de perfil como um conteúdo da Mensagem da fila
• Usamos o método AddAsync do IAsyncCollector para o método Run,
que salva a URL do perfil na Fila como uma Mensagem da fila.
Armazenar a imagem no Armazenamento

de Blobs do Azure
Na receita anterior, armazenamos a URL da imagem na mensagem da fila. Vamos
aprender a acionar uma Função do Azure (Gatilho de Fila) quando um novo item da fila
for adicionado ao serviço de Fila de Armazenamento do Azure. Cada mensagem na Fila
é a URL da imagem de perfil de um usuário, que será processada pelo Azure Functions
e armazenada como um Blob no serviço de Armazenamento de Blobs do Azure.
Preparação
Na receita anterior, aprendemos a criar Associações de saída de fila. Nesta receita, você
vai pegar a URL da Fila, criar uma matriz de bytes e, em seguida, gravá-la em um Blob.
Esta receita é uma continuação das receitas anteriores. Verifique se você as implementou.
Como fazer isso...

1. Crie uma nova Função do Azure escolhendo o Gatilho do Armazenamento

de Filas do Azure entre os modelos.
2. Fornece os seguintes detalhes depois de escolher o modelo:
°° Nomeie sua função: forneça um nome significativo, como
CreateProfilePictures.
[ 18 ]
Capítulo 1
°° Nome da fila: nome da Fila userprofileimagesqueue. Isso será

monitorado pela Função do Azure. Nossa receita anterior criou um novo
item para cada uma das solicitações válidas que chegaram ao gatilho de
HTTP (chamado RegisterUser) na Fila userprofileimagesqueue.
Para cada nova entrada de uma mensagem da fila nesse Armazenamento
de filas, o gatilho CreateProfilePictures será executado
automaticamente.
°° Conexão da conta de armazenamento: conexão da conta de
armazenamento em que as Filas estão localizadas.
3. Revise todos os detalhes e clique em Criar para criar a nova função.

4. Navegue até a guia Integrar, clique em Nova Saída, escolha Armazenamento
de Blobs do Azure e, em seguida, clique no botão Selecionar.
5. Na seção Saída do Armazenamento de Blobs do Azure, forneça o seguinte:
°° Nome do parâmetro do Blob: defina como outputBlob
°° Caminho: defina como userprofileimagecontainer/{rand-guid}
°° Conexão da conta de armazenamento: escolha a conta de armazenamento
em que gostaria de salvar os Blobs e clique no botão Salvar:
6. Clique no botão Salvar para salvar todas as alterações.

7. Substitua o código padrão do arquivo run.csx da função
CreateProfilePictures pelo código a seguir. Esse código pega a URL da Fila,
cria uma matriz de bytes e, em seguida, grava-a em um Blob:
using System;
public static void Run(Stream outputBlob,string
myQueueItem,
TraceWriter log)
{
byte[] imageData = null;
using (var wc = new System.Net.WebClient())
[ 19 ]
{
imageData = wc.DownloadData(myQueueItem);
}
outputBlob.WriteAsync(imageData,0,imageData.Length);
}
8. Clique no botão Salvar para salvar as alterações. Verifique se não há nenhum

erro de compilação na janela Logs:
9. Vamos voltar para a função RegisterUser e testá-la fornecendo os campos

firstname, lastname e ProfilePicUrl como fizemos na receita Salvar
as imagens de perfil em Filas usando Associações de saída de fila.
10. Navegue até o Gerenciador de Armazenamento do Azure e observe o contêiner
de Blob userprofileimagecontainer. Você encontrará um novo Blob:
11. Você pode exibir a imagem em qualquer ferramenta (como MS Paint ou Internet
Explorer).
Como funciona...
Criamos um gatilho de Fila que é executado conforme e quando uma nova mensagem
chega na Fila. Ao encontrar uma nova Mensagem da fila, ele lê a mensagem e, como
sabemos, ela é uma URL de uma imagem de perfil. A função realiza uma solicitação
de cliente Web, faz download dos dados da imagem na forma de uma matriz de bytes e,
em seguida, grava-os no Blob que é configurado como um Blob de saída.
[ 20 ]
Capítulo 1
E mais...
O parâmetro rand-guid gerará um novo GUID e é atribuído ao Blob que é criado
sempre que o gatilho é acionado.
É obrigatório especificar o nome do contêiner de Blob no parâmetro

Path da associação de saída do armazenamento de Blobs ao configurar
a saída do armazenamento de Blobs. O Azure Functions criará um
automaticamente se ele não existir.
Você pode usar Mensagens de fila somente quando quiser armazenar
mensagens de até 64 KB. Se quiser armazenar mensagens maiores
que 64 KB, você precisará usar o Barramento de Serviço do Azure.
[ 21 ]
Trabalhar com notificações
usando os serviços
SendGrid e Twilio
Neste capítulo, vamos ver como:
• Enviar uma notificação por email ao administrador de um site usando

o serviço SendGrid
• Enviar uma notificação por email dinamicamente ao usuário final
• Implementar log de email no Armazenamento de Blobs do Azure
• Modificar o conteúdo do email para incluir um anexo
• Enviar uma notificação por SMS ao usuário final usando o serviço Twilio
Introdução
Para todos os aplicativos de negócios executarem suas operações comerciais
perfeitamente, um dos recursos fundamentais é ter um sistema de comunicação confiável
entre a empresa e seus clientes. O canal de comunicação pode ser bidirecional, enviando
uma mensagem aos administradores que gerenciam o aplicativo ou enviando alertas aos
clientes por email ou SMS para seus celulares.
O Azure pode se integrar a dois serviços de comunicação populares: o SendGrid para

emails e o Twilio para trabalhar com SMS. Neste capítulo, usaremos esses dois serviços
de comunicação para aprender a aproveitar seus serviços básicos a fim de enviar
mensagens entre administradores de negócios e usuários finais.
[ 23 ]
Trabalhar com notificações usando os serviços SendGrid e Twilio
Abaixo está a arquitetura que usaremos para utilizar as associações de saída do SendGrid
e do Twilio com o Gatilho HTTP e o Gatilho de Fila.
Enviar uma notificação por email

ao administrador de um site usando
o serviço SendGrid
Nesta receita, você aprenderá a criar uma associação de saída do SendGrid e enviar
uma notificação por email, com conteúdo estático, ao administrador do site. Nosso caso
de uso envolve apenas um administrador, portanto, vamos codificar o endereço de
email do administrador no campo Endereço do destinatário da associação de saída do
SendGrid (message).
Preparação
Vamos executar as seguintes etapas antes de passar para a próxima seção:
1. Criar uma chave de API de conta do SendGrid a partir do portal de

Gerenciamento do Azure
2. Gerar uma chave de API a partir do portal SendGrid
3. Configurar a chave de API do SendGrid com o aplicativo de Função do Azure
Criar uma conta do SendGrid

1. Navegue até o portal de Gerenciamento do Azure e crie uma conta de Entrega

de Email do SendGrid procurando por ele no Marketplace, conforme mostrado
na captura de tela a seguir:
[ 24 ]
Capítulo 2
2. Na folha Entrega de Email do SendGrid, clique no botão Criar para navegar até
Criar uma Nova Conta do SendGrid. Selecione gratuito nas opções da Camada
de preços, forneça todos os outros detalhes e, em seguida, clique no botão Criar,
conforme mostrado na captura de tela a seguir:
[ 25 ]
Até o momento da redação deste livro, a conta gratuita do

SendGrid permite enviar 25.000 emails gratuitos por mês.
Se quiser enviar mais emails, você pode obter uma conta
de nível Silver S2 , na qual terá 100.000 emails por mês.
3. Depois que a conta for criada com êxito, navegue até Contas do SendGrid.
Você pode usar a caixa de pesquisa disponível na parte superior, conforme
mostrado na captura de tela a seguir:
4. Navegue até Configurações, escolha Configurações e copie o NOME DE

USUÁRIO e o SERVIDOR DO SMTP da folha Configurações, conforme
[ 26 ]
Capítulo 2
Gerar uma chave de API a partir do portal SendGrid

1. Para utilizar a conta do SendGrid no tempo de execução das Funções do

Azure, precisamos fornecer a chave de API do SendGrid como uma entrada
para as Funções do Azure. Você pode gerar uma chave de API a partir do portal
SendGrid. Vamos navegar até o portal SendGrid clicando no botão Gerenciar
na folha Essentials da Conta do SendGrid, como mostrado na captura de tela
a seguir:
2. No portal SendGrid, clique em Chaves de API na seção Configurações do menu

à esquerda, como mostrado na captura de tela a seguir:
3. Na página Chaves de API, clique em Criar Chave de API, conforme mostrado

abaixo:
[ 27 ]
4. Na janela pop-up Criar Chave de API, forneça um nome e escolha Permissões

da Chave de API, em seguida, clique no botão Criar e Exibir.
5. Em instantes, você verá a chave de API. Clique na chave para copiá-la para a área
de transferência, como mostrado na captura de tela a seguir:
Configurar a chave de API do SendGrid com

o aplicativo de Função do Azure
1. Crie novas Configurações de aplicativo no aplicativo de Função do Azure

navegando até a folha Configurações de aplicativo, na seção Recursos da
plataforma do aplicativo de função, conforme mostrado captura de tela a seguir:
2. Clique no botão Salvar depois de adicionar as Configurações de aplicativo

da etapa anterior.
Como fazer isso...

Nesta seção, vamos fazer o seguinte.
1. Criar associação de Fila de Armazenamento para o Gatilho HTTP

2. Criar Gatilho de Fila para processar a mensagem do Gatilho HTTP
3. Criar associação de saída do SendGrid para o Gatilho de Fila
4. Criar associação de saída do Twilio para o Gatilho de Fila
[ 28 ]
Capítulo 2
Criar associação de Fila de Armazenamento para o

Gatilho HTTP
1. Navegue até a guia Integrar da função RegisterUser e clique no botão Nova

Saída para adicionar uma nova associação de saída.
2. Escolha Armazenamento de Filas do Azure, clique no botão Selecionar para
adicionar a associação e fornecer os valores mostrados abaixo e, em seguida,
clique no botão Salvar. Pense no Nome da fila (neste caso notificationqueue)
que será usado em instantes.
3. Navegue até o método Run da função RegisterUser e faça as seguintes

alterações destacadas. Adicionamos outra Associação de saída de fila e uma
mensagem vazia para acionar a função de Gatilho de Fila. Por enquanto, não
adicionamos nenhuma mensagem à fila. Vamos fazer alterações no método
NotificationQueueItem.AddAsync(""); na próxima receita do capítulo.

HttpRequest req,
IAsyncCollector<string> objUserProfileQueueItem,
IAsyncCollector<string> NotificationQueueItem,
ILogger log)
{
log.LogInformation("C# HTTP trigger function processed
a request.");
...
...
await NotificationQueueItem.AddAsync("");
? (ActionResult)new OkObjectResult($"Hello, {firstname + "
" + lastname}")
: new BadRequestObjectResult("Please pass a name on the
[ 29 ]
query" +
}
Criar Gatilho de Fila para processar a mensagem

do Gatilho HTTP
1. Crie um Gatilho de Armazenamento de Filas do Azure escolhendo o modelo
mostrado abaixo.
2. Na próxima etapa, forneça todo o nome do Gatilho de Fila e o nome da fila que
precisa ser monitorada para enviar as notificações. Depois de fornecer todos
os detalhes, clique no botão Criar para criar a Função.
[ 30 ]
Capítulo 2
3. Depois de criar a função de Gatilho de Fila, vamos executar a função

RegisterUser para ver se o Gatilho de Fila está sendo invocado. Abra
a função RegisterUser em uma nova guia e teste-a clicando no botão
Executar. Na janela Logs da guia SendNotifications, você verá algo como
o que é mostrado a seguir:
Depois de garantir que o Gatilho de Fila está funcionando conforme o esperado, vamos
criar as associações do SendGrid para enviar o email.
Criar associação de saída do SendGrid para

o Gatilho de Fila
1. Navegue até a guia Integrar da função SendNotifications e clique no botão
Nova Saída para adicionar uma nova associação de saída.
2. Escolha a associação do SendGrid e clique no botão Selecionar para adicioná-la.
3. A próxima etapa é instalar as extensões do SendGrid. Clique no botão Instalar
para instalar as extensões. Pode levar alguns minutos para instalá-las.
4. Forneça os seguintes parâmetros na associação de saída do SendGrid (message):
°° Nome do parâmetro da mensagem: deixe o valor padrão, que é

message. Usaremos esse parâmetro no método Run daqui a pouco.
°° Chave de API do SendGrid: escolha a chave Configurações de
aplicativo que você criou nas Configurações de aplicativo para
armazenar a Chave de API do SendGrid.
°° Endereço do destinatário: forneça o endereço de email do administrador.
°° Endereço do remetente: forneça o endereço de email de onde você quer
enviar o email. Pode ser algo como donotreply@example.com.
[ 31 ]
°° Assunto da mensagem: forneça o assunto que você quer que seja exibido
no assunto do email.
°° Texto da Mensagem: forneça o texto que você quer incluir no corpo
do email.
5. A associação de saída do SendGrid (message) deve ser ter esta aparência depois
do fornecimento de todos os campos:
6. Depois de revisar os valores, clique em Salvar para salvar as alterações.

7. Navegue até o método Run das funções SendNotifications e faça as seguintes
alterações:
°° Adicione uma nova referência para o SendGrid, juntamente com
o namespace SendGrid.Helpers.Mail.
°° Adicione uma nova mensagem de parâmetro de saída do tipo
SendGridMessage.
°° Crie um objeto do tipo SendGridMessage. Veremos como usar esse
objeto na próxima receita.
8. A seguir está o código completo do método Run:

#r "SendGrid"
using System;
using SendGrid.Helpers.Mail;
public static void Run(string myQueueItem,out SendGridMessage

message, ILogger log)
{
log.LogInformation($"C# Queue trigger function processed:
[ 32 ]
Capítulo 2
{myQueueItem}");
message = new SendGridMessage();
}
9. Agora, vamos testar a funcionalidade de envio do email navegando até a função

RegisterUser e enviando uma solicitação com alguns valores de teste,
da seguinte maneira:
{
"firstname": "Bill",
"lastname": "Gates",
"ProfilePicUrl":"https://upload.wikimedia.org/
wikipedia/commons/thumb/1/19/
Bill_Gates_June_2015.jpg/220px-
Bill_Gates_June_2015.jpg"
}
Como funciona...
O objetivo desta receita é enviar uma notificação via email ao administrador, informando
que um novo registro foi criado com êxito.
Usamos uma das associações de saída da Função do Azure, denominada SendGrid,

como um servidor do Protocolo SMTP para enviar nossos emails, codificando as
seguintes propriedades nas associações de saída do SendGrid (message):
• O endereço de email "de"

• O endereço de email "para"
• O assunto do email
• O corpo do email
As associações de saída do SendGrid (message) usarão a chave de API fornecida nas

Configurações de aplicativo para invocar as APIs necessárias da biblioteca do SendGrid
para enviar os emails.
[ 33 ]
E mais
Ao adicionar as associações do SendGrid, você será solicitado a instalar as Extensões,
como mostrado abaixo.
Se não forem exibidas, exclua a associação de saída e recrie-a. Você também pode
instalar as extensões manualmente seguindo as instruções mencionadas no artigo
https://docs.microsoft.com/azure/azure-functions/install-update-
binding-extensions-manual.
Enviar uma notificação por email

dinamicamente ao usuário final
Na receita anterior, codificamos a maioria dos atributos relacionados ao envio de um
email a um administrador, pois havia apenas um administrador. Nesta receita, vamos
modificar a receita anterior para enviar um email Thank you for registration
aos próprios usuários.
Preparação
Verifique se os seguintes itens estão configurados corretamente:
• A conta do SendGrid foi criada e uma chave de API foi gerada no portal
SendGrid.
• Configurações de aplicativo foram criadas nas Configurações de aplicativo
do aplicativo de função.
• A chave Configurações de aplicativo foi configurada nas associações de saída
do SendGrid (message).
[ 34 ]
Capítulo 2
Como fazer isso...

Nesta receita, atualizaremos o código no arquivo run.csx das seguintes Funções
do Azure
• RegisterUser
• SendNotifications
Aceitar o novo Parâmetro de email na função

RegisterUser
1. Navegue até a função RegisterUser, no arquivo run.csx, adicione uma

nova variável de string que aceite um novo parâmetro de entrada, denominado
email, do objeto request, da seguinte maneira. Além disso, observe que
estamos serializando o objeto UserProfile e armazenando o conteúdo JSON
na Mensagem da fila:
string firstname=null,lastname = null, email = null;
...
...
string email = inputJson.email;
...
...
UserProfile objUserProfile = new UserProfile(firstname,
lastname,email);
...
...
await
NotificationQueueItem.AddAsync(JsonConvert.SerializeObject(objUser
Profile));
2. Atualize o seguinte código destacado para a classe UserProfile e clique no

botão Salvar para salvar as alterações:
public class UserProfile : TableEntity
{
public UserProfile(string firstname,string lastname,
string profilePicUrl,string email)
{
....
....
this.ProfilePicUrl = profilePicUrl;
this.Email = email;
}
....
....
public string ProfilePicUrl {get; set;}
[ 35 ]
public string Email { get; set; }

}
Recuperar as informações de UserProfile no gatilho

de SendNotifications
Execute as seguintes etapas
1. Navegue até a função SendNotifications, no arquivo run.csx, adicione a

referência NewtonSoft.Json e também o namespace.
2. O Gatilho de Fila receberá a entrada na forma de cadeia de caracteres JSON.
Usaremos o método JsonConvert.Deserializeobject para converter a
cadeia de caracteres em um objeto dinâmico para que possamos recuperar
as propriedades individuais. Substitua o código existente pelo código a
seguir no qual estamos preenchendo dinamicamente as propriedades do
SendGridMessage do código.
#r "SendGrid"
using System;
public static void Run(string myQueueItem,

out SendGridMessage message,
ILogger log)
{
log.LogInformation($"C# Queue trigger function processed:
{myQueueItem}");
dynamic inputJson = JsonConvert.DeserializeObject(myQueueItem);
string FirstName=null, LastName=null, Email = null;
FirstName=inputJson.FirstName;
LastName=inputJson.LastName;
Email=inputJson.Email;
log.LogInformation($"Email{inputJson.Email}, {inputJson.FirstName
+ " " + inputJson.LastName}");
message = new SendGridMessage();
message.SetSubject("New User got registered successfully.");
message.SetFrom("donotreply@example.com");
message.AddTo(Email,FirstName + " " + LastName);
message.AddContent("text/html", "Thank you " + FirstName + " " +
LastName +" so much for getting registered to our site.");
}
[ 36 ]
Capítulo 2
3. Vamos executar um teste adicionando um novo email de campo de entrada à

carga de solicitação do teste, da seguinte maneira:
{
"firstname": "Praveen",
"lastname": "Sreeram",
"email":"example@gmail.com",
"ProfilePicUrl":"A Valid url here"
}
4. Esta é a captura de tela do email que recebi:
Como funciona...
Atualizamos o código da função RegisterUser para aceitar outro novo parâmetro,
denominado email.
A função aceita o parâmetro email e envia o email ao usuário final usando a API
do SendGrid. Também configuramos todos os outros parâmetros, como endereço
From, Subject e corpo (conteúdo) no código, de modo que ele seja personalizado
dinamicamente com base nos requisitos.
[ 37 ]
Também podemos limpar os campos nas associações de saída do SendGrid, conforme

Os valores especificados no código terão precedência sobre

os valores especificados na etapa anterior.
E mais...
Você também pode enviar conteúdo HTML no corpo da mensagem para tornar seu email
mais atraente. A seguir, um exemplo simples, em que acabei de aplicar uma marca de
negrito () ao nome do usuário final:
message.AddContent("text/html", "Thank you " + FirstName + "
" + LastName +" so much for getting registered to our site.");
Abaixo, a captura de tela do email, com o meu nome em negrito:
[ 38 ]
Capítulo 2
Implementar log de email no

Armazenamento de Blobs do Azure
A maioria dos aplicativos de negócios de emails automatizados provavelmente envolverá
o envio de emails contendo notificações, alertas e assim por diante, ao usuário final.
Às vezes, os usuários podem reclamar que não receberam nenhum email, mesmo que
não vejamos nenhum erro no aplicativo ao enviar esses alertas de notificação.
Pode haver vários motivos pelos quais os usuários não receberam o email. Cada
provedor de serviço de email tem filtros de spam diferentes que podem bloquear
os emails da caixa de entrada do usuário final. Mas esses emails podem ter informações
importantes das quais os usuários podem precisar. Faz sentido armazenar o conteúdo
de todos os emails enviados aos usuários finais, para que possamos recuperar os dados
posteriormente, a fim de solucionar quaisquer problemas imprevistos.
Nesta receita, você aprenderá a criar um novo arquivo de log de email com a extensão
.log para cada novo registro. Esse arquivo de log pode ser usado como uma
redundância para os dados armazenados no Armazenamento de tabelas. Você também
aprenderá a armazenar os arquivos de log de email como um Blob em um contêiner
de armazenamento, juntamente com os dados inseridos pelo usuário final durante
o registro.
Como fazer isso...

1. Navegue até a guia Integrar da função SendNotifications, clique em

Nova Saída e escolha Armazenamento de Blobs do Azure. Você será solicitado
a instalar as Extensões de Armazenamento. Instale-as para continuar.
2. Forneça os parâmetros necessários na seção de saída do Armazenamento
de Blobs do Azure, como mostrado na captura de tela a seguir. Observe
a extensão .log no campo Caminho:
[ 39 ]
3. Navegue até o editor de código do arquivo run.csx da função

SendNotifications e faça as seguintes alterações:
1. Adicione um novo parâmetro outputBlob do tipo TextWriter
ao método Run.
2. Adicione uma nova variável de string chamada emailContent. Essa
variável é usada para enquadrar o conteúdo do email. Também usaremos
a mesma variável para criar o conteúdo do arquivo de log que será
finalmente armazenado no blob.
3. Enquadre o conteúdo do email acrescentando o texto estático necessário
e os parâmetros de entrada recebidos no Corpo da solicitação,
TextWriter outputBlob,
ILogger log)
....
....
string FirstName=null, LastName=null, Email = null;
string emailContent;
....
....
emailContent = "Thank you " + FirstName + " " +
LastName +" for your registration. " +
"Below are the details that you have provided
us "+ "First name: " +
FirstName + " " + "Last name: " +
LastName + " " + "Email Address: " +
inputJson.Email + " " + "Best Regards," +
" " + "Website Team";
message.AddContent(new
Content("text/html",emailContent));
outputBlob.WriteLine(emailContent);
4. Execute um teste usando a mesma carga de solicitação que usamos na receita

anterior.
5. Depois de executar o teste, o arquivo de log será criado no contêiner denominado
userregistrationemaillogs:
[ 40 ]
Capítulo 2
Como funciona...
Criamos novas associações de saída de Blobs do Azure. Assim que uma nova solicitação
é recebida, o conteúdo do email é criado e gravado em um novo arquivo .log (observe
que você pode usar qualquer outra extensão também) que é armazenado como um Blob
no contêiner especificado no campo Caminho das associações de saída.
Modificar o conteúdo do email para

incluir um anexo
Nesta receita, você aprenderá a enviar um arquivo como um anexo ao usuário registrado.
Em nossa receita anterior, criamos um arquivo de log do conteúdo do email. Enviaremos
o mesmo arquivo como um anexo ao email. No entanto, em aplicações reais, talvez você
não pretenda enviar arquivos de log ao usuário final. Por uma questão de simplicidade,
enviaremos o arquivo de log como um anexo.
Até o momento da redação deste livro, o SendGrid recomenda

que o tamanho do anexo não exceda 10 MB, embora
tecnicamente, seu email possa ter até 20 MB.
[ 41 ]
Preparação
Esta é uma continuação da receita anterior. Se você estiver lendo isto primeiro, veja
as receitas anteriores deste capítulo antes.
Como fazer isso...

Precisaremos executar as seguintes etapas antes de passar para a próxima seção:
1. Faça as alterações no código para criar um arquivo de log com o RowKey

da tabela. Conseguiremos isso usando a interface IBinder.
2. Envie esse arquivo como um anexo ao email.
Personalizar o nome do arquivo de log usando

a interface IBinder
1. Navegue até o arquivo run.csx da função SendNotifications.

2. Remova o objeto TextWriter e substitua-o pelo associador de variáveis
do tipo IBinder. A seguir, a nova assinatura do método Run com as alterações
destacadas:
#r "SendGrid"
#r "Microsoft.Azure.WebJobs.Extensions.Storage"
using System;
using Microsoft.Azure.WebJobs.Extensions.Storage;
IBinder binder,
ILogger log)
3. Removemos o objeto TextWriter. A função outputBlob.

WriteLine(emailContent); não funcionará mais. Vamos substituí-la pelo
código a seguir:
using (var emailLogBloboutput = binder.
Bind<TextWriter>(new
BlobAttribute($"userregistrationemaillogs/
{objInsertedUser.RowKey}.log")))
{
emailLogBloboutput.WriteLine(emailContent);
}
[ 42 ]
Capítulo 2
4. Vamos executar um teste usando a mesma carga de solicitação que usamos nas
receitas anteriores.
5. Você pode ver o arquivo de log de email que é criado usando o RowKey do novo
registro armazenado no armazenamento de Tabelas do Azure, como mostrado
Adicionar um anexo ao email

1. Adicione o seguinte código ao método Run da função SendNotifications

e salve as alterações clicando no botão Salvar:
message.AddAttachment(FirstName +"_"+LastName+".log",
System.Convert.
ToBase64String(System.Text.Encoding.UTF8.GetBytes(emailContent)),
"text/plain",
"attachment",
"Logs"
);
2. Execute um teste usando a mesma carga de solicitação que usamos nas receitas
anteriores.
[ 43 ]
3. Esta é a captura de tela do email, juntamente com o anexo:
Saiba mais sobre a API do SendGrid em

https://sendgrid.com/docs/API_Reference/api_v3.html
Enviar uma notificação por SMS

ao usuário final usando o serviço Twilio
Na maioria das receitas anteriores deste capítulo, trabalhamos com gatilhos de SendGrid
para enviar emails em diferentes cenários. Nesta receita, você aprenderá a enviar
notificações via SMS, usando uma das principais plataformas de comunicação na nuvem,
denominada Twilio.
Você também pode saber mais sobre o

Twilio em
https://www.twilio.com/.
[ 44 ]
Capítulo 2
Preparação
Para usar a associação de saída de SMS do Twilio (objsmsmessage), precisamos fazer
o seguinte:
1. Crie uma conta de trial do Twilio em https://www.twilio.com/try-twilio.

2. Após a criação bem-sucedida da conta, copie o SID DA CONTA e o TOKEN
DE AUTENTICAÇÃO do Painel do Twilio, como mostrado na captura de tela
a seguir. Vamos criar duas Configurações de aplicativo na folha Configurações
de aplicativo do aplicativo de função para estas duas configurações:
3. Para começar a enviar mensagens, é necessário criar um número ativo no Twilio,

que será usado como o Número do remetente para o envio do SMS. Você pode
criar e gerenciar números no Painel de Números de Telefone. Navegue até
https://www.twilio.com/console/phone-numbers/incoming e clique
no botão Começar, como mostrado na captura de tela a seguir:
[ 45 ]
4. Na página Começar com Números de Telefone, clique em Obter seu primeiro

número de telefone do Twilio, como mostrado na captura de tela a seguir:
5. Assim que obter seu número, ele será listado da seguinte maneira:
6. A etapa final é verificar um número ao qual você gostaria de enviar um SMS.

Você pode ter apenas um número na sua conta de trial. É possível verificar um
número na página Verificada do Twilio, disponível em https://www.twilio.
com/console/phone-numbers/verified. Veja uma captura de tela da lista
de números verificados:
[ 46 ]
Capítulo 2
Como fazer isso...

1. Navegue até a folha Configurações de aplicativo do aplicativo de função

e adicione duas chaves para armazenar TwilioAccountSID e TwilioAuthToken,
2. Vá para a guia Integrar da função SendNotifications, clique em Nova Saída

e escolha SMS do Twilio.
3. Clique em Selecionar e forneça os seguintes valores às associações de saída
de SMS do Twilio. Instale as extensões do Twilio. O Número do remetente
é aquele que é gerado no portal do Twilio, que discutimos na seção Preparação
desta receita:
4. Navegue até o editor de código e adicione as seguintes linhas de código,

destacadas em negrito. No código abaixo, codifiquei o Número do destinatário.
No entanto, em cenários reais, você receberia dinamicamente o número
de celular do usuário final e enviaria o SMS via código:
...
...
#r "Twilio"
#r "Microsoft.Azure.WebJobs.Extensions.Twilio"
...
...
using Microsoft.Azure.WebJobs.Extensions.Twilio;
using Twilio.Rest.Api.V2010.Account;
using Twilio.Types;
[ 47 ]

IBinder binder,
out CreateMessageOptions objsmsmessage,
ILogger log)
...
...
...
message.AddAttachment(FirstName +"_"+LastName+".log",
System.Convert.ToBase64String(System.Text.Encoding.UTF8.
GetBytes(emailContent)),
"text/plain",
"attachment",
"Logs"
);
objsmsmessage = new CreateMessageOptions(new

PhoneNumber("+91 98492*****"));
objsmsmessage.Body = "Hello.. Thank you for getting
registered.";
}
5. Agora, faça uma execução de teste da função RegisterUser usando a mesma

carga de solicitação.
6. Esta é a captura de tela do SMS que recebi:
[ 48 ]
Capítulo 2
Como funciona...
Criamos uma nova conta do Twilio e copiamos a ID da conta e a chave do aplicativo nas
Configurações de aplicativo do aplicativo de Função do Azure. Essas duas configurações
serão usadas pelo tempo de execução do aplicativo de função para se conectar à API do
Twilio a fim de enviar o SMS.
Por uma questão de simplicidade, codifiquei o número de telefone nas associações

de saída. No entanto, em aplicações reais, você enviaria o SMS ao número de telefone
fornecido pelos usuários finais.
Você pode assistir ao vídeo https://www.youtube.com/watch?v=ndxQXnoDIj8 para

ver uma implementação funcional.
[ 49 ]
Integração perfeita do Azure
Functions com os Serviços
do Azure
Neste capítulo, vamos abordar as seguintes receitas:
• Usar os Serviços Cognitivos para localizar rostos em imagens

• Interações do Banco de dados SQL do Azure usando o Azure Functions
• Monitorar Tweets com Aplicativos Lógicos e notificar quando um usuário
popular tweetar
• Integrar Aplicativos Lógicos com funções sem servidor
• Auditar dados do Cosmos DB usando gatilhos de feed de alterações
Introdução
Um dos principais objetivos do Azure Functions é permitir que os desenvolvedores
se concentrem apenas na lógica e nos requisitos do desenvolvimento de aplicativos
sem se preocupar com o restante.
Como um desenvolvedor ou usuário empresarial, você não consegue criar e desenvolver

seus próprios aplicativos do zero para cada uma das suas necessidades de negócios.
Primeiro, você precisa pesquisar os sistemas existentes para verificar se eles são
adequados para seus requisitos de negócios. Muitas vezes, não é fácil entender as APIs
dos outros sistemas e integrá-las, pois elas foram desenvolvidas por outra pessoa.
[ 51 ]
Integração perfeita do Azure Functions com os Serviços do Azure
O Azure fornece muitos conectores que você pode utilizar para integrar seus aplicativos
de negócios com outros sistemas com muita facilidade.
Neste capítulo, veremos como é fácil integrar os diferentes serviços disponíveis

no ecossistema do Azure.
Usar os Serviços Cognitivos para

localizar rostos em imagens
Aqui, você aprenderá a usar a API da Pesquisa Visual Computacional para detectar
rostos em uma imagem. Vamos localizar rostos, capturar suas coordenadas e salvá-los
em diferentes áreas do Armazenamento de Tabelas do Azure com base no gênero.
Preparação
Para começar, precisamos criar uma API da Pesquisa Visual Computacional e configurar
suas chaves de API para que o Azure Functions (ou qualquer outro programa) possa
acessá-la de maneira programática.
Verifique se você tem o Gerenciador de Armazenamento do Azure instalado e também

se configurou o acesso à área de armazenamento na qual está fazendo upload dos blobs.
Criar uma nova conta da API da Pesquisa Visual

Computacional
1. Procure visão computacional e clique em Criar.

2. A próxima etapa é fornecer todos os detalhes para criar uma conta da API da
Pesquisa Visual Computacional. No momento da redação deste e-book, a API
da Pesquisa Visual Computacional tinha apenas dois tipos de preço. Eu escolhi
o gratuito, F0, que permite 20 chamadas de API por minuto e é limitado a 5.000
chamadas por mês.
[ 52 ]
Capítulo 3
Definir as configurações do aplicativo

1. Após a geração da conta da API da Pesquisa Visual Computacional, navegue

até a folha Chaves e escolha uma das seguintes chaves:
2. Navegue até o aplicativo do Azure Functions, defina as Configurações do

aplicativo com o nome Vision_API_Subscription_Key e use qualquer uma
das chaves anteriores como o valor. Essa chave será usada pelo Azure Functions
Runtime para se conectar e consumir a API dos Serviços Cognitivos da Pesquisa
Visual Computacional.
3. Anote o local onde você está criando o serviço de Pesquisa Visual
Computacional. No meu caso, o local escolhido foi a Europa Ocidental.
Quando você está transmitindo as imagens para a API dos Serviços Cognitivos,
é importante garantir que o ponto de extremidade da API comece com o nome do
local. Seria algo assim: https://westeurope.api.cognitive.microsoft.
com/vision/v1.0/analyze?visualFeatures=Faces&language=en.
Como fazer isso...

1. Crie uma nova função usando um dos modelos padrão chamados de Gatilho
de Armazenamento de Blobs do Azure.
[ 53 ]
2. Em seguida, é necessário fornecer o nome da Função do Azure junto com

o Caminho e a Conexão da conta de armazenamento. Carregaremos uma
imagem no contêiner do Gatilho de Armazenamento de Blobs do Azure
(imagem) (mencionado no parâmetro Caminho na captura de tela a seguir)
no final desta seção:
Ao criar a função, o modelo cria uma associação de saída da Tabela

de Armazenamento de Blobs e nos permite fornecer o nome do parâmetro
Nome da tabela. No entanto, não é possível atribuir o nome do parâmetro
durante a criação da função. Poderemos alterá-lo depois que ele for criado.
Depois de revisar todos os detalhes, clique no botão Criar para criar a Função
do Azure.
3. Após a criação da função, navegue até a guia Integrar, clique em Nova Saída
e escolha Armazenamento de Tabelas do Azure. Em seguida, clique no botão
Selecionar. Forneça os valores de parâmetro e clique no botão Salvar, como
mostrado na seguinte captura de tela:
[ 54 ]
Capítulo 3
4. Vamos criar outra associação de saída do Armazenamento de Tabelas do Azure

para armazenar todas as informações de mulheres. Para isso, é necessário clicar
no botão Nova Saída na guia Integrar, selecionar Armazenamento de Tabelas
do Azure e clicar no botão Selecionar. Veja como ela ficará após o fornecimento
dos valores de entrada:
5. Depois de revisar todos os detalhes, clique no botão Salvar para criar

a associação de saída do Armazenamento de Tabelas do Azure e armazene
os detalhes sobre as mulheres.
[ 55 ]
6. Navegue até o editor de código do método Run da função

LocateMaleFemaleFaces. Em seguida, adicione os parâmetros outMaleTable
e outFemaleTable. O código a seguir captura o fluxo de imagens carregado
no blob, que é então transmitido como uma entrada para os Serviços Cognitivos,
que retorna um JSON com todas as informações dos rostos. Após o recebimento
das informações dos rostos, incluindo as coordenadas e os detalhes de gênero,
armazenamos as coordenadas dos rostos no respectivo Armazenamento
de Tabelas usando as associações de saída da tabela:
using Microsoft.WindowsAzure.Storage.Table;
using System.IO;
using System.Net;
using System.Net.Http;
using System.Net.Http.Headers;
public static async Task Run(Stream myBlob,
string name,
IAsyncCollector<FaceRectangle>
outMaleTable,
IAsyncCollector<FaceRectangle>
outFemaleTable,
ILogger log)
{
log.LogInformation($"C# Blob trigger function Processed blob\n
Name:{name} \n Size: {myBlob.Length} Bytes");
string result = await CallVisionAPI(myBlob);
log.LogInformation(result);
if (String.IsNullOrEmpty(result))
{
return;
}
ImageData imageData = JsonConvert.DeserializeObject<ImageData>
(result);
foreach (Face face in imageData.Faces)
{
var faceRectangle = face.FaceRectangle;
faceRectangle.RowKey = Guid.NewGuid().ToString();
faceRectangle.PartitionKey = "Functions";
faceRectangle.ImageFile = name + ".jpg";
if(face.Gender=="Female")
{
await outFemaleTable.AddAsync(faceRectangle);
[ 56 ]
Capítulo 3
}
Else
{
await outMaleTable.AddAsync(faceRectangle);
}
}
}
static async Task<string> CallVisionAPI(Stream image)
{
using (var client = new HttpClient())
{
var content = new StreamContent(image);
var url = "https://westeurope.api.cognitive.microsoft.com/
vision/v1.0/analyze?visualFeatures=Faces&language=en";
client.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-
Key", Environment.GetEnvironmentVariable("Vision_API_Subscription_
Key"));
content.Headers.ContentType = new MediaTypeHeaderValue("ap
plication/octet-stream");
var httpResponse = await client.PostAsync(url, content);
if (httpResponse.StatusCode == HttpStatusCode.OK)
{
return await httpResponse.Content.ReadAsStringAsync();
}
}
return null;
}
public class ImageData
{
public List<Face> Faces { get; set; }
}
public class Face
{
public int Age { get; set; }
public string Gender { get; set; }
public FaceRectangle FaceRectangle { get; set; }
}
public class FaceRectangle : TableEntity
{
public string ImageFile { get; set; }
public int Left { get; set; }
public int Top { get; set; }
public int Width { get; set; }
public int Height { get; set; }}
[ 57 ]
7. Vamos adicionar uma condição (destacada em negrito no código mencionado

na Etapa 10) para verificar o gênero e, com base nele, armazenar as informações
no respectivo Armazenamento de Tabelas.
8. Crie um novo contêiner de blobs chamado images usando o Gerenciador
de Armazenamento do Azure, como mostrado na captura de tela a seguir:
9. Vamos carregar uma imagem com rostos masculinos e femininos no contêiner

chamado images usando o Gerenciador de Armazenamento do Azure, como
mostrado aqui:
[ 58 ]
Capítulo 3
10. A função é acionada assim que você carrega uma imagem. Este é o JSON que
foi registrado no console Logs da função:
{
"requestId":"483566bc-7d4d-45c1-87e2-6f894aaa4c29",
"metadata":{ },
"faces":[
{
"age":31,
"gender":"Female",
"faceRectangle":{
"left":535,
"top":182,
"width":165,
"height":165
}
},
{
"age":33,
"gender":"Male",
"faceRectangle":{
"left":373,
"top":182,
"width":161,
"height":161
}
}
]
}
Se você é um desenvolvedor de front-end com especialização em

tecnologias HTML5 e relacionadas a telas, pode até mesmo desenhar
quadrados que localizam os rostos na imagem usando as informações
fornecidas pelos Serviços Cognitivos.
[ 59 ]
11. A função também criou duas tabelas de Armazenamento de Tabelas do Azure,

como mostrado aqui:
Como funciona...
Primeiro criamos uma associação de saída do Armazenamento de Tabelas para
armazenar detalhes sobre todos os homens nas fotos. Em seguida, criamos outra
associação de saída do Armazenamento de Tabelas para armazenar os detalhes sobre
todas as mulheres.
Usamos todos os códigos padrão que o modelo do Azure Functions fornece para
armazenar todas as coordenadas dos rostos em uma única tabela. Entretanto, acabamos
de fazer uma pequena alteração para verificar se a pessoa na foto é homem ou mulher
e armazenar os dados com base no resultado.
Lembre-se de que a identificação do gênero correto feita pelas APIs não

é totalmente precisa. Então, você deve ter um mecanismo de fallback em
seus ambientes de produção para gerenciar tais situações.
E mais...
Para invocar a API da Pesquisa Visual Computacional, o código padrãoque o modelo
fornece transmite a imagem que carregamos para o armazenamento de blobs.
Para invocar a chamada de API, os modelos de localizador de rostos transmitem
o parâmetro visualFeatures=Faces, que retorna informações sobre:
• Idade
• Gênero
• Coordenadas dos rostos na foto
[ 60 ]
Capítulo 3
Saiba mais sobre a API da Pesquisa Visual Computacional em https://

docs.microsoft.com/azure/cognitive-services/computer-
vision/home.
Use a função Environment.GetEnvironmentVariable("KeyName") para recuperar

as informações armazenadas nas configurações do aplicativo. Nesse caso, o método
CallVisionAPI usa a função para recuperar a chave, que é essencial para fazer uma
solicitação aos Serviços Cognitivos da Microsoft.
Uma prática recomendada é armazenar todas as chaves e outras

informações confidenciais nas configurações do aplicativo.
ICollector e IAsyncCollector são usadas para inserção em massa

de dados.
Interações do Banco de dados SQL

do Azure usando o Azure Functions
Até agora, você aprendeu a armazenar dados nos serviços de Armazenamento do
Azure, como blobs, filas e tabelas. Todos esses serviços de armazenamento são ótimos
para armazenar dados não estruturados ou semiestruturados. No entanto, talvez seja
necessário armazenar dados em sistemas de gerenciamento de banco de dados relacional,
como um Banco de Dados SQL do Azure.
Aqui, você aprenderá a utilizar a API ADO.NET para se conectar a um Banco de Dados
SQL e inserir dados JSON em uma tabela chamada EmployeeInfo.
Preparação
Navegue até o Portal do Azure e faça o seguinte:
1. Crie um SQL Server lógico com o nome que você escolher. É recomendável
criá-lo no mesmo grupo de recursos em que você colocou o Azure Functions.
2. Crie um Banco de Dados SQL do Azure chamado Cookbookdatabase. Para
fazer isso, escolha Banco de dados em branco no menu suspenso Selecionar
origem da folha do Banco de Dados SQL ao criar o banco de dados.
[ 61 ]
3. Crie uma regra de firewall para seu endereço IP clicando no botão Definir regra
de firewall na folha Visão geral. Assim, você poderá se conectar aos Bancos
de Dados SQL do Azure usando o SQL Server Management Studio (SSMS).
Se você não tem o SSMS, instale a versão mais recente. Faça download dele
em https://docs.microsoft.com/sql/ssms/download-sql-server-
management-studio-ssms.
4. Clique no link Mostrar cadeias de conexão de banco de dados na folha do
Essentials do Banco de Dados SQL, como mostrado na captura de tela a seguir:
5. Copie a cadeia de conexão da folha a seguir. Substitua os modelos

your_username e your_password pelo seu nome de usuário e senha reais:
[ 62 ]
Capítulo 3
6. Abra o SSMS e conecte-se ao SQL Server lógico do Azure que você criou nas
etapas anteriores.
7. Quando estiver conectado, crie uma nova tabela chamada EmployeeInfo
usando o seguinte esquema:
CREATE TABLE [dbo].[EmployeeInfo](
[PKEmployeeId] [bigint] IDENTITY(1,1) NOT NULL,
[firstname] [varchar](50) NOT NULL,
[lastname] [varchar](50) NULL,
[email] [varchar](50) NOT NULL,
[devicelist] [varchar](max) NULL,
CONSTRAINT [PK_EmployeeInfo] PRIMARY KEY CLUSTERED
(
[PKEmployeeId] ASC
)
)
Como fazer isso...

1. Navegue até seu aplicativo de função, crie um novo gatilho HTTP usando
o modelo HttpTrigger-CSharp, escolha o Nível de autorização como Anônimo.
2. Navegue até o editor de código de run.csx na função
SaveJSONToAzureSQLDatabase e substitua o código padrão pelo que será
mostrado a seguir. Este código captura os dados que são transmitidos para
o gatilho HTTP e os insere no banco de dados usando a API ADO.Net:
#r "System.Data"
using System.Net;
using System.Data.SqlClient;
using System.Data;
public static async Task<IActionResult> Run(HttpRequest req,

ILogger log)
{
[ 63 ]

request.");
string firstname,lastname, email, devicelist;

ReadToEndAsync();
dynamic data = JsonConvert.DeserializeObject(requestBody);
firstname = data.firstname;
lastname = data.lastname;
email = data.email;
devicelist = data.devicelist;
SqlConnection con =null;

Try
{
string query = "INSERT INTO EmployeeInfo
(firstname,lastname, email, devicelist) " + "VALUES (@firstname,@
lastname, @email, @devicelist) ";
con = new
SqlConnection("Server=tcp:azurecookbooks.database.
windows.net,1433;Initial Catalog=Cookbookdatabase;Persist Security
Info=False;User ID=username;Password=password;MultipleActiveResu
ltSets=False;Encrypt=True;TrustServerCertificate=False;Connection
Timeout=30;");
SqlCommand cmd = new SqlCommand(query, con);
cmd.Parameters.Add("@firstname", SqlDbType.VarChar,
50).Value = firstname;
cmd.Parameters.Add("@lastname", SqlDbType.VarChar,
50)
.Value = lastname;
cmd.Parameters.Add("@email", SqlDbType.VarChar, 50)
.Value = email;
cmd.Parameters.Add("@devicelist", SqlDbType.VarChar)
.Value = devicelist;
con.Open();
cmd.ExecuteNonQuery();
}
catch(Exception ex)
{
log.LogInformation(ex.Message);
}
Finally
{
[ 64 ]
Capítulo 3
if(con!=null)
{
con.Close();
}
}
return (ActionResult)new OkObjectResult($"Successfully

inserted the data.");
Você precisa validar cada um dos parâmetros de entrada. Para simplificar, o código que
valida os parâmetros de entrada não está incluído. Valide cada um dos parâmetros antes
de salvá-los no seu banco de dados. Também é uma prática recomendada armazenar
a cadeia de conexão nas configurações do aplicativo.
3. Vamos executar o gatilho HTTP usando os seguintes dados de teste diretamente

do console de teste do Azure Functions:
{
"firstname": "Praveen",
"lastname": "Kumar",
"email": "praveen@example.com",
"devicelist":
"[
{
'Type' : 'Mobile Phone',
'Company':'Microsoft'
},
{
'Type' : 'Laptop',
'Company':'Lenovo'
}
]"
}
Você precisa validar cada um dos parâmetros de entrada. Para simplificar, o código que
valida os parâmetros de entrada não está incluído. Valide cada um dos parâmetros antes
de salvá-los no seu banco de dados.
[ 65 ]
4. Um registro foi inserido com êxito, como mostrado na captura de tela a seguir:
Como funciona...
O objetivo aqui era aceitar valores de entrada do usuário e salvá-los em um banco
de dados relacional onde os dados pudessem ser recuperados posteriormente para fins
operacionais. Para isso, usamos o Banco de Dados SQL do Azure, uma oferta de banco
de dados relacional também conhecida como banco de dados como serviço (DBaaS).
Criamos um novo Banco de Dados SQL e regras de firewall com as quais podemos nos
conectar remotamente da estação de trabalho de desenvolvimento local usando o SSMS.
Também criamos uma tabela chamada EmployeeInfo, que pode ser usada para salvar
dados.
Com a API ADO.NET, desenvolvemos um programa simples que se conecta ao Banco

de Dados SQL do Azure e insere dados na tabela EmployeeInfo.
Monitorar Tweets com Aplicativos

Lógicos e notificar quando um usuário
popular tweetar
Um dos meus colegas, que trabalha para um projeto de gestão de queixas sociais,
é responsável por monitorar os problemas que os usuários postam em plataformas
de mídia social, como Facebook, Twitter etc. Ele estava enfrentando um problema
de monitoramento contínuo de Tweets publicados no identificador do Twitter de seu
cliente com hashtags específicas. Sua principal tarefa era responder rapidamente aos
Tweets de usuários com uma quantidade enorme de seguidores, por exemplo, usuários
com mais de 50.000 seguidores. Então, ele estava procurando uma solução para manter
o monitoramento de uma hashtag específica e alertá-lo sempre que um usuário com
mais de 50.000 seguidores tweetar. Assim, sua equipe poderia responder rapidamente
a esse usuário.
[ 66 ]
Capítulo 3
Para simplificar, a condição verificará 200 seguidores, e não 50.000.
Antes de conhecer os Aplicativos Lógicos do Azure, eu pensava que levaria algumas

semanas para aprender, desenvolver, testar e implantar essa solução. Obviamente, levaria
um bom tempo para aprender, entender e consumir a API do Twitter (ou de qualquer
outro canal social) para obter as informações necessárias e criar uma solução completa
que resolvesse o problema.
Felizmente, depois de conhecer os Aplicativos Lógicos e seus conectores prontos para

uso, a criação de uma solução para o problema do meu amigo leva pouco menos
de 10 minutos.
Aqui, você aprenderá a criar um Aplicativo Lógico que se integre com o Twitter
(para monitorar Tweets) e o Gmail (para enviar emails).
Preparação
Para trabalhar com esse método, precisamos de:
• Uma conta válida do Twitter

• Uma conta válida do Gmail
Ao trabalhar com o método, precisaremos autorizar os Aplicativos Lógicos do Azure

a acessar suas contas.
Como fazer isso...

Seguiremos as seguintes etapas:
1. Crie um novo Aplicativo Lógico

2. Projete-o com conectores do Twitter e do Gmail
3. Teste-o tweetando com a hashtag específica
Criar um novo Aplicativo Lógico

1. Faça logon no Portal de Gerenciamento do Azure, procure aplicativos

lógicos e selecione Aplicativo Lógico.
[ 67 ]
2. Na folha Criar aplicativo lógico, depois de fornecer o Nome, Grupo de recursos,

Assinatura e Local, clique no botão Criar para criar o Aplicativo Lógico:
[ 68 ]
Capítulo 3
Criar o Aplicativo Lógico com conectores do Twitter

e do Gmail
1. Depois de criar o Aplicativo Lógico, navegue até Designer de aplicativos lógicos

e escolha Aplicativo Lógico em Branco.
2. Em seguida, você deverá escolher Conectores. Na lista de Conectores, clique
em Twitter. Em seguida, você deverá se conectar ao Twitter fornecendo as
credenciais da sua conta na rede social. Se você já se conectou, verá diretamente
a lista de gatilhos associados ao conector do Twitter, como mostrado na captura
de tela a seguir:
3. Depois de clicar no gatilho do Twitter, você deverá informar o Texto da

pesquisa (por exemplo, hashtags e palavras-chave) e a Frequência com que
o Aplicativo Lógico deverá pesquisar os Tweets. Veja como ficarão os campos
depois que você informar os detalhes:
[ 69 ]
4. Vamos adicionar uma nova condição. Para isso, é necessário clicar em Próxima
etapa, procurar condição e selecionar a ação Condição, como mostrado
5. A partir da instrução anterior, a tela a seguir será exibida, onde você poderá
escolher os valores para a condição e o que gostaria de adicionar quando
a condição for avaliada como true ou false:
[ 70 ]
Capítulo 3
6. Ao clicar no campo de entrada Escolher um valor, você receberá todos os

parâmetros em que poderia adicionar uma condição. Neste caso, precisamos
escolher Número de seguidores, como mostrado na captura de tela a seguir:
7. Depois de escolher o parâmetro Número de seguidores, crie uma condição

(O número de seguidores é maior ou igual a 200), como mostrado na captura
de tela a seguir:
[ 71 ]
8. Na seção If true da Condição anterior, procure a conexão do Gmail e selecione

Gmail | Enviar email, como mostrado na captura de tela a seguir:
9. Será solicitado que você faça logon, caso ainda não tenha feito. Forneça suas
credenciais e autorize os Aplicativos Lógicos do Azure a acessar sua conta
do Gmail.
10. Após a autorização, você poderá marcar seu email com Adicionar conteúdo
dinâmico com os parâmetros do Twitter, como mostrado na captura de tela
a seguir:
[ 72 ]
Capítulo 3
Se a opção Número de seguidores não
aparecer na tela, clique no link Mostrar mais.
11. Quando terminar, clique no botão Salvar.
Testar a funcionalidade do Aplicativo Lógico

1. Vamos publicar um Tweet com a hashtag #AzureFunctions, como mostrado

na captura de tela a seguir.
[ 73 ]
2. Depois de aproximadamente um minuto, o Aplicativo Lógico será acionado.

Vamos navegar até a folha Visão geral do Aplicativo Lógico e visualizar
o Histórico de execuções:
3. Ótimo! Ele foi acionado duas vezes, e eu recebi os emails. Um deles é mostrado
Como funciona...
Você criou um novo Aplicativo Lógico e escolheu o conector do Twitter para monitorar
os Tweets publicados com a hashtag #AzureFunctions uma vez por minuto. Se houver
Tweets com essa hashtag, ele verificará se o número de seguidores é maior ou igual
a 200. Se o número de seguidores atender à condição, uma nova ação será criada com
um novo conector do Gmail que poderá enviar um email com o conteúdo dinâmico
que está sendo moldado usando os parâmetros do conector do Twitter.
Integrar Aplicativos Lógicos com

funções sem servidor
Você já sabe como integrar conectores diferentes usando Aplicativos Lógicos. Aqui,
implementaremos a mesma solução implementada no método anterior apenas movendo
a lógica condicional que verifica o número de seguidores para o Azure Functions.
[ 74 ]
Capítulo 3
Preparação
Antes de avançar, seguiremos as seguintes etapas:
1. Crie uma conta SendGrid (se já não tiver sido criada), pegue a chave da API
SendGrid e crie uma nova chave nas Configurações do aplicativo de função.
2. Instale o Postman para testar o gatilho HTTP. Você pode fazer download
da ferramenta em https://www.getpostman.com/.
Como fazer isso...

1. Crie uma nova função escolhendo o gatilho HTTP e chame-a de

ValidateTwitterFollowerCount.
2. Navegue até a guia Integrar e adicione uma nova associação de saída, SendGrid,
clicando no botão Nova Saída:
3. Substitua o código padrão pelo que será mostrado a seguir e clique em Salvar.
Este código apenas verifica o número de seguidores . Se for maior que 200,
ele enviará um email:
#r "SendGrid"
using System.Net;
[ 75 ]
public static async Task<IActionResult> Run(HttpRequest req, IAsyn
cCollector<SendGridMessage> messages, ILogger log)
{
request.");
string name = req.Query["name"];

ReadToEndAsync();
string strTweet = "";

SendGridMessage message = new SendGridMessage();
if(data.followersCount >= 200)
{
strTweet = "Tweet Content" + data.tweettext;
message.SetSubject($"{data.Name} with {data.

followersCount} followers has posted a tweet");
message.SetFrom("donotreply@example.com");
message.AddTo("prawin2k@gmail.com");
message.AddContent("text/html", strTweet);
}
Else
{
message = null;
}
await messages.AddAsync(message);
return (ActionResult)new OkObjectResult($"Hello");
}
4. Teste a função usando o Postman. Para isso, escolha os parâmetros destacados na

captura de tela a seguir. Nas próximas etapas, depois de integrarmos a Função
ValidateTwitterFollowerCount do Azure, todos os parâmetros de entrada a
seguir, como followersCount, tweettext e Name, serão postados pelo conector
do Twitter do Aplicativo Lógico:
[ 76 ]
Capítulo 3
5. Crie um novo Aplicativo Lógico chamado

NotifywhenTweetedbyPopularUserUsingFunctions.
6. Comece a criar o aplicativo com o modelo Aplicativo Lógico em Branco,
escolha o conector do Twitter e configure o Texto da pesquisa, a Frequência
e o Intervalo.
7. Clique em Nova etapa para adicionar uma ação. Na seção Escolher uma ação,
selecione o Azure Functions como um conector, como mostrado na captura
de tela a seguir:
[ 77 ]
8. Quando você clicar no Azure Functions, serão listados todos os aplicativos

de função do Azure disponíveis, como mostrado na captura de tela a seguir:
9. Clique no aplicativo de função no qual você criou a função

ValidateTwitterFollowerCount. Agora, selecione a função
ValidateTwitterFollowerCount, como mostrado na captura de tela a seguir:
[ 78 ]
Capítulo 3
10. Na próxima etapa, é necessário preparar a entrada JSON que precisa

ser transmitida do Aplicativo Lógico para a função do gatilho HTTP
ValidateTwitterFollowerCount que desenvolvemos. Vamos moldar
a entrada JSON da mesma maneira que fizemos ao testar a função do gatilho
HTTP usando o Postman, como mostrado na captura de tela a seguir (a única
diferença é que os valores, como followersCount, Name e tweettext,
agora são dinâmicos):
11. Depois que você revisar todos os parâmetros que a função

ValidateTwitterFollowerCount espera, clique no botão Salvar
para salvar as alterações.
12. Você pode aguardar alguns minutos ou publicar um Tweet com a hashtag
que configurou no campo de entrada Texto da pesquisa.
E mais...
Se você não visualizar o parâmetro dinâmico pretendido, clique no botão Ver mais,
como mostrado na captura de tela a seguir:
[ 79 ]
Na função ValidateTwitterFollowerCount do Azure, codificamos

o limite de número de seguidores como 200. Uma prática recomendada
é armazenar esses valores como itens configuráveis nas Configurações
do aplicativo.
Consulte também
• Consulte Enviar uma notificação por email para o usuário final de modo dinâmico
no Capítulo 2, Trabalhar com notificações usando os serviços SendGrid e Twilio
Auditar dados do Cosmos DB usando

gatilhos de feed de alterações
Muitos de vocês já devem ter ouvido falar no Cosmos DB, pois ele se tornou muito
popular, e muitas organizações o utilizam devido aos recursos que ele oferece.
Aqui, aprenderemos sobre a integração do Azure Functions sem servidor com um

banco de dados NoSQL sem servidor no Cosmos DB. Saiba mais sobre o Cosmos DB
em https://docs.microsoft.com/azure/cosmos-db/introduction.
Muitas vezes, pode ser necessário manter logs de alterações de campos, atributos,
documentos e muito mais para fins de auditoria. No mundo dos bancos de dados
relacionais, você pode ter visto desenvolvedores usando gatilhos ou procedimentos
armazenados para implementar esse tipo de funcionalidade de auditoria, na qual
você escreve o código para armazenar dados em uma tabela de auditoria separada.
Aqui, veremos como é fácil concretizar o caso de uso anterior e auditar as coleções
do Cosmos DB escrevendo uma função simples que será acionada sempre que houver
uma alteração em um documento de uma coleção do Cosmos DB.
No mundo dos bancos de dados relacionais, uma coleção é o mesmo que

uma tabela, e um documento é o mesmo que um registro.
Preparação
Para começar, primeiro precisamos:
• Criar uma conta do Cosmos DB

• Criar uma nova coleção do Cosmos DB em que é possível armazenar dados na
forma de documentos
[ 80 ]
Capítulo 3
Criar uma nova conta do Cosmos DB

Navegue até o Portal do Azure e crie uma nova conta do Cosmos DB. Você precisará
fornecer:
• Uma assinatura válida e um grupo de recursos.

• Um nome de conta válido. Isso criará um ponto de extremidade em
<<accountname>>.document.azure.com.
• Uma API — defina como SQL. Assim, você poderá gravar consultas no SQL.
Fique à vontade para testar outras APIs.
Criar uma nova coleção do Cosmos DB

1. Depois de criar a conta, você precisa criar um novo banco de dados e uma
coleção. Podemos criar ambos em uma única etapa diretamente do Portal.
2. Navegue até a guia Visão geral e clique no botão Adicionar coleção para criar
uma nova coleção:
3. Agora, você será direcionado à guia Data Explorer automaticamente, onde

deverá informar os seguintes detalhes:
Nome do campo Valor Comentário

ID do banco Contêiner de várias coleções
cookbookdatabase
de dados do Cosmos DB.
Nome da coleção em que você
ID da coleção cookbookdatacollection
armazenará os dados.
[ 81 ]
Nome do campo Valor Comentário

Dependendo dos seus workloads
Capacidade de de produção, poderá ser necessário
Fixa (10 GB)
armazenamento usar a capacidade Ilimitada. Caso
contrário, poderá haver partições.
Capacidade da sua coleção do
Taxa de Cosmos DB. A performance das
transferência leituras e gravações na coleção
400
(400 - 10.000 depende da taxa de transferência
RU/s) configurada ao provisionar a
coleção.
4. Em seguida, clique no botão OK para criar a coleção. Se tudo correr bem, você
verá algo assim na guia Data Explorer da conta do Cosmos DB:
Criamos uma conta do Cosmos DB e uma coleção. Agora, aprenderemos a integrar a

coleção com uma nova Função do Azure e veremos como acioná-la sempre que houver
uma alteração na coleção do Cosmos DB.
Como fazer isso...

1. Navegue até a conta do Cosmos DB e clique no menu Adicionar Função

do Azure na folha Todas as configurações da conta do Cosmos DB.
[ 82 ]
Capítulo 3
2. Agora, você será direcionado à folha Adicionar Função do Azure, onde escolherá
o aplicativo de função do Azure no qual gostaria de criar uma nova função
(gatilho do Cosmos DB) para ser acionada sempre que houver uma alteração
na coleção. Veja como isso será feito:
[ 83 ]
3. Depois de revisar os detalhes, clique no botão Salvar (mostrado na captura

de tela anterior) para criar a nova função, que será acionada a cada alteração
feita na coleção. Vamos navegar rapidamente para o aplicativo de função do
Azure (no meu caso, é AzureFunctionCookBookV2) e ver se a nova função
com o nome cookbookdatacollectionTrigger foi criada. Veja uma captura
de tela do meu aplicativo de função:
4. Substitua o código padrão pelo código a seguir do gatilho do Azure Functions

Cosmos DB, que obtém uma lista de todos os documentos que foram atualizados.
O código a seguir apenas imprime o número de documentos que foram
atualizados e o ID do primeiro documento no console Logs:
#r "Microsoft.Azure.DocumentDB.Core"
using System;
using System.Collections.Generic;
using Microsoft.Azure.Documents;
public static void Run(IReadOnlyList<Document> input, ILogger log)

{
[ 84 ]
Capítulo 3
if (input != null && input.Count > 0)

{
log.LogInformation("Documents modified " + input.Count);
log.LogInformation("First document Id " + input[0].Id);
}
}
5. A integração da coleção do Cosmos DB e da Função do Azure foi concluída.

Agora, vamos adicionar um novo documento à coleção e ver como
o gatilho é disparado na ação. Abra uma nova guia (deixando a guia
cookbookdatacollectionTrigger aberta no navegador), navegue até
a coleção e crie um novo documento clicando no botão Novo documento,
como mostrado na captura de tela a seguir:
6. Depois de substituir o JSON padrão (que tem apenas um atributo ID) pelo
JSON que possui os atributos necessários, clique no botão Salvar para salvar
as alterações, navegue rapidamente para a outra guia do navegador, onde
a Função do Azure está aberta, e exiba os logs para ver a saída da função.
Veja a seguir como ficaram meus logs. Acabei de adicionar um valor ao atributo
ID do documento. Ele pode parecer diferente para você, dependendo da
sua estrutura JSON:
[ 85 ]
Como funciona...
Para integrar o Azure Functions com o Cosmos DB, primeiro criamos uma conta do
Cosmos DB, além de um banco de dados e uma nova coleção nele. Depois que a coleção
foi criada, nós a integramos a partir do Portal do Azure clicando no botão Adicionar
Função do Azure, que está disponível no nível da conta do Cosmos DB. Escolhemos
o aplicativo de função necessário no qual queríamos criar um gatilho do Cosmos DB.
Depois que a integração foi concluída, criamos um exemplo de documento na coleção
do Cosmos DB e, em seguida, verificamos que a função foi acionada automaticamente
para todas as alterações (todas as leituras e gravações, mas não as exclusões) que
fizemos na coleção.
E mais...
Quando você integra o Azure Functions para rastrear alterações do Cosmos DB,
ele cria automaticamente uma nova coleção chamada locações, como mostrado
aqui. Lembre-se de que esse é um custo adicional, pois o custo no Cosmos DB
se baseia nas unidades de solicitação (RUs) alocadas para cada coleção:
É importante observar que o gatilho do Cosmos DB não seria acionado (no momento
da gravação) para nenhuma exclusão na coleção. Ele só é acionado para criações
e atualizações de documentos em uma coleção. Se for importante rastrear as exclusões,
você precisará fazer soft deletes, o que significa definir um atributo como IsDeleted
como true para registros que são excluídos pelo aplicativo e, com base no valor do
atributo isDeleted, implementar sua lógica personalizada no gatilho do Cosmos DB.
A integração que fizemos entre o Azure Functions e o Cosmos DB usa os feeds

de alterações do Cosmos DB. Saiba mais sobre os feeds de alterações aqui:
https://docs.microsoft.com/azure/cosmos-db/change-feed.
Não se esqueça de excluir a conta do Cosmos DB e suas coleções associadas se você

acredita que não as usará mais, pois as coleções são cobradas com base nas RUs alocadas,
mesmo que você não as utilize ativamente.
Se você não conseguir executar essa Função do Azure ou se receber um erro informando
que as extensões do Cosmos DB não estão instaladas, tente criar um novo gatilho
do Azure Cosmos DB, que deverá solicitar a instalação.
[ 86 ]
Noções básicas sobre
a experiência integrada
de desenvolvedor de
Ferramentas do Visual Studio
Neste capítulo, vamos abordar o seguinte:
• Criação de um aplicativo de função usando o Visual Studio 2017
• Depuração de C# do Azure Functions em um ambiente local de preparação
• Conexão à nuvem de armazenamento do Azure a partir do ambiente
local do Visual Studio
• Implantação do aplicativo Azure Functions para a Nuvem do Azure usando
o Visual Studio
• Depuração de C# do Azure Functions ao vivo, hospedada no ambiente
de Nuvem do Microsoft Azure, usando o Visual Studio
• Implantação do Azure Functions em um contêiner
Introdução
Nos capítulos anteriores, examinamos como criar o Azure Functions diretamente
do Portal de Gerenciamento do Azure. Aqui estão algumas das características:
• Você pode criar rapidamente uma função apenas selecionando um dos modelos
internos fornecidos pelo Tempo de Execução do Azure Functions
• Os desenvolvedores não precisam se preocupar em escrever o código de conexão
e compreender o funcionamento das estruturas
• As alterações de configuração podem ser feitas diretamente na interface
do usuário usando o editor padrão
[ 87 ]
Noções básicas sobre a experiência integrada de desenvolvedor de Ferramentas do Visual Studio
Apesar de todas as vantagens mencionadas, os desenvolvedores podem estranhar

caso estejam acostumados a trabalhar com os ambientes de desenvolvimento integrado
(IDEs) há muito tempo. A equipe da Microsoft apresentou algumas ferramentas que
ajudam os desenvolvedores a integrá-los no Visual Studio para que possam aproveitar
alguns dos recursos críticos do IDE que aceleram seus esforços de desenvolvimento.
Aqui estão alguns deles:
• Os desenvolvedores aproveitam o suporte do IntelliSense

• Você pode depurar o código linha por linha
• Visualize rapidamente os valores das variáveis, enquanto depura o aplicativo
• Integração com sistemas de controle de versão, como o Azure DevOps
(antes, ele era chamado de Visual Studio Team Services (VSTS))
Hoje, no momento que escrevo, as ferramentas do Visual Studio para a função

oferecem suporte à depuração somente para C#. No futuro, a Microsoft provavelmente
disponibilizará esses recursos para outros idiomas.
Você conhecerá alguns dos recursos já citados neste capítulo e verá como integrar
o código com o Azure DevOps no capítulo 11, Como implementar e implantar a integração
contínua usando o Azure DevOps.
Criação de um aplicativo de função

Nesta receita, você saberá como criar um Azure Functions para seu IDE favorito
no Visual Studio 2017.
Preparação
Você precisa fazer download e instalar as seguintes ferramentas e software:
1. Faça download da versão mais recente do Visual Studio 2017. Você pode fazer
download em https://visualstudio.microsoft.com/downloads/.
2. Durante a instalação, escolha desenvolvimento do Azure na seção Workloads,
conforme mostrado na captura de tela a seguir e clique no botão Instalar:
[ 88 ]
Capítulo 4
3. Navegue até Ferramentas | Extensões e Atualizações e veja se há atualizações

em Ferramentas do Visual Studio para o Azure Functions, conforme mostrado na
seguinte captura de tela:
[ 89 ]
Como fazer isso...

1. Abra o Visual Studio, escolha Arquivo e clique em Novo Projeto. Na caixa

de diálogo Novo Projeto, nos modelos Instalados, em Visual C#, selecione
Nuvem e, depois, o modelo Azure Functions:
2. Forneça o nome do aplicativo de função. Clique no botão OK para ir para

a próxima etapa. Conforme mostrado na captura de tela a seguir, escolha
Azure Funtions v2 (.NET Core) no menu suspenso, selecione Gatilho HTTP
e clique no botão OK:
[ 90 ]
Capítulo 4
3. Criamos com êxito o aplicativo Azure Functions , juntamente com um gatilho

HTTP (que aceita solicitações da Web e envia uma resposta ao cliente), com
o nome Function1. Sinta-se à vontade para alterar o nome padrão do aplicativo
de função e também certifique-se de criar o aplicativo para fazer download
dos pacotes NuGet necessários, se houver.
4. Depois de criar uma nova função, uma nova classe também será criada, conforme
Criamos com êxito um novo aplicativo de função acionado por HTTP usando o Visual
Studio 2017.
[ 91 ]
Como funciona...
Ferramentas do Visual Studio para o Azure Functions permitem que os desenvolvedores
utilizem seu IDE favorito, já utilizado há muito tempo. Com as ferramentas do Azure
Function, você pode usar o mesmo conjunto de modelos que o Portal de Gerenciamento
do Azure fornece para criar e integrar rapidamente com os serviços de nuvem sem
escrever códigos de conexão (ou mínimos).
A outra vantagem de usar ferramentas do Visual Studio para funções é que você
não precisa ter uma assinatura do Azure ao vivo. Você pode depurar e testar o Azure
Functions diretamente no ambiente de desenvolvimento local. A CLI do Azure e os
utilitários relacionados nos fornecem a assistência necessária para executar o Azure
Functions.
E mais...
Um dos problemas mais comuns enfrentados pelos desenvolvedores ao desenvolver
qualquer aplicativo no ambiente local é que tudo funciona bem na máquina local, mas não
no ambiente de produção. Os desenvolvedores não precisam se preocupar com isso no
caso do Azure Functions. O tempo de execução do Azure Functions fornecido pelas
ferramentas da CLI do Azure é exatamente igual ao tempo de execução disponível
na Nuvem do Azure.
Observe que você sempre poderá usar e acionar um serviço do Azure

em execução na nuvem, mesmo quando estiver desenvolvendo o Azure
Functions localmente.
Depuração de C# do Azure Functions em

um ambiente local de preparação usando
o Visual Studio 2017
Quando a configuração da criação de nossa função estiver concluída, a próxima etapa
será começar a desenvolver o aplicativo de acordo com suas necessidades. Desenvolver
códigos diariamente não é uma tarefa fácil; desenvolvedores acabam enfrentando todo
tipo de problema técnico. Eles precisam de ferramentas para ajudá-los a identificar
a causa raiz do problema e corrigi-lo para garantir que apresentem a solução. Essas
ferramentas incluem ferramentas de depuração que ajudam os desenvolvedores
a entrar em cada linha do código para exibir os valores da variável e os objetos,
além de obter uma exibição detalhada das exceções.
Nesta receita, você saberá como configurar e depurar o Azure Functions em um ambiente
de desenvolvimento local no Visual Studio.
[ 92 ]
Capítulo 4
Preparação
Faça download e instale a CLI do Azure (caso essas ferramentas não estejam instaladas,
note que o Visual Studio fará download automático delas quando você executar suas
funções a partir do Visual Studio).
Como fazer isso...

1. Em nossa receita anterior, criamos a função HTTPTrigger usando o Visual

Studio. Vamos compilar o aplicativo clicando em Criar e em Criar Solução.
2. Abra o arquivo HTTPTriggerCSharpFromVS.cs e crie um ponto de interrupção
pressionando a tecla F9, conforme mostrado na seguinte captura de tela:
[ 93 ]
3. Pressione a tecla F5 para começar a depurar a função. Quando você pressionar F5

pela primeira vez, o Visual Studio solicitará que faça download das ferramentas
CLI do Visual Studio se elas ainda não estiverem instaladas. Essas ferramentas
são essenciais para executar um Azure Functions no Visual Studio:
A CLI do Azure Functions foi renomeada como Azure Functions

Core Tools. Saiba mais sobre elas em https://www.npmjs.com/
package/azure-functions-core-tools.
4. Clique em Sim na captura de tela anterior para começar a fazer download das
ferramentas da CLI. O download e a instalação das ferramentas da CLI levarão
alguns minutos.
5. Após a instalação com êxito das ferramentas da CLI do Azure Functions,
um host de trabalho será criado e iniciado. Ele começa a monitorar solicitações
em uma porta específica para todas as funções do nosso aplicativo de função.
Esta é a captura de tela que mostra que o host de trabalho começou a monitorar
as solicitações para o aplicativo de função:
[ 94 ]
Capítulo 4
6. Vamos tentar acessar o aplicativo de função fazendo uma solicitação a

http://localhost:7071 no seu navegador favorito:
[ 95 ]
7. Algo essencial na URL completa do nosso gatilho HTTP é o navegador. Ela deve
ter esta aparência: http://localhost:7071/api/HttpTriggerCsharpFromV
S?name=Praveen Sreeram.
8. Depois de digitar a URL correta do Azure Functions, assim que pressionarmos
a tecla Enter na barra de endereços do navegador, o depurador do Visual Studio
atingirá o ponto de depuração (se você tiver um), conforme mostrado na seguinte
captura de tela:
9. Você também pode exibir os dados de suas variáveis, conforme mostrado na

seguinte captura de tela:
10. Depois de concluir a depuração, você pode clicar na tecla F5 para concluir o
processo de execução, após o qual você verá a resposta de saída no navegador,
conforme mostrado na seguinte captura de tela:
11. O log de execução da função aparecerá no console do host de trabalho, conforme

[ 96 ]
Capítulo 4
12. Você pode adicionar mais Azure Functions ao aplicativo de função,

se necessário. Na próxima receita, vamos examinar como se conectar
à nuvem de armazenamento do Azure a partir do ambiente local.
Como funciona...
O host de trabalho funciona como um servidor que escuta uma porta específica.
Se houver solicitações para essa porta específica, ele automaticamente cuidará
da execução das solicitações e enviará uma resposta.
O console de host de trabalho fornece os seguintes detalhes:
• O status da execução, juntamente com os dados de solicitação e resposta

• Os detalhes sobre todas as funções disponíveis no aplicativo de função
E mais...
Usando o Visual Studio, você pode criar diretamente funções pré-compiladas. Isso
significa que, quando você cria suas funções, o Visual Studio cria um arquivo .dll
que pode ser indicado em outros aplicativos, assim como você faz com suas classes
regulares. Estas são duas das vantagens de usar funções pré-compiladas:
• As funções pré-compiladas têm melhor performance, já que não precisam

ser compiladas em tempo real
• Você pode converter facilmente suas classes tradicionais em Azure Functions
e consultá-las em outros aplicativos sem problemas
[ 97 ]
Conexão à nuvem de armazenamento

do Azure a partir do ambiente local
do Visual Studio
Nas duas receitas anteriores, você aprendeu como criar e executar o Azure Functions
em um ambiente local. Acionamos a função de um navegador local. No entanto, nesta
receita, você aprenderá a disparar o Azure Functions em seu ambiente local quando
ocorre um evento no Azure. Por exemplo, quando um novo blob é criado em uma conta
de armazenamento do Azure, sua função pode ser disparada na máquina local. Isso ajuda
os desenvolvedores a testar seus aplicativos no início, antes de implantá-los no ambiente
de produção.
Preparação
Execute os seguintes pré-requisitos:
1. Crie uma conta de armazenamento e, em seguida, um contêiner

de blob denominado cookbookfiles, no Azure.
2. Instale o Gerenciador de Armazenamento do Microsoft Azure de
http://storageexplorer.com/.
Como fazer isso...

1. Abra o aplicativo Azure Functions FunctionAppInVisualStudio no

Visual Studio e, em seguida, adicione uma nova função clicando com o botão
direito no projeto FunctionAppInVisualStudio. Clique em Adicionar
| Nova Função do Azure, que abre um popup. Aqui, no campo de nome,
insira BlobTriggerCSharp e clique no botão Adicionar.
2. Isso abre outro popup, em que você pode fornecer outros parâmetros, como
[ 98 ]
Capítulo 4
3. Nas configurações de conexão da conta de armazenamento, forneça

AzureWebJobsStorage como o nome da cadeia de conexão e também forneça
o nome do contêiner de blob (no meu caso, ele é cookbookfiles) no campo
de entrada Caminho e, depois, clique no botão OK para criar a nova função
de gatilho de blob. Uma nova função de gatilho de blob é criada, conforme
mostrado nesta captura de tela:
[ 99 ]
4. Se estiver lembrado da receita do capítulo 1, Criar uma API Web de back-end

usando gatilhos HTTP, Desenvolver aplicativos de nuvem usando associações e gatilhos
de função, o portal de gerenciamento do Azure nos permitiu escolher entre uma
conta de armazenamento nova ou existente. No entanto, a caixa de diálogo
anterior não está conectada à sua assinatura do Azure. Portanto, você precisa
navegar até a conta de armazenamento e copiar a cadeia de conexão, que pode ser
encontrada na folha de Chaves de acesso da conta de armazenamento no Portal
de gerenciamento do Azure, conforme mostrado na seguinte captura de tela:
5. Cole a cadeia de conexão no arquivo local.settings.json, que está na

pasta raiz do projeto. Este arquivo é criado quando você cria o aplicativo
de função. Após você adicionar a cadeia de conexão à chave denominada
AzureWebJobsStorage, o arquivo local.settings.json deverá ter esta
aparência na seguinte captura de tela:
6. Abra o arquivo BlobTriggerCSharp.cs e crie um ponto de interrupção,

[ 100 ]
Capítulo 4
7. Agora pressione a tecla F5 para iniciar o host de trabalho, conforme mostrado

na seguinte captura de tela:
8. Adicionei um novo arquivo de blob usando o Explorador de armazenamento

do Azure, conforme mostrado nesta captura de tela:
[ 101 ]
9. Assim que o blob for adicionado ao contêiner especificado (neste caso, ele é
cookbookfiles), que está na nuvem em um local remoto, o host de trabalho em
execução no meu computador local detectará que um novo blob foi adicionado
e o depurador atingiu a função, como mostrado na seguinte captura de tela:
Como funciona...
Nesta classe BlobTriggerCSharp, o método Run tem os atributos WebJobs com uma
cadeia de conexão (neste caso, ela é AzureWebJobsStorage). Isso orienta o tempo
de execução a referenciar a cadeia de conexão do armazenamento do Azure no arquivo
de configuração de configurações locais com a chave nomeada após a cadeia de
conexão AzureWebJobsStorage. Quando o host de trabalho começa a ser executado,
ele usa a cadeia de conexão e observa os contêineres de contas de armazenamento
que especificamos. Sempre que um novo blob é adicionado ou atualizado, ele dispara
automaticamente o gatilho de blob no ambiente atual.
E mais...
Ao criar o Azure Functions no Portal de gerenciamento do Azure, você precisa criar
gatilhos e associações de saída na guia Integrar de cada Azure Function. No entanto,
quando você cria uma função do IDE do Visual Studio 2017, só pode configurar atributos
WebJobs para atingir isso.
Para saber mais sobre os atributos WebJobs, visite https://docs.

microsoft.com/azure/app-service/webjobs-sdk-get-
started.
[ 102 ]
Capítulo 4
Implantação do aplicativo Azure Functions

para a Nuvem do Azure usando o Visual
Studio
Até agora, nosso aplicativo de função é apenas um aplicativo comum no Visual Studio.
Para implantar o aplicativo de função junto com suas funções, precisamos criar os novos
recursos a seguir ou selecionar os existentes para hospedar o novo aplicativo de função:
• O grupo de recursos
• O plano de serviço de aplicativo
• O aplicativo Azure Functions
Você pode fornecer todos esses detalhes diretamente do Visual Studio sem abrir o Portal
de gerenciamento do Azure. Nesta receita, você aprenderá a fazer isso.
Como fazer isso...

1. Clique com o botão direito do mouse no projeto e clique no botão Publicar

para abrir a janela publicar.
2. Na janela Publicar, escolha a opção Criar Novo e clique no botão Publicar,
[ 103 ]
3. Na janela Criar Serviço de Aplicativo, você pode escolher entre os recursos

existentes ou clicar no botão Novo para escolher o novo Grupo de Recursos,
o plano do Serviço de Aplicativo e a Conta de Armazenamento, como mostrado
4. Na maioria dos casos, a melhor opção é o plano de consumo para hospedar

o Azure Functions, a menos que você tenha um motivo forte para não fazê-lo
e preferir utilizar um dos seus serviços de aplicativo existentes. Para escolher
o plano de consumo, você precisa clicar no botão Novo que está disponível
para o plano de serviço de aplicativo, como mostrado na captura de tela anterior.
Selecione Consumo no menu suspenso Tamanho e clique no botão OK, como
[ 104 ]
Capítulo 4
5. Depois de revisar todas as informações, clique no botão Criar da janela Criar

Serviço de Aplicativo. Isso deve começar a implantar os serviços no Azure,
conforme mostrado nesta captura de tela:
6. Se tudo correr bem, você poderá exibir o aplicativo de função recém-criado

no Portal de gerenciamento do Azure, conforme mostrado na seguinte captura
de tela:
[ 105 ]
7. Um momento! Nosso trabalho no Visual Studio ainda não foi concluído.

Acabamos de criar os serviços necessários no Azure diretamente do IDE do
Visual Studio. Nossa próxima tarefa é publicar o código da estação de trabalho
local na nuvem do Azure. Assim que a implementação for concluída, você
passará para a etapa de implantação da Web, conforme mostrado na captura
de tela. Clique no botão Publicar para iniciar o processo de publicação do código:
8. Após alguns segundos, você verá algo semelhante à seguinte captura de tela
na janela de Saída da sua instância do Visual Studio:
9. É isso. Concluímos a implantação do seu aplicativo de função e suas funções

para o Azure diretamente do seu IDE de desenvolvimento favorito, o Visual
Studio. Você pode revisar a implantação da função no Portal de gerenciamento
do Azure. Ambas os Azure Functions foram criados com êxito, conforme
[ 106 ]
Capítulo 4
E mais...
Os Azure Functions criados a partir do Visual Studio 2017 são pré-compilados. Isso
significa que você implanta os arquivos .dll do Visual Studio 2017 para o Azure.
Portanto, você não pode editar o código das funções no Azure depois de implantá-los.
No entanto, você pode fazer alterações nas configurações, tais como alterar a cadeia
de conexão do Armazenamento do Azure, o caminho do contêiner e assim por diante.
Veremos como fazer isso na próxima receita.
Depuração de um C# do Azure Functions

ao vivo, hospedada no ambiente de Nuvem
do Microsoft Azure, usando o Visual Studio
Em uma das receitas anteriores, Conectando-se à nuvem de armazenamento do Azure
a partir do ambiente local do Visual Studio, você aprendeu como conectar a conta de
armazenamento em nuvem do código local. Nesta receita, você aprenderá a depurar
o código ao vivo em execução no ambiente de nuvem do Azure. Executaremos
as seguintes etapas na função BlobTriggerCSharp do aplicativo de função
FunctionAppinVisualStudio:
• Alterar o caminho do contêiner no Portal de gerenciamento do Azure para

o novo contêiner
• Abrir o aplicativo de função no Visual Studio 2017
• Anexar o depurador do Visual Studio 2017 para o Azure Functions necessário
• Criar um blob no novo contêiner de armazenamento
• Depurar o aplicativo após atingir os pontos de interrupção
[ 107 ]
Preparação
Crie um contêiner denominado cookbookfiles-live na conta de armazenamento.
Vamos carregar um blob neste contêiner.
Como fazer isso...

1. Navegue até a função BlobTriggerCSharp no Portal de gerenciamento do

Azure e altere o caminho da variável path para apontar para o novo contêiner
cookbookfiles-live. Em seguida, publique-o novamente. Ele deve ser
parecido com o mostrado na seguinte captura de tela:
2. Abra o aplicativo de função no Visual Studio 2017. Abra

o Gerenciador de Servidores e navegue até o Azure Function;
Neste caso, o FunctionAppinVisualStudio2017, como mostrado
[ 108 ]
Capítulo 4
3. Clique com o botão direito do mouse em Anexar Depurador, como mostrado

[ 109 ]
4. O Visual Studio levará algum tempo para habilitar a depuração remota,

5. A URL do aplicativo de função será aberta no navegador, conforme mostrado

na seguinte captura de tela, indicando que nosso aplicativo de função está em
execução:
6. Navegue até Gerenciador de Armazenamento e carregue um novo arquivo

(neste caso, carreguei EmployeeInfo.json) no contêiner cookbookfiles-
live, conforme mostrado nesta captura de tela:
[ 110 ]
Capítulo 4
7. Após alguns instantes, o ponto de interrupção de depuração será atingido, mostrado

da seguinte maneira, em que você pode exibir o nome do arquivo que foi carregado:
Implantação do Azure Functions

em um contêiner
Imagino que você já tenha entendido o que leva ao uso do Azure Functions. Sim —
ao desenvolver um código e implantá-lo em um ambiente sem servidor, em que um
desenvolvedor ou administrador não precisa se preocupar com o provisionamento
e a escala de instâncias para hospedar seus aplicativos do servidor.
Tornar todos os recursos sem servidor só será possível quando

você criar seu Aplicativo de Função, escolhendo o plano de
consumo no menu suspenso Plano de Hospedagem.
[ 111 ]
Ao observar o título desta receita, talvez você já esteja se perguntando por que e como
implantar um Azure Functions em um contêiner do Docker ajudaria. Sim, a combinação
do Azure Functions e do Contêiner do Docker talvez não faça sentido, pois você perderia
todos os benefícios da falta de servidor do Azure Functions ao implantar no Docker. No
entanto, pode haver alguns clientes cujos workloads existentes estejam na nuvem (pública
ou privada), mas agora eles desejam aproveitar alguns dos gatilhos do Azure Functions
e dos Serviços do Azure relacionados. Portanto, eles desejam implantar o Azure Functions
como uma imagem do Docker. Esta receita mostra como implementar isso.
Preparação
Estes estão os pré-requisitos para começar com esta receita:
• Instale a CLI do Azure a partir de https://docs.microsoft.com/cli/

azure/install-azure-cli?view=azure-cli-latest
• Você pode fazer download do Docker a partir de https://store.docker.
com/editions/community/docker-ce-desktop-windows. Instale a versão
do Docker que seja compatível com o sistema operacional do seu ambiente de
desenvolvimento.
• Também é necessário o conhecimento básico do Docker e seus comandos para
compilar e executar imagens do Docker. Examine a documentação oficial do
Docker para aprender isso caso você ainda não tenha esse conhecimento.
• Crie um Registro de Contêiner do Azure (ACR) com as etapas a seguir. Isso
pode ser usado como um repositório para todas as imagens do Docker.
[ 112 ]
Capítulo 4
Criando um ACR
1. Crie um novo ACR fornecendo os seguintes detalhes, como mostrado nesta

captura de tela:
[ 113 ]
2. Depois que o ACR for criado com êxito, navegue até a folha de Chaves de Acesso
e anote o Servidor de login, o Nome de usuário e a senha, que são destacados
na captura de tela a seguir. Você utilizará isso mais adiante nesta receita:
Como fazer isso...

Nos três primeiros capítulos, criamos o aplicativo de função e as funções diretamente
no portal. Até aqui, neste capítulo, criamos o aplicativo de função e as funções no próprio
Visual Studio.
Antes de começar, vamos fazer uma pequena alteração no HTTPTrigger para entender
que o código está sendo executado a partir do Docker, como destacado na imagem
a seguir. Para fazer isso, acabei de adicionar uma mensagem Do Docker para a saída,
[ 114 ]
Capítulo 4
Criação de uma imagem do Docker para

o aplicativo de função
1. A primeira etapa na criação de uma imagem do Docker é criar um Dockerfile em

nosso projeto do Visual Studio. Crie um .Dockerfile com o seguinte conteúdo:
FROM microsoft/azure-functions-dotnet-core2.0:2.0 COPY ./bin/
Release/netstandard2.0 /home/site/wwwroot
2. Em seguida, navegue até o prompt de comando e execute o seguinte comando do

Docker, docker build -t functionsindocker, tomando cuidado para não
perder o ponto no final do comando, para criar uma imagem do Docker. Após
executar o comando docker build, você verá algo semelhante ao que aparece
nesta captura de tela:
3. Após a criação da imagem com êxito, a próxima etapa será executar a imagem
do Docker em uma porta específica. Execute o comando para executá-la. Você
deverá ver algo como a seguinte captura de tela:
[ 115 ]
4. Verifique se tudo está funcionando bem no ambiente local navegando até o host
local com a porta direita, conforme mostrado na captura de tela a seguir.
Como mover a imagem do Docker para o ACR

1. A primeira etapa é garantir que forneçamos uma marca válida para a imagem
usando o comando docker tag functionsindocker cookbookregistry.
azurecr.io/functionsindocker:v1. A execução deste comando não
fornecerá resultados. No entanto, para exibir nossas alterações, vamos executar
o comando docker images, conforme mostrado na seguinte captura de tela:
2. Para enviar a imagem ao ACR, você precisa autenticar-se no Azure. Para fazer
isso, você pode usar comandos da CLI do Azure. Vamos fazer logon no Azure
usando o comando az login. A execução deste comando abrirá um navegador e
autenticará suas credenciais, conforme mostrado nesta captura de tela:
[ 116 ]
Capítulo 4
3. A próxima etapa é autenticar-se no ACR usando o comando az acr login

--name cookbookregistry. Substitua o nome do ACR (no meu caso, ele
é cookbookregistry) por aquele criado por você:
4. Depois de autenticar-se, você pode enviar a imagem para o ACR,

executando o comando docker push cookbookregistry.azurecr.io/
functionsindocker:v1, conforme mostrado na seguinte captura de tela:
5. Vamos navegar para o ACR no portal do Azure e analisar se a nossa imagem foi
enviada para ela corretamente na folha Repositórios, como mostrado na seguinte
captura de tela:
Criamos com êxito uma imagem e a enviamos para o ACR. Agora, precisamos criar
o Azure Functions e referenciar a imagem do Docker que foi enviada para o ACR.
[ 117 ]
Criação um novo aplicativo de função com

o Docker
1. Navegue até a folha Novo | Aplicativo de Função e forneça as seguintes informações:
2. Agora, escolha Linux (Visualização) no campo OS e escolha Imagem do Docker

no campo Publicar Em seguida, clique em Plano de Serviço de Aplicativo/Local,
conforme mostrado na captura de tela anterior. Aqui, opte por criar um novo
plano de Serviço de Aplicativo Básico.
[ 118 ]
Capítulo 4
3. O passo seguinte e mais importante é indicar a imagem que enviamos ao ACR.

Para fazer isso, clique no botão Configurar contêiner e escolha Registro
de Contêiner do Azure. Depois, escolha a imagem correta, conforme
4. Depois de revisar todos os detalhes, clique no botão Criar para criar o aplicativo
de função.
5. É isso. Criamos um Aplicativo de Função que pode permitir implantar
as imagens do Docker, vinculando-as à imagem hospedada no Registro de
Contêiner do Azure. Vamos testar rapidamente o HttpTrigger navegando até
o ponto de extremidade HTTP no navegador. Veja a seguir o resultado do Azure
Functions.
Como funciona...
Nos três primeiros capítulos, criamos o aplicativo de função e as funções diretamente
no portal. Por outro lado, neste capítulo, criamos o aplicativo de função e as funções
no próprio Visual Studio.
[ 119 ]
Nesta receita, fizemos o seguinte:
Os pontos numerados neste diagrama referem-se às seguintes etapas:
1. Crie uma imagem do Docker do aplicativo de função que criamos neste capítulo
usando o Visual Studio.
2. Envie a imagem do Docker para o ACR
3. No portal, crie um novo aplicativo de função, escolhendo publicar
o pacote executável como uma imagem do Docker
4. Anexe a imagem do Docker do ACR (da etapa 2 no guia anterior)
ao Azure Functions (da etapa 3 no guia anterior)
[ 120 ]
Exploração de ferramentas
de testes para a validação do
Azure Functions
Neste capítulo, vamos explorar diferentes maneiras de testar o Azure Functions mais
detalhadamente com as seguintes receitas:
• Testes do Azure Functions:

°° Testes de gatilhos HTTP usando o Postman
°° Testes do gatilho de blob usando o Gerenciador de Armazenamento
do Microsoft
°° Testes do gatilho de fila usando o Portal de gerenciamento do Azure
• Testes de um Azure Functions em um ambiente de teste utilizando slots

de implantação
• Testes de carga do Azure Functions usando o Azure DevOps
• Criação e testes locais do Azure Functions usando ferramentas da CLI do Azure
• Testes e validação da capacidade de resposta do Azure Functions usando
o Application Insights
• Desenvolvimento de testes de unidade para o Azure Functions com
gatilhos HTTP
Introdução
Nos capítulos anteriores, você aprendeu a desenvolver o Azure Functions, identificou
onde ele é útil e verificou a validação da funcionalidade dessas funções.
[ 121 ]
Exploração de ferramentas de testes para a validação do Azure Functions
Neste capítulo, vamos começar a verificar maneiras de testar diferentes Azure Functions.
Isso inclui, por exemplo, a execução de testes de funções de gatilho de HTTP usando
o Postman e o Gerenciador de Armazenamento do Microsoft para testar gatilhos de blob
do Azure, gatilhos de fila e outros gatilhos relacionados ao serviço de armazenamento.
Você também aprenderá como executar um teste de carga simples em um gatilho de
HTTP, para ajudá-lo a entender como a arquitetura sem servidor funciona, provisionando
as instâncias no back-end. Os desenvolvedores não precisarão se preocupar com as
configurações de escala em diferentes fatores. O tempo de execução do Azure Functions
cuidará automaticamente da escala das instâncias.
Você também aprenderá a configurar um teste que verifica a disponibilidade de nossas

funções ao continuamente executar ping dos pontos de extremidade do aplicativo
em uma frequência predefinida de vários locais.
Testes do Azure Functions

O tempo de execução do Azure Function nos permite criar e integrar muitos serviços do
Azure. No momento da gravação, você pode escolher entre 20 tipos do Azure Functions
para criar. Nesta receita, você aprenderá como testar os Azure Functions mais comuns,
listados da seguinte maneira:
• Testes de gatilhos HTTP usando o Postman

• Testes do gatilho de blob usando o Gerenciador de Armazenamento do Microsoft
• Testes do gatilho de fila usando o portal de gerenciamento do Azure
Preparação
Instale as seguintes ferramentas se ainda não tiver feito isso:
• Postman: Você pode fazer download disso em https://www.getpostman.com/

• Gerenciador de Armazenamento do Microsoft Azure: Você pode fazer
download disso em http://storageexplorer.com/
Você pode usar o Gerenciador de Armazenamento para conectar-se às suas contas

de armazenamento e exibir todos os dados disponíveis de diferentes serviços
de armazenamento, como blobs, filas, tabelas e arquivos. Você também pode criar,
atualizar e excluir dados direto do Gerenciador de Armazenamento.
[ 122 ]
Capítulo 5
Como fazer isso...

Nesta seção, criaremos três Azure Functions, utilizando os modelos predefinidos
disponíveis no portal de gerenciamento do Azure. Depois, iremos testá-los com
ferramentas diferentes.
Testes de gatilhos HTTP usando o Postman

1. Crie uma função de gatilho de HTTP que aceite os parâmetros Firstname

e Lastname e envie-os na resposta. Após criá-la, verifique se você definiu
o Nível de Autorização como Anônimo.
2. Substitua o código padrão pelo código a seguir. Observe que, por questões
de simplicidade, removi as validações. Em aplicativos em tempo real, você
precisa validar cada parâmetro de entrada:
using System.Net;

ILogger log)
{
request.");
string firstname=req.Query["firstname"];
string lastname=req.Query["lastname"];

ReadToEndAsync();
firstname = firstname ?? data?.firstname;
lastname = lastname ?? data?.lastname;
return (ActionResult)new OkObjectResult($"Hello,

{firstname + " " + lastname}");
[ 123 ]
3. Abra a ferramenta Postman e conclua as seguintes etapas:

1. A
primeira etapa é escolher o tipo de método de HTTP com o qual você
gostaria de fazer a solicitação de HTTP. Como a nossa função aceita
a maioria dos métodos por padrão, escolha o método GET, mostrado
a seguir:
2. A próxima etapa é fornecer a URL do gatilho de HTTP. Note que você

precisaria substituir <HttpTriggerTestUsingPostman> por seu nome
de função real HttpTrigger, mostrado a seguir:
3. Clique no botão Enviar para fazer a solicitação. Se você forneceu todos os

detalhes esperados pela API, verá um Status: 200 OK, junto com a resposta,
conforme mostrado aqui:
[ 124 ]
Capítulo 5
Testes de um gatilho de blob usando o Gerenciador

de Armazenamento do Microsoft
1 Crie um novo gatilho de blob escolhendo o modelo de gatilho

de armazenamento de blob do Azure, como mostrado aqui:
2. Depois de clicar no modelo na captura de tela anterior, ele solicitará que você
forneça uma conta de armazenamento e um contêiner onde você armazenará
o blob, mostrado a seguir:
[ 125 ]
3. Vamos nos conectar à conta de armazenamento que usaremos nesta receita.

Abra o Gerenciador de Armazenamento do Microsoft Azure e clique no
botão realçado na seguinte captura de tela para conectar-se ao Armazenamento
do Azure:
4. Você será solicitado a inserir vários detalhes, incluindo cadeia de conexão

de armazenamento , SAS (assinatura de acesso compartilhado) e sua chave
de conta. Para esta receita, vamos usar a cadeia de conexão de armazenamento.
Navegue até Conta de Armazenamento, copie a cadeia de conexão na folha
de Chaves de acesso e cole-a no popup Gerenciador de Armazenamento
do Microsoft Azure - Conectar, mostrado a seguir:
[ 126 ]
Capítulo 5
5. Se você clicar no botão Avançar na captura de tela anterior, acessará a janela

Resumo da Conexão, em que aparecerá o nome da conta e outros detalhes
relacionados para confirmação. Clique no botão Conectar para conectar-se
à conta escolhida de Armazenamento do Azure.
6. Conforme mostrado na seguinte captura de tela, você agora está conectado
à conta de Armazenamento do Azure, em que pode gerenciar todos os seus
serviços de Armazenamento do Azure:
7. Agora, vamos criar um contêiner de armazenamento denominado samples-

workitems. Clique com o botão direito do mouse na pasta Contêineres
de Blob e clique em Criar Contêiner de Blob para criar um novo contêiner
de blob denominado samples-workitems. Depois, clique no botão Carregar
arquivos, como mostrado na seguinte captura de tela:
8. Na janela Carregar arquivos, escolha um arquivo que gostaria de carregar

e clique no botão Carregar.
[ 127 ]
9. Navegue imediatamente para o editor de código do Azure Function e verifique

a janela Logs, conforme mostrado na captura de tela a seguir. O log mostra
o Azure Functions acionado com êxito:
Testes do gatilho de fila usando o portal

de gerenciamento do Azure
1. Crie um novo gatilho da fila do Armazenamento do Azure denominado

QueueTriggerTestusingPortal, conforme mostrado na captura de tela
a seguir. Anote o nome da fila, myqueue-items, pois precisamos criar um
serviço de fila com o mesmo nome, posteriormente usando o portal de
gerenciamento do Azure:
[ 128 ]
Capítulo 5
2. Navegue até a folha Visão geral da conta de armazenamento e clique em Filas,

3. Na folha Serviço de fila, clique em Fila para adicionar uma nova fila:
4. Forneça myqueue-items como o Nome da fila no popup Adicionar fila, como

mostrado na captura de tela a seguir. Este foi o mesmo nome que usamos
ao criar o gatilho de fila. Clique em OK para criar o serviço de fila:
[ 129 ]
5. Agora precisamos criar uma mensagem de fila. No portal de gerenciamento

do Azure, clique no serviço de fila myqueue-items para navegar até a folha
Mensagens. Clique no botão Adicionar mensagem, conforme mostrado na
captura de tela a seguir e forneça um texto da mensagem da fila. Por fim,
clique em OK para criar a mensagem da fila:
6. Navegue logo para o gatilho de fila QueueTriggerTestusingPortal e exiba

a folha Logs. Aqui, você pode descobrir como a função de fila foi acionada,
como mostrado na seguinte captura de tela:
[ 130 ]
Capítulo 5
E mais...
Para todos os seus gatilhos HTTP, se você desejar permitir que os consumidores de
API usem apenas o método POST, poderá restringi-lo como tal, escolhendo Métodos
selecionados e apenas POST em Métodos HTTP selecionados, conforme mostrado
nesta captura de tela:
Testes de um Azure Functions em

um ambiente de teste utilizando slots
de implantação
Em geral, cada aplicativo precisa de ambientes de pré-produção, como preparo,
beta e assim por diante, a fim de revisar as funcionalidades antes de publicá-las
para os usuários finais.
Embora os ambientes de pré-produção sejam ótimos e ajudem vários stakeholders

a validar a funcionalidade do aplicativo em relação aos requisitos de negócios,
há alguns problemas no gerenciamento e manutenção deles. Veja alguns deles:
• Precisaríamos criar e usar um ambiente separado para nossos ambientes

de pré-produção
• Após tudo ser revisado na pré-produção e a equipe de operações de TI obter
o sinal de avanço, haveria um pouco de tempo de inatividade no ambiente
de produção ao implantar a base de código de novas funcionalidades
[ 131 ]
Todas as limitações anteriores podem ser abordadas no Azure Functions, usando

um recurso chamado slots (esses são chamados de slots de implantação em ambientes
de Serviço de Aplicativo). Usando slots, você pode configurar um ambiente de pré-
produção, em que pode rever todas as novas funcionalidades e promovê-las (por meio
de troca, que abordaremos mais adiante) para o ambiente de produção sem problemas
e sempre que necessário.
Como fazer isso...

1. Criar um novo aplicativo de função denominado MyProductionApp.

2. Criar um novo gatilho de HTTP e chame-o de MyProd-HttpTrigger1. Substitua
a última linha pelo seguinte:
return name != null
? (ActionResult)new OkObjectResult("Welcome to MyProd-
HttpTrigger1 of Production App")
query string or in the request body");
3. Crie outro novo gatilho de HTTP e chame-o de MyProd-HttpTrigger2.

Use o mesmo código que você usou para MyProd-HttpTrigger1— basta
substituir a última linha pelo seguinte:
return name != null
? (ActionResult)new OkObjectResult("Welcome to MyProd-
HttpTrigger2 of Production App")
query string or in the request body");
4. Suponha que ambas as funções do aplicativo de função sejam ao vivo

no ambiente de produção com a URL https://<<functionappname.
azurewebsites.net>>.
5. Agora, o cliente solicitou que façamos algumas alterações em ambas as funções.
Em vez de fazer as alterações diretamente nas funções do seu aplicativo de
função de produção, talvez você precise criar um slot.
6. Um momento! Antes de criar um slot, primeiro você precisa ativar o recurso
navegando para as configurações do aplicativo de função sob Configurações
Gerais da guia Recursos da plataforma do aplicativo de função. Quando você
clicar nas configurações do aplicativo de função, uma nova guia será aberta
onde você poderá ativar Slots (visualização), como mostrado na seguinte
captura de tela:
[ 132 ]
Capítulo 5
O recurso de slots está atualmente em visualização. Quando

você ler isso, ele poderá estar Geralmente Disponível (GA).
Não é recomendável usar esse recurso em workloads de produção
até que ele esteja GA
7. Clique no botão Ativar na seção slots (visualização) realçada na captura

de tela anterior. Assim que você ativá-lo, a seção de slots ficará oculta, pois
ela é uma configuração única. Uma vez ativada, você não pode desativá-la.
8. Vamos criar um novo slot com todas as funções que temos em nosso aplicativo
de função, denominado MyProductionApp.
9. Clique no ícone +, disponível perto da seção Slots (visualização), conforme
10. Ele solicita que você digite um nome para o novo slot. Forneça um nome
significativo, algo como Preparação, como mostrado na seguinte captura
de tela:
[ 133 ]
11. Após você clicar em Criar, um novo slot será criado, como mostrado na captura
de tela a seguir. No caso, se você ver as funções como somente leitura, poderá
torná-las leitura-gravação nas configurações do aplicativo de função.
A URL para o slot será https://<<functionappname>>-

<<Slotname>>.azurewebsites.net>>. Cada slot em um aplicativo
de função terá uma URL diferente.
12. Para tornar um ambiente de preparação completo, você precisa copiar

todos os Azure Functions do ambiente de produção (neste caso, o aplicativo
MyProductionApp) para o novo slot de preparação chamado Preparação. Crie
dois gatilhos HTTP e copie o código das duas funções (MyProd-HttpTrigger1
e MyProd-HttpTrigger2) de MyProductionApp para o novo slot Preparação.
Basicamente, você precisa copiar todas as funções para o novo slot manualmente.
13. Altere a cadeia de produção para preparação na última linha das duas funções
no slot de preparação. Isso é útil para testar o resultado da operação de troca:
[ 134 ]
Capítulo 5
Note que, em todos os slots criados como um aplicativo de pré-produção,

você precisa garantir que utilizou os mesmos nomes de função que tem
em seu ambiente de produção.
14. Clique no botão Trocar, disponível na folha Slots de implantação, conforme

mostrado nesta captura de tela:
15. Na folha Troca, você precisa escolher o seguinte:

°° Tipo de troca: escolha a opção Trocar.
°° Fonte: escolha o slot que você gostaria de mover para a produção.
Neste caso, estamos trocando a Preparação em geral, mas você
pode até mesmo trocar entre slots de não produção.
[ 135 ]
°° Destino: escolha a opção de produção, conforme mostrado na seguinte

captura de tela:
16. Depois de revisar as configurações, clique no botão OK da etapa anterior. Levará

alguns instantes para trocar as funções. Uma barra de progresso aparecerá,
[ 136 ]
Capítulo 5
17. Depois de um minuto ou dois, os slots de preparação e produção serão trocados.

Vamos revisar os arquivos de script run.csx da produção:
18. Se você não vir alterações, clique no botão Atualizar do aplicativo de função ,
[ 137 ]
19. Certifique-se de que as Configurações do Aplicativo e as Cadeias de Conexão

do Banco de Dados estejam marcadas como Configuração de Slot (específicas de
slot). Caso contrário, as Configurações do Aplicativo e as Cadeias de Conexão
do Banco de Dados também serão trocadas, o que poderá gerar comportamentos
inesperados. Você pode marcar qualquer uma dessas configurações dessa forma
em Recursos da plataforma, como mostrado na seguinte captura de tela:
20. Ao clicar em Configurações do aplicativo, você acessará a seguinte folha, em que

poderá marcar qualquer configuração como CONFIGURAÇÃO DE SLOT:
Todas as funções encontradas na receita são gatilhos HTTP; note que você
pode ter qualquer tipo de gatilho no aplicativo de função. Os slots de
implantação não se limitam aos gatilhos HTTP.
Você pode ter vários slots para cada um dos aplicativos de função. Estes
são alguns dos exemplos:
Alfa
Beta
Preparação
[ 138 ]
Capítulo 5
E mais...
Se você tentar criar um slot sem ativar o recurso de Slots de Implantação, você verá algo
semelhante ao que é mostrado na seguinte captura de tela:
Você precisa ter todos os Azure Functions em cada um dos slots que gostaria de trocar
com o seu aplicativo de função de produção:
• Slots são específicos do aplicativo de função, mas não da função individual.

• Após ativar os recursos de slots, todas as chaves serão regeneradas, incluindo
o mestre. Tenha cuidado se já tiver compartilhado as chaves das funções com
terceiros. Se você já tiver compartilhado-as e ativado os slots, todas as integrações
existentes com as chaves antigas não funcionarão.
Em geral, se você estiver usando Serviços de Aplicativos e desejar criar slots de

implantação, precisará ter seu plano de serviço de aplicativos no nível Standard
ou Premium. No entanto, você pode criar slots para o aplicativo de função, mesmo
que ele esteja com planos de Consumo (ou dinâmicos).
Testes de carga do Azure Functions

usando o Azure DevOps
Cada aplicativo precisa funcionar bem em termos de performance. É responsabilidade
de todos da equipe que o aplicativo funcione bem. Nesta receita, você aprenderá como
criar uma carga no Azure Functions usando a ferramenta Teste de Carga fornecida
pelo Azure DevOps (antes conhecido como VSTS). Esta receita também irá ajudá-lo
a entender como a escala automática de instâncias funciona no ambiente sem servidor,
sem que os desenvolvedores ou o arquiteto precisem se preocupar com as instâncias
responsáveis por atender às solicitações.
[ 139 ]
Preparação
Crie uma conta do Azure DevOps em https://visualstudio.microsoft.com/.
Utilizaremos a ferramenta Teste de Carga do Azure DevOps para criar testes de carga
baseados em URL.
Como fazer isso...

1. Crie um novo gatilho de HTTP, denominado LoadTestHttpTrigger,

com Nível de Autorização definido como Anônimo.
2. Substitua o código padrão em run.csx pelo seguinte:
using System.Net;
ILogger log)
{
System.Threading.Thread.Sleep(2000);
return (ActionResult)new OkObjectResult($"Hello");
}
3. O código precedente é auto-explicativo. Para tornar o teste de carga interessante,

simularemos uma carga de processamento, adicionando um tempo de espera
de dois segundos, usando System.Threading.Thread.Sleep(2000);.
4. Copie a URL de função clicando no link de </> Obter URL de função no lado
direito do editor de código run.csx.
5. Navegue até a guia Teste de carga da conta do Azure DevOps. Você pode
encontrá-lo no menu Teste após fazer logon no Azure DevOps:
[ 140 ]
Capítulo 5
6. Clique no link Novo e selecione Teste baseado em URL, como mostrado

7. Na guia Cenários da Web, forneça um nome significativo para o teste de carga,

8. Cole a URL do gatilho de HTTP que você copiou na etapa 4 no campo de entrada
da URL, conforme mostrado nesta captura de tela:
9. Agora, clique no botão Salvar para salvar o teste de carga:
[ 141 ]
10. A próxima etapa é fornecer detalhes sobre a carga que gostaríamos de criar
no Azure Functions. Como mostrado na captura de tela a seguir, clique em
Configurações e forneça os detalhes sobre o teste de carga que você gostaria,
de acordo com seus requisitos:
11. Após fornecer todos os seus detalhes para o teste de carga, clique em Salvar.
Após você salvar o teste, o botão Executar teste será ativado, conforme mostrado
12. Clique em Executar teste para iniciar o teste de carga. Como a duração de
execução do nosso teste de carga é de 20 minutos, levaria 20 minutos para
concluir o teste de carga. Quando a carga estiver concluída, o Azure DevOps
nos fornecerá os relatórios de performance, mostrados da seguinte maneira:
[ 142 ]
Capítulo 5
°° Relatório de resumo: ele nos fornece o tempo médio de resposta

do gatilho de HTTP para a carga de 1.000 usuários.
E mais...
Também podemos verificar como o Azure expande as instâncias automaticamente nos
bastidores na guia Live Metrics Stream do Application Insights. A captura de tela
a seguir mostra as IDs de instância e a integridade das máquinas virtuais alocadas
automaticamente, com base na carga na arquitetura sem servidor do Azure. Você
aprenderá a integrar o Application Insights com o Azure Functions no Capítulo 6,
Como monitorar e solucionar problemas de serviços sem servidor no Azure
[ 143 ]
Consulte também
O Monitoramento do Azure Functions usando a receita do Application Insights
no Capítulo 6, Como monitorar e solucionar problemas de serviços sem servidor no Azure,
contém mais informações sobre este tópico.
Criação e testes locais do Azure

Functions usando ferramentas
da CLI do Azure
A maioria das receitas que você conheceu até agora foram criadas usando o navegador
ou o Ambiente de Desenvolvimento Integrado (IDE) do Visual Studio.
O Azure também nos fornece ferramentas para desenvolvedores que adoram trabalhar
com a linha de comando. Essas ferramentas nos permitem criar recursos do Azure com
comandos simples diretamente da linha de comando. Nesta receita, você aprenderá
a criar um novo aplicativo de função e também entenderá como criar uma função
e implantá-la na Nuvem do Azure diretamente da linha de comando.
Preparação
• Faça download e instale o Node.js de https://nodejs.org/en/download/.

• Faça download de e instale as ferramentas da CLI do Azure de https://docs.
microsoft.com/cli/azure/install-azure-cli?view=azure-cli-
latest.
Como fazer isso...

1. Quando o Azure Functions Core Tools estiver pronto, execute o seguinte

comando para criar um novo aplicativo de função:
func init
Você receberá a seguinte saída após executar o comando anterior:
[ 144 ]
Capítulo 5
Na captura de tela anterior, dotnet é selecionado por padrão. Se pressionar Enter,

você criará os arquivos necessários, como mostrado na seguinte captura de tela:
2. Execute o seguinte comando para criar uma nova função de gatilho HTTP
no novo aplicativo de função que criamos:
func new
Você receberá a seguinte saída após executar o comando anterior:
3. Como mostrado na captura de tela anterior, você será solicitado a escolher

o modelo de função. Para esta receita, escolhi HttpTrigger. Escolha
HttpTrigger usando a seta para baixo. Você pode escolher o tipo de Azure
Functions com base em seus requisitos. Você pode navegar entre as opções
usando as setas para cima/para baixo no teclado.
[ 145 ]
4. A próxima etapa é fornecer um nome para o Azure Functions que você estiver
criando. Forneça um nome significativo e pressione Enter, como mostrado
5. Você pode usar seu IDE favorito para editar o código do Azure Functions.
Nesta receita, estou usando o código do Visual Studio para abrir a função
HttpTrigger, conforme mostrado na seguinte captura de tela:
6. Vamos testar o Azure Functions diretamente do seu computador local. Para isso,
precisamos iniciar o host do Azure Functions executando o seguinte comando:
func host start --build
[ 146 ]
Capítulo 5
7. Depois que o host for iniciado, você poderá copiar a URL e testá-la em
seu navegador, junto com um nome de parâmetro de cadeia de caracteres
de consulta, conforme mostrado na seguinte captura de tela:
Testes e validação da capacidade

de resposta do Azure Functions usando
Qualquer aplicativo só será útil para negócios se estiver em operação. Os aplicativos
podem ficar inativos por vários motivos. Veja alguns deles:
• Qualquer falha de hardware, como falha do servidor, disco rígido incorreto

ou outro problema de hardware, até mesmo falha em um data center inteiro,
embora isso seja muito raro
• Pode haver erros de software devido a um código incorreto ou a um erro
de implantação
• O site pode receber tráfego inesperado e os servidores podem não ser capazes
de lidar com esse tráfego
• Em alguns casos, talvez seu aplicativo seja acessível em um país, mas não
em outros
Seria realmente útil receber uma notificação quando o nosso site não estivesse disponível
ou não respondesse a solicitações do usuário. O Azure fornece algumas ferramentas
para ajudar, alertando-nos se o site não está respondendo ou está inativo. Uma delas
é o Application Insights. Você aprenderá como configurar o Application Insights para
fazer ping em nosso aplicativo Azure Functions a cada minuto e configurá-lo para
alertar-nos se a função não estiver respondendo.
[ 147 ]
Preparação
1. Navegue até o portal de gerenciamento do Azure, procure o Application

Insights, depois clique no botão Criar e forneça todos os detalhes necessários,
[ 148 ]
Capítulo 5
2. Navegue até a folha Visão geral do aplicativo de função e obtenha a URL

do aplicativo de função, conforme mostrado nesta captura de tela:
Como fazer isso...

1. Navegue até a folha Disponibilidade e clique no botão de teste Adicionar,

como mostrado na seguinte captura de tela:
[ 149 ]
2. Na folha Criar teste, insira um nome significativo para seu requisito e cole
a URL do aplicativo de função, que você anotou na etapa 2 da seção anterior,
Preparação, no campo URL da folha Criar teste. Na folha Alertas, forneça
um endereço de e-mail válido no campo Enviar e-mails de alerta para esses
endereços de e-mail:, para o qual um alerta deverá ser enviado se a função
não estiver disponível ou não estiver respondendo:
[ 150 ]
Capítulo 5
3. Clique em OK na folha Alertas e, em seguida, clique no botão Criar da folha

Criar teste para criar o teste, conforme mostrado na seguinte captura de tela,
na seção Todos os testes de disponibilidade:
4. Para testar a funcionalidade deste alerta, vamos parar o aplicativo de função,

clicando no botão Parar, encontrado na guia Visão geral do aplicativo de função.
[ 151 ]
5. Quando o aplicativo de função for interrompido, o Application Insights tentará

acessar a URL de função usando o teste de ping. O código de resposta não
será 200, pois o aplicativo foi interrompido, o que significa que o teste falhou
e uma notificação deve ter sido enviada para o e-mail configurado, conforme
Como funciona...
Criamos um teste de disponibilidade, em que foi realizado ping em nosso aplicativo
de função uma vez a cada cinco minutos de um máximo de cinco locais diferentes
em todo o mundo. Você pode configurá-los na guia Local de teste da folha Criar teste
ao criar o teste. O critério padrão do ping é verificar se o código de resposta da URL
é 200. Se o código de resposta não for 200, então o teste falhou e um alerta será
enviado para o endereço de e-mail configurável.
E mais...
Você poderá usar um teste da Web de várias etapas (com a opção Tipo de Teste
na folha Criar teste) se desejar testar uma página ou funcionalidade que exija
a navegação para várias páginas.
Desenvolvimento de testes de unidade

para o Azure Functions com gatilhos HTTP
Até agora, criamos vários Azure Functions e validamos sua funcionalidade usando
diferentes ferramentas. As funcionalidades das funções que desenvolvemos até agora
são bem simples e diretas; no entanto, nos aplicativos reais, não será tão simples —
provavelmente haverá muitas alterações no código que criamos inicialmente. É uma
boa prática escrever testes de unidade automatizados que podem nos ajudar a testar
a funcionalidade de nossos Azure Functions. Toda vez que executamos esses testes
de unidade automatizados, podemos testar todos os diversos caminhos dentro do código.
[ 152 ]
Capítulo 5
Nesta receita, aprenderemos como usar o gatilho de HTTP básico e ver como é fácil
escrever casos de teste de unidade automatizados para isso usando o Visual Studio
Test Explorer e o Moq (uma estrutura open source disponível como um pacote NuGet).
Preparação
Utilizaremos a estrutura de simulação Moq para o teste da unidade de nosso Azure
Functions. Ter um conhecimento de trabalho básico de Moq é uma exigência para esta
receita. Se precisar, você poderá conhecer mais sobre Moq em https://github.com/
moq/moq4/wiki.
Para simplificar o Caso de Teste de Unidade, comentei as linhas de código que lê os

dados dos parâmetros Post para o método Run de HTTPTriggerCSharpFromVS
HTTPTrigger, como mostrado abaixo, em negrito.
[FunctionName("HTTPTriggerCSharpFromVS")]
[HttpTrigger(AuthorizationLevel.Anonymous, "get", "post",
Route = null)] HttpRequest req,
ILogger log)
{
request.");
//string requestBody = await new StreamReader(req.Body).

ReadToEndAsync();
//dynamic data = JsonConvert.
DeserializeObject(requestBody);
//name = name ?? data?.name;
return name != null

? (ActionResult)new OkObjectResult($"Hello, {name}")
: new BadRequestObjectResult("Please pass a name on
the query string or in the request body");
}
[ 153 ]
Como fazer isso...

1. Crie um novo projeto de teste de unidade clicando com o botão direito do

mouse na solução e, depois, em Adicionar Novo Projeto. Na janela Adicionar
Novo Projeto, escolha Testar na lista de Tipo de Projeto e escolha xUnit Test
Project(.NET Core) na lista de projetos, conforme mostrado aqui:
2. Verifique se você escolheu xUnit Test Project(.NET Core) no console

Gerenciador de Pacotes e execute os seguintes comandos:
°° Instale o pacote NuGet de Moq usando o comando Install-Package Moq
°° Instale o pacote ASP.NET Core usando o comando Install-Package
Microsoft.AspNetCore
3. No projeto de teste de unidade, também precisamos da referência
ao Azure Functions em que desejamos executar os testes de unidade.
Adicione uma referência ao aplicativo FunctionAppInVisualStudio
para que possamos chamar o método Run do gatilho de HTTP de nossos
testes de unidade.
[ 154 ]
Capítulo 5
4. Adicione todos os namespaces necessários para a classe Teste de Unidade,

da seguinte maneira: e substitua o código padrão pelo código a seguir. O código
a seguir simula as solicitações, cria uma coleção de cadeia de consulta com uma
chave denominada nome, atribui um valor de Praveen Sreeram, executa a
função, obtém a resposta e compara o valor de resposta com um valor esperado:
using FunctionAppInVisualStudio;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Http.Internal;
using Moq;
using System;
using System.Collections.Generic;
using Xunit;
using Microsoft.Extensions.Logging;
using System.Threading.Tasks;
namespace AzureFunctions.Tests
{
public class ShouldExecuteAzureFunctions
{
[Fact]
public async Task WithAQueryString()
{
var httpRequestMock = new Mock<HttpRequest>();
var LogMock = new Mock<ILogger>();
var queryStringParams = new Dictionary<String,
StringValues>();
httpRequestMock.Setup(req => req.Query).Returns(new Qu
eryCollection(queryStringParams));
queryStringParams.Add("name", "Praveen Sreeram");
var result = await HTTPTriggerCSharpFromVS.

Run(httpRequestMock.Object,LogMock.Object);
var resultObject = (OkObjectResult)result;
Assert.Equal("Hello, Praveen Sreeram", resultObject.
Value);
}
}
}
[ 155 ]
5. Agora, clique com o botão direito do mouse no teste de unidade e clique

em Executar teste(s), como mostrado na seguinte captura de tela:
Se tudo estiver configurado corretamente, os testes deverão passar, conforme mostrado

É isso. Aprendemos a escrever um caso de teste de unidade básico para um gatilho

de HTTP.
[ 156 ]
Como monitorar e solucionar
problemas de serviços sem
servidor no Azure
Neste capítulo, você aprenderá sobre o seguinte:
• Solução de problemas do Azure Functions

• Integração do Azure Functions com o Application Insights
• Monitoramento do Azure Functions
• Envio de detalhes de telemetria personalizados para o Application Insights
Analytics
• Envio de detalhes de telemetria do aplicativo via e-mail
• Integração de dados de monitoramento do Application Insights em tempo
real com Power BI usando o Azure Functions
Introdução
Não basta concluir o desenvolvimento de um projeto e ativar um aplicativo para finalizar
a implantação. Precisamos monitorar continuamente nossos aplicativos, analisar sua
performance e revisar seus logs para entender se os usuários finais enfrentam problemas.
O Azure fornece várias ferramentas para atender a todos os nossos requisitos

de monitoramento, desde os estágios de desenvolvimento e manutenção.
Neste capítulo, você aprenderá como utilizar essas ferramentas e adotar qualquer
ação necessária com base nas informações disponíveis.
[ 157 ]
Solução de problemas do Azure

Functions
Nesta receita, você aprenderá como exibir os logs de aplicativo de seus aplicativos
de função usando o recurso de streaming de log de funções.
Como fazer isso...

Após terminar o desenvolvimento e testar seus aplicativos em seu ambiente local,
convém implantá-los no Azure. Você poderá enfrentar problemas depois de implantar
um aplicativo no Azure, pois o ambiente é diferente. Por exemplo, um desenvolvedor
pode ter perdido a criação de Configurações do Aplicativo no aplicativo. Com uma
chave de configuração ausente, seu aplicativo pode não funcionar conforme o esperado
e não é fácil solucionar o erro. Felizmente, o ambiente do Azure facilita com o recurso
de Streaming de Log. Nesta receita, vamos aprender a exibir os logs em tempo real
e também compreender como usar o recurso Diagnosticar e solucionar problemas.
Visualização de logs de aplicativos em tempo real

1. Navegue até Recursos da plataforma do aplicativo de função e clique no botão

Streaming de Log, em que você pode exibir os Logs do aplicativo, conforme
No momento da gravação, os logs do servidor Web não fornecem

informações relacionadas ao Azure Functions.
[ 158 ]
Capítulo 6
2. Vamos abrir qualquer Azure Functions adicionado anteriormente em uma nova

guia do navegador e adicionar uma linha de código que gere uma exceção.
Para simplificar (e apenas ilustrar como logs de aplicativo no streaming de logs
funcionam), adicionei a seguinte linha ao gatilho de HTTP simples que criei
anteriormente:
3. Posteriormente, clique no botão Salvar e no botão Executar. Como esperado,

você receberá uma exceção, junto com a mensagem na seção Logs do aplicativo,
A janela de log mostra erros somente para essa função específica e não
para as outras funções associadas ao aplicativo de função. Nesse caso,
os logs do aplicativo de streaming de logs são úteis, pois podem ser
usados nas funções de qualquer aplicativo de função específico.
[ 159 ]
Diagnóstico do aplicativo de função inteiro

Na seção anterior, aprendemos a monitorar erros de aplicativos em tempo real, o que
será útil para identificar e corrigir rapidamente os erros encontrados. No entanto, nem
sempre é possível monitorar logs de aplicativo e entender os erros que os usuários
finais enfrentam. O Azure Functions fornece outra grande ferramenta, denominada
Diagnosticar e solucionar problemas:
1. Navegue até Recursos da plataforma e clique em Diagnosticar e resolver

problemas, como mostrado na seguinte captura de tela:
2. Logo depois, você passará para outra folha, em que poderá escolher a categoria
certa para os problemas que estiver solucionando no momento. Clique
em 5xx Erros para exibir detalhes sobre as exceções que os usuários finais
enfrentam, como mostrado na seguinte captura de tela:
[ 160 ]
Capítulo 6
3. Isso mostrará a você Disponibilidade e Performance da Função e Falhas

do Aplicativo. Clique na opção Disponibilidade e Performance da Função
para exibir os links reais, conforme mostrado na seguinte captura de tela:
4. Clique em Execuções e Erros da Função para exibir as exceções detalhadas,

E mais...
Cada evento de função é registrado em um serviço de armazenamento de tabela do Azure.
Todos os meses, uma tabela é criada com o nome AzureWebJobsHostLogs<ano><mês>.
[ 161 ]
Como parte da solução de problemas, se você quiser obter mais detalhes sobre qualquer
erro, primeiro localize o campo ID na seção Detalhes da Invocação, conforme mostrado
Procure esses dados na coluna RowKey da tabela AzureWebJobsHostLogs<ano><mês>,

Como mostrado na captura de tela anterior, você receberá a entrada de log armazenada
no armazenamento de tabela. Clicar na linha abrirá os detalhes completos do erro, como
[ 162 ]
Capítulo 6
Integração do Azure Functions com

O Application Insights é um serviço de gerenciamento de performance do aplicativo.
Depois de integrar o Application Insights em seu aplicativo, ele começará a enviar dados
de telemetria para sua conta do Application insights, hospedada na nuvem. Nesta receita,
você aprenderá como é simples integrar o Azure Functions com o Application Insights.
Preparação
Criamos uma conta do Application Insights na receita Teste e validação da capacidade
de resposta do Azure Functions usando o Application insights do Capítulo 5, Exploração
de ferramentas de teste para a validação do Azure Functions. Crie uma conta, caso ainda não
tenha feito isso, seguindo as seguintes etapas:
1. Navegue até o portal de gerenciamento do Azure, clique em Criar um recurso

e selecione Ferramentas de gerenciamento.
2. Escolha Application Insights e forneça todos os detalhes necessários. Se você
já tiver criado uma conta do Application Insights na receita anterior, poderá
ignorar essa etapa.
[ 163 ]
Como fazer isso...

1. Depois que a conta do Application Insights for criada, navegue até a guia
Visão geral e vá até Chave de Instrumentação, conforme mostrado na seguinte
captura de tela:
2. Navegue até Aplicativos de função, para os quais você gostaria de habilitar

o monitoramento e vá até Configurações do aplicativo.
3. Adicione uma nova chave com o nome APPINSIGHTS_INSTRUMENTATIONKEY
e forneça a chave de instrumentação que você copiou da conta do Application
Insights, mostrada da seguinte maneira e, depois, clique em Salvar para salvar
as alterações:
4. Pronto. Você pode começar a utilizar todos os recursos do Application Insights

para monitorar a performance do Azure Functions. Abra o Application
Insights e a função RegisterUser em duas guias diferentes para testar como
o Live Metrics Stream funciona:
°° Abra o Application Insights e clique em Live Metrics Stream
na primeira guia do seu navegador, conforme mostrado na seguinte
captura de tela:
[ 164 ]
Capítulo 6
°° Abra um dos Azure Functions (no meu caso, abri o gatilho de HTTP)
em outra guia e execute alguns testes para garantir que ele emita alguns
logs para o Application Insights.
5. Depois de concluir esses testes, vá para a guia que tem o Application Insights.
Você verá o tráfego ao vivo passando para o seu aplicativo de função, como
[ 165 ]
Como funciona...
Criamos uma conta do Application Insights. Após integrar a Chave de Instrumentação
do Application Insights com o Azure Functions, o tempo de execução cuidará de enviar
os dados de telemetria de forma assíncrona para sua conta do Application Insights.
E mais...
No Live Metrics Stream, você também pode exibir todas as instâncias, junto com alguns
outros dados, como o número de solicitações por segundo tratadas por suas instâncias.
Monitoramento do Azure Functions

Agora entendemos como integrar o Azure Functions com o Application Insights. Vejamos
agora como exibir os logs que são gravados no Application Insights pelo código do Azure
Functions para que, como desenvolvedor, você possa solucionar exceções que ocorram.
Vamos fazer uma pequena alteração na função do gatilho de HTTP e, depois, executá-lo
algumas vezes.
Como fazer isso...

1. Navegue até o gatilho de HTTP que você criou e substitua o código a seguir.
Acabei de mover a linha de código que registra as informações para o console
Logs e adicionei o parâmetro name no final do método:
ILogger log)
{
string requestBody = await new
StreamReader(req.Body).ReadToEndAsync();
dynamic data = JsonConvert.
DeserializeObject(requestBody);
name = name ?? data?.name;
log.LogInformation($"C# HTTP trigger function processed
a request with the input value {name}");
return name != null
? (ActionResult)new OkObjectResult($"Hello, {name}")
: new BadRequestObjectResult("Please pass a name on
the query string or in the request body");
}
[ 166 ]
Capítulo 6
2. Agora, execute a função fornecendo o valor para o parâmetro name com valores
diferentes, como Azure Test Run 1, Azure Test Run 2 e Azure Test Run
3. Isto é apenas para fins de demonstração. Você pode usar a entrada da sua
preferência. O console Logs mostrará a seguinte saída:
3. Os logs no console Logs anterior só estarão disponíveis quando você estiver

conectado ao console Logs. Você não irá obtê-los quando estiver offline.
É nesse momento que o Application Insights é útil. Navegue até a instância
do Application Insights que você integrou com o aplicativo de função do Azure.
4. Clique no botão Análise que está disponível na guia Visão geral do Application
Insights, conforme mostrado nesta captura de tela:
[ 167 ]
5. Na janela consulta de análise, digite o comando traces | sort by timestamp

desc, que retorna todos os rastreamentos classificados por data decrescente,
Como funciona...
No gatilho de HTTP, adicionamos uma instrução log que exibe o valor do parâmetro
name que o usuário fornece. Executamos o gatilho de HTTP algumas vezes. Após algum
tempo, clique no botão Análise no Application Insights, que abre a janela Análise, em
que você pode gravar consultas para exibir os dados de telemetria que estão sendo
emitidos pelo Azure Functions. Tudo isso pode ser obtido sem escrever códigos
personalizados.
Envio de detalhes de telemetria

personalizados para o Application
Insights Analytics
Nossos clientes solicitaram que você fornecesse relatórios analíticos para uma
métrica derivada no Application Insights. O que é uma métrica derivada? Por padrão,
o Application Insights fornece muitas informações sobre métricas, como solicitações,
erros, exceções e assim por diante.
Você pode executar consultas sobre as informações que o Application Insights fornece
usando sua linguagem de consulta de análise.
[ 168 ]
Capítulo 6
Nesse contexto, as solicitações por hora são uma métrica derivada. Se você quiser
criar um novo relatório no Application Insights, precisará alimentar o Application
Insights sobre a nova métrica derivada regularmente. Depois de alimentar os dados
necessários regularmente, o Application Insights fornecerá relatórios para sua análise.
Utilizaremos o Azure Functions que alimenta o Application Insights com uma métrica
derivada denominada solicitações por hora:
Para este exemplo, desenvolveremos uma consulta usando a linguagem de consulta

de análise para a métrica derivada solicitação por hora. Você pode fazer alterações
na consulta para gerar outras métricas derivadas para seus requisitos, digamos,
solicitações por hora para minha campanha ou algo semelhante.
Você pode saber mais sobre a linguagem de consulta de análise em

https://docs.microsoft.com/en-us/azure/application-
insights/app-insights-analytics-reference.
[ 169 ]
Preparação
Execute as seguintes etapas de pré-requisitos:
1. Crie uma nova conta do Application Insights, caso ainda não tenha uma.
2. Verifique se você tem um aplicativo em execução que se integre com
o Application Insights. Você pode aprender como integrar seu aplicativo com o
Application Insights em https://docs.microsoft.com/en-us/azure/
application-insights/app-insights-asp-net.
É recomendável criar esta receita e as duas seguintes em um

aplicativo de função do Azure separado que se baseia em tempo
de execução v1, pois esses modelos ainda não estão disponíveis
na v2. No momento, se não encontrar o modelo Análise
Agendada do Application Insights, altere a versão do tempo
de execução do Azure Functions para v1, definindo o valor
de FUNCTIONS_EXTENSIONS_VERSION como ~1, conforme
mostrado nesta captura de tela, nas configurações do aplicativo
do Azure Functions:
Como fazer isso...

Executaremos as seguintes etapas para enviar detalhes de telemetria personalizados para
o Application Insights Analytics.
[ 170 ]
Capítulo 6
Criação de uma função do Application Insights

1. Crie um novo modelo de função escolhendo Monitoramento no menu suspenso

Cenário, conforme mostrado na captura de tela a seguir. Você também pode
procurar análises agendadas para encontrar facilmente o modelo:
2. Agora, clique em C# (mostrado na captura de tela anterior) e forneça o nome

junto com a frequência de agendamento na qual a função precisa ser executada:
3. Como mostrado na imagem anterior, clique no botão Criar para criar a função.
[ 171 ]
Configuração de chaves de acesso

1. Navegue até a folha Visão geral do Application Insights, conforme mostrado.

Copie a Chave de Instrumentação. Utilizaremos a Chave de Instrumentação
para criar uma configuração de aplicativo denominada AI_IKEY no aplicativo
de função:
2. Navegue até a folha Acesso à API e copie a ID do aplicativo. Utilizaremos

esta ID do aplicativo para criar uma nova configuração de aplicativo
com o nome AI_APP_ID no aplicativo de função:
3. Também precisamos criar uma nova chave de API. Conforme mostrado na etapa
anterior, clique no botão Criar chave de API para gerar a nova chave de API,
conforme mostrado na captura de tela a seguir. Forneça um nome significativo,
verifique os dados de Telemetria de leitura e clique em Gerar chave:
[ 172 ]
Capítulo 6
4. Logo depois, você poderá ver e copiar a chave, como mostrado na captura de
tela a seguir. Utilizaremos isso para criar uma nova configuração de aplicativo
com o nome AI_APP_KEY no nosso aplicativo de função:
[ 173 ]
5. Crie todas as três chaves de configuração de aplicativo no aplicativo de função,

conforme mostrado na captura de tela a seguir. Essas três chaves serão usadas
em nosso Azure Functions denominado FeedAIwithCustomDerivedMetric.
Integração e teste de uma consulta do Application

Insights
1. Agora, é hora de desenvolver uma consulta que nos forneça o valor de métrica
derivada de solicitações por hora. Navegue até a folha Visão geral do
Application Insights e clique no botão Análise.
2. Você passará para a folha Análise. Grave a seguinte consulta na guia de consulta.
Você pode gravar sua própria consulta conforme suas exigências. Certifique-se
de que a consulta retorne um valor escalar:
requests
| where timestamp > now(-1h)
| summarize count()
3. Ao concluir sua consulta, execute-a clicando no botão Executar para verificar

a contagem de registros, como mostrado na seguinte captura de tela:
[ 174 ]
Capítulo 6
4. Agora estamos prontos com a consulta necessária do Application Insights. Vamos

integrar a consulta com a nossa função FeedAIwithCustomDerivedMetrics.
Navegue até o editor de código do Azure Functions e faça as seguintes alterações:
1. Forneça um nome significativo para sua métrica derivada, neste caso,
Solicitações por hora.
2. Substitua a consulta padrão pela que desenvolvemos.
3. Salve as alterações, clicando no botão Salvar:
5. Vamos fazer um teste rápido para ver se você definiu as três configurações
do aplicativo e a consulta corretamente. Navegue até a guia Integrar e altere
a frequência de execução para um minuto, conforme mostrado nesta captura
de tela:
[ 175 ]
6. Agora, vamos navegar até a guia Monitorar e ver se tudo está funcionando bem.
Em caso de problemas, você verá uma marca X na coluna Status. Exiba o erro
na seção Logs da guia Monitorar clicando na entrada Log de invocação:
7. Após gar

Idioma

Computação Sem Servidor Do Azure

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Computação Sem Servidor Do Azure

Enviado por

Direitos autorais:

Formatos disponíveis

Computação

Receitas para criar e monitorar aplicativos controlados por evento usando

Receitas para criar e monitorar aplicativos controlados

Praveen Kumar Sreeram

A Packt Publishing empenha-se em fornecer informações de marca registrada sobre

Editor de comissionamento: Vijin Boricha

Primeira publicação: agosto de 2017

Referência de produção: 1301118

Publicado pela Packt Publishing Ltd.

Por que se inscrever?

Em www.PacktPub.com, você também pode ler uma coleção de artigos técnicos

Primeiramente, gostaria de agradecer à equipe da Packt Publishing,

Gostaria de agradecer minha avó, Neelavatamma, meu pai, Kamalakar,

Gostaria de expressar minha mais profunda gratidão a Bhagyamma

Em primeiro lugar, gostaria de agradecer a Almighty Allah, minha família

Michael Sync (SOE Htike) é um engenheiro sênior que trabalha na Readify na

A Packt está à procura de autores

Capítulo 2: Trabalhar com notificações usando os serviços

Como fazer isso... 53

Conexão à nuvem de armazenamento do Azure a partir

Criação e testes locais do Azure Functions usando ferramentas

Como funciona... 182

Maneira sem servidor do Durable de implementar uma importação do Excel 217

Desenvolvimento do Azure Function – gatilho de fila 249

Como acessar com segurança o Banco de Dados SQL

Criar e gerar especificações de API abertas usando o Swagger 311

Como funciona... 358

Os benefícios da computação sem servidor abrangem toda a organização e todo o ciclo

• Para o desenvolvedor, ela representa o foco total no valor. A criação de

• Aplicativos Web, que hospedam o lado do cliente e back-end em um serviço

• Aplicativos direcionados a eventos que usam funções sem servidor, aproveitando

O livro começa com receitas de nível intermediário em computação sem servidor,

A quem este livro se destina

Capítulo 4, Noções básicas sobre a experiência integrada de desenvolvedor de Ferramentas

Capítulo 10, Configuração de aplicativos sem servidor no ambiente de produção, demonstra

Aproveite ao máximo este livro

Download dos arquivos de exemplo de

1. Faça logon ou registre-se em http://www.packtpub.com.

Assim que o arquivo é baixado, certifique-se de descompactar ou extrair a pasta usando

• WinRAR / 7-Zip para Windows

O pacote de código para o livro também está hospedado no GitHub em

Download dos arquivos EPUB/mobi

Download das imagens coloridas

CodeInText: indica palavras de código em texto, nomes de tabela de banco de dados,

Um bloco de código é definido da seguinte forma:

Qualquer entrada de linha de comando ou saída é escrita como segue:

Avisos ou notas importantes aparecem desta

Dicas e truques aparecem desta forma.

Como fazer isso…

Comentários gerais: enviar email para feedback@packtpub.com e mencionar o título

Errata: embora tomemos o máximo de cuidado para garantir a precisão de nosso

Se você está interessado em se tornar um autor: se há um tópico no qual você

Para obter mais informações sobre o Packt, acesse packtpub.com.

• Criar uma API Web de back-end usando gatilhos HTTP

A seguir, um diagrama simples que ajuda a compreender o que alcançaremos neste

Criar uma API Web de back-end usando

Vamos usar o C# como a linguagem de programação em todo

Como fazer isso…

1. Navegue até a página de listagem do Aplicativo de Função clicando no menu

4. Na próxima etapa, selecione Mais modelos e clique em Concluir e exibir

5. Na seção Escolha um modelo abaixo ou acesse o início rápido, escolha Gatilho

6. Forneça um nome significativo. Para este exemplo, usei RegisterUser como

8. Clique no botão Criar para criar a função de gatilho de HTTP.

Como fazer isso... 53

Como funciona... 182

Maneira sem servidor do Durable de implementar uma importação do Excel 217

Desenvolvimento do Azure Function – gatilho de fila 249

Criar e gerar especificações de API abertas usando o Swagger 311

Como funciona... 358