<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Marcelo Bezerra on Medium]]></title>
        <description><![CDATA[Stories by Marcelo Bezerra on Medium]]></description>
        <link>https://medium.com/@bovino-dev?source=rss-77ac877038e2------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*xprhqOH0vh9mixZ7</url>
            <title>Stories by Marcelo Bezerra on Medium</title>
            <link>https://medium.com/@bovino-dev?source=rss-77ac877038e2------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Thu, 19 Nov 2026 21:01:31 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@bovino-dev/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Vou participar do Meetup Codecon Brasilia — 25 de Junho 2026! Bora?]]></title>
            <link>https://medium.com/@bovino-dev/vou-participar-do-meetup-codecon-brasilia-junho-2026-bora-1a1c696c94e6?source=rss-77ac877038e2------2</link>
            <guid isPermaLink="false">https://medium.com/p/1a1c696c94e6</guid>
            <category><![CDATA[ai]]></category>
            <category><![CDATA[software-engineering]]></category>
            <category><![CDATA[software-development]]></category>
            <category><![CDATA[generative-ai-tools]]></category>
            <dc:creator><![CDATA[Marcelo Bezerra]]></dc:creator>
            <pubDate>Tue, 16 Jun 2026 17:12:32 GMT</pubDate>
            <atom:updated>2026-06-16T17:13:04.454Z</atom:updated>
            <content:encoded><![CDATA[<p>Estarei participando do meetup Codecon Brasilia, como integrante de um painel com o tema “Prompt não é processo: como estruturar soluções com IA”. Tambem vai participar do painel o colega Alexandre Castro (Specialist GenAI Engineer na Serasa Experian).</p><p>Link para inscrições e mais informações: <a href="https://eventos.codecon.dev/eventos/brasilia-meetup-codecon-3">https://eventos.codecon.dev/eventos/brasilia-meetup-codecon-3</a></p><p><strong>Tem</strong>á<strong>tica do painel: <br></strong>A IA pode acelerar entregas, gerar código e aumentar a produtividade, mas construir boas soluções vai muito além de escrever prompts. Neste painel, vamos discutir como equilibrar o uso da IA com o julgamento crítico, a experiência e as decisões que fazem parte do trabalho de desenvolvimento. Uma conversa sobre produtividade, responsabilidade e o papel dos profissionais em um mundo cada vez mais assistido por inteligência artificial.</p><p><strong>Programa:</strong></p><ul><li>Painel (19h as 20h30)</li><li>Coffee break e momento de networking oferecido pelo Asaas <br>(20h30 as 21h30)</li><li>Local do evento — Blocks Coworking<br>Av Castanheiras com Rua 30 Norte, Lote 4, Piso 3, Bloco A Ed. Cosmopolitan — Águas Claras<br>Brasília, DF</li><li>Link para mapa do local: <a href="https://www.google.com/maps/search/?api=1&amp;query=Av%20Castanheiras%20com%20Rua%2030%20Norte%2C%20Lote%204%2C%20Piso%203%2C%20Bloco%20A%20Ed.%20Cosmopolitan%20-%20%C3%81guas%20Claras%2C%20Bras%C3%ADlia%2C%20DF">https://www.google.com/maps/search/?api=1&amp;query=Av%20Castanheiras%20com%20Rua%2030%20Norte%2C%20Lote%204%2C%20Piso%203%2C%20Bloco%20A%20Ed.%20Cosmopolitan%20-%20%C3%81guas%20Claras%2C%20Bras%C3%ADlia%2C%20DF</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1a1c696c94e6" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Meu time VENCEU o Hackaton Virtual 2022 da Kong e vamos nos apresentar hoje (25/10) no meetup…]]></title>
            <link>https://medium.com/@bovino-dev/meu-time-venceu-o-hackaton-virtual-2022-da-kong-e-vamos-nos-apresentar-hoje-25-10-no-meetup-fde137e06131?source=rss-77ac877038e2------2</link>
            <guid isPermaLink="false">https://medium.com/p/fde137e06131</guid>
            <category><![CDATA[hackathons]]></category>
            <category><![CDATA[kong]]></category>
            <category><![CDATA[open-source]]></category>
            <dc:creator><![CDATA[Marcelo Bezerra]]></dc:creator>
            <pubDate>Tue, 25 Oct 2022 15:14:12 GMT</pubDate>
            <atom:updated>2022-10-26T13:03:34.750Z</atom:updated>
            <content:encoded><![CDATA[<h3>Meu time VENCEU o Hackaton Virtual 2022 da Kong e vamos nos apresentar hoje (25/10) no meetup oficial da Kong Brasil!</h3><p>No meu post anterior informei que havia montado uma equipe (que demos o nome de “BR HEXA”) e submetemos uma participação para o Hackaton Virtual 2022 da Kong.</p><p><strong>[UPDATE: o vídeo com a gravação da apresentação no meetup da Kong já está disponível no YouTube, confere ai]</strong></p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2FWnj4pmSfSCY%3Ffeature%3Doembed&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DWnj4pmSfSCY&amp;image=https%3A%2F%2Fi.ytimg.com%2Fvi%2FWnj4pmSfSCY%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/19b7d2642ca16ec06a0804e8b43012be/href">https://medium.com/media/19b7d2642ca16ec06a0804e8b43012be/href</a></iframe><p><strong>Link de acesso ao repositório GitHub do nosso projeto:</strong> <a href="https://github.com/mateuslima90/kong-plugin-totp-validator">https://github.com/mateuslima9</a>0</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RG8eavgCwIaeedcPUHLqQA.png" /></figure><p>Esse repositório contém:</p><ul><li>um plugin opensource escrito em Lua para o Kong Gateway (já testado na nova major release 3.0 do Kong)</li><li>documentação com exemplos de uso e configuração do plugin</li><li>script Docker Compose para rodar localmente o Kong e o HashiCorp Vault</li><li>uma collection do Postman com chamadas prontas para as rotas do projetos e para os endpoints da API do Hashicorp Vault</li></ul><p>Temos também apresentações em slides e um vídeo curto (pitch) de demonstração, confere ai.</p><p><strong>Slides:</strong> <a href="https://docs.google.com/presentation/d/14WFGPD53HxOksOrHuONl8-0Xh-XWyW83TkNWGYdrBQY/edit?usp=sharing">https://docs.google.com/presentation/d/14WFGPD53HxOksOrHuONl8-0Xh-XWyW83TkNWGYdrBQY/edit?usp=sharing</a></p><p><strong>Video de demonstração:</strong> <a href="https://drive.google.com/file/d/1J0sgv9Bo5v6luGY3RIGbnlr6VWxKnzcF/view?usp=sharinghttps://drive.google.com/file/d/1J0sgv9Bo5v6luGY3RIGbnlr6VWxKnzcF/view?usp=sharing">https://drive.google.com/file/d/1J0sgv9Bo5v6luGY3RIGbnlr6VWxKnzcF/view?usp=sharinghttps://drive.google.com/file/d/1J0sgv9Bo5v6luGY3RIGbnlr6VWxKnzcF/view?usp=sharing</a></p><p>Pois bem: meu time VENCEU a competição com o prêmio de “Top Overall Contribuition”. Um resultado excepcional que nos deixa muito orgulhosos e felizes.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*M407k3BisqS5VhMj" /></figure><p>E melhor ainda, estaremos hoje (data desta postagem) nos apresentando no meetup oficial da Kong com uma talk entitulada “Hackathon, Kong e proteção OneTimePassword: uma jornada épica rumo a vitória”, será online e às 19h. Para participar se cadastre gratuitamente aqui (<a href="https://www.meetup.com/kong-sao-paulo/events/289162362/">https://www.meetup.com/kong-sao-paulo/events/289162362/</a>).</p><p>Em nossa apresentação de hoje traremos os seguintes tópicos:</p><ul><li>porque um modelo de autenticação baseado apenas em login e senha pode não ser suficiente e por que soluções de autenticação de vários fatores (2FA ou MFA) são necessárias</li><li>uma introdução ao TOTP (time-based one time password)</li><li>uma apresentação e demonstração do plugin de Kong que desenvolvemos para proteção OTP e que foi o vencedor do Hackaton Virtual 2022 da Kong</li><li>algumas dicas sobre como se destacar ao participar de futuros hackatons da Kong (mas as dicas valem para outros hackatons também)</li></ul><p>Já estamos animados para os próximos hackatons e torcemos para que a nossa vitória incentive e fortaleça a comunidade Kong Brasil!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=fde137e06131" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Meu time submeteu um projeto para o Hackaton Virtual 2022 da Kong :-D]]></title>
            <link>https://medium.com/@bovino-dev/meu-time-submeteu-um-projeto-para-o-hackaton-virtual-2022-da-kong-d-e5e6f2968cb3?source=rss-77ac877038e2------2</link>
            <guid isPermaLink="false">https://medium.com/p/e5e6f2968cb3</guid>
            <category><![CDATA[one-time-password]]></category>
            <category><![CDATA[totp]]></category>
            <category><![CDATA[backend-development]]></category>
            <category><![CDATA[kong-api-gateway]]></category>
            <category><![CDATA[lua]]></category>
            <dc:creator><![CDATA[Marcelo Bezerra]]></dc:creator>
            <pubDate>Mon, 26 Sep 2022 05:38:13 GMT</pubDate>
            <atom:updated>2022-09-26T05:38:13.355Z</atom:updated>
            <content:encoded><![CDATA[<h3>Meu time submeteu um projeto para o Hackaton Virtual 2022 da Kong :-D</h3><p>Eu e dois colegas (<a href="https://www.linkedin.com/in/mateus-lima-fonseca/">Mateus Fonseca</a> e <a href="https://www.linkedin.com/in/camanducci/">Robson Camanducci</a>) submetemos um projeto / contribuição para o <a href="https://konghq.com/conferences/kong-summit/hackathon">Hackaton Virtual 2022 da Kong</a>!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*aWPGy8jVCbbdCGHTwBcJ2Q.png" /></figure><p>Este projeto opensource é um plugin (escrito em Lua) para o Kong API Gateway que permite proteger rotas e serviços que estejam expostas via Kong, de modo a fazer com que essas rotas passem a exigir que o chamador forneça código TOTP válido.</p><p>O plugin funciona interceptando as solicitações que estão sendo feitas e confirmando (com solicitações HTTP para a API de um provedor TOTP como o Hashicorp Vault) se o código foi fornecido pelo chamador do serviço possui um código no local definido (corpo ou cabeçalho) e se o código fornecido ainda está válido (sendo um time-based one-time password, o código não será aceito se estiver expirado).</p><p>Este plugin foi desenvolvido e testado no Kong Gateway 2.8.1 e também já está testado para o funcionamento com a nova versão release do Kong Gateway, a versão 3.0.0.</p><p>Convido os senhores a darem uma olhadinha: <a href="https://github.com/mateuslima90/kong-plugin-totp-validator">https://github.com/mateuslima90/kong-plugin-totp-validator</a></p><p>Tem também um vídeo no YouTube com alguma explicação e uma demonstração prática do plugin: <br><a href="https://www.youtube.com/watch?v=oAa2TTvXXbI">https://www.youtube.com/watch?v=oAa2TTvXXbI</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=e5e6f2968cb3" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Avaliando e melhorando desempenho de APIs rodando em NodeJS — Parte 1]]></title>
            <link>https://medium.com/@bovino-dev/avaliando-e-melhorando-desempenho-de-apis-rodando-em-nodejs-parte-1-51aacfab173b?source=rss-77ac877038e2------2</link>
            <guid isPermaLink="false">https://medium.com/p/51aacfab173b</guid>
            <category><![CDATA[nodejs]]></category>
            <category><![CDATA[api-development]]></category>
            <category><![CDATA[libuv]]></category>
            <category><![CDATA[event-loop]]></category>
            <dc:creator><![CDATA[Marcelo Bezerra]]></dc:creator>
            <pubDate>Wed, 27 Jul 2022 12:17:17 GMT</pubDate>
            <atom:updated>2022-07-27T18:18:39.541Z</atom:updated>
            <content:encoded><![CDATA[<h3>Avaliando e melhorando desempenho de APIs rodando em NodeJS — Parte 1</h3><p>Este artigo irá abordar algumas técnicas para avaliar e melhorar o desempenho de APIs rodando em NodeJS. Por se tratar de assunto um tanto extenso o artigo será dividido em partes. As partes deste artigo são uma versão extendida e mais detalhada da palestra intitulada “Avaliando e melhorando desempenho de APIs escritas em NodeJS”, que apresentei no TDC Innovation 2022 na trilha JavaScript e NodeJS (<a href="https://thedevconf.com/tdc/2022/innovation/trilha-javascript-e-nodejs">https://thedevconf.com/tdc/2022/innovation/trilha-javascript-e-nodejs</a>).</p><p><strong>Introdução</strong></p><p>Por possuir um modelo de processamento que por padrão é single threaded (e baseado num loop de eventos, o famoso <strong>EventLoop</strong>), muitos desenvolvedores tem dúvidas sobre como fazer para obter um melhor desempenho em aplicações rodando no NodeJS, e em especial há dúvidas de como fazer aplicações backend e APIs utilizarem todos os recursos computacionais e os vários cores (núcleos) de processamento disponíveis nos computadores modernos.</p><p>Também é muito comum que desenvolvedores tenham dúvidas de como avaliar e encontrar os gargalos de desempenho em suas aplicações, de modo que possam decidir acertadamente onde vale mais a pena investir tempo em otimização e refactoring.</p><p>Neste artigo apresento alguns conceitos , técnicas e ferramentas que auxiliarão os desenvolvedores a identificar o nível de desempenho atual bem como a extrair um melhor desempenho de suas APIs rodando em NodeJS.</p><p><strong>Porque é importante avaliar o desempenho de suas APIs?</strong></p><p>Avaliar o desempenho das suas APIs importa por uma série de razões, incluindo reduzir custos com infra-estrutura e cloud. Num contexto em que em muitas organizações migraram de uma arquitetura monolítica para uma arquitetura de micro-serviços, em que possivelmente haverá uma grande quantidade de integrações realizadas por APIs, garantir que estas APIs tem a melhor performance possível se torna algo crítico para o sucesso.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*3i2gj1JsoCdh-9Kw" /></figure><p>É muito importante observar que quando migramos uma aplicação monolítica para um conjunto de micro-serviços, migramos para uma arquitetura distribuída e passamos a ter várias chamadas RPC (Remote Procedure Calls) que introduzirão algum nível de latência. Portanto, é necessário cuidar bem do desempenho das suas APIs para que não acabemos tendo uma aplicação em micro-serviços que tem performance inferior a aplicação monolítica da qual estamos migrando.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*nuaMbO1UNOP6kfc-" /></figure><p>Considerando organizações que trabalhem não apenas com arquiteturas de micro-serviços mas que também atuam desenvolvendo softwares como serviços (SaaS), existem metodologias que podem ser aplicadas para aumentar as chances de sucesso destas iniciativas tais como a “12 Factor App” (<a href="https://12factor.net/pt_br/">https://12factor.net/pt_br/</a>), que foi criada por um grupo de desenvolvedores da Heroku em 2011.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*2ZkJ_5YPqr_y9Vpz" /></figure><p>Lendo os 12 fatores, você irá perceber que um dos tópicos diz respeito a capacidade de escalar aplicações sem ter que fazer grandes mudanças na arquitetura da mesma. Isso evidencia como é importante saber avaliar e melhorar de uma API que faça parte do desenvolvimento de um projeto de SaaS.</p><p>A metodologia dos 12 fatores já recebeu algumas sugestões e contribuições da comunidade, e uma delas recebeu o nome (nada original rs) de “15 fatores”, acrescentando na lista preocupações referentes a trabalhar em um modelo API First, questões referentes a observabilidade (telemetria) e segurança (autenticação e autorização).</p><p>Você pode ler mais sobre esses “15 fatores” aqui: <a href="https://developer.ibm.com/articles/15-factor-applications/">https://developer.ibm.com/articles/15-factor-applications/</a></p><p><strong>Considerações sobre o modelo de processamento do NodeJS e sobre o EventLoop</strong></p><p>O Node.js possui dois tipos de threads: uma thread principal tratada pelo <strong>event loop</strong> e várias threads auxiliares (executando em background e portantro fora do “fluxo quente” do evento loop) em um <strong>worker pool (ou thread pool)</strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*j0ge9aZV7fqIjelC" /></figure><p>O <strong>event loop</strong> é a infra-estrutura que recebe callbacks (funções) e os registra para serem executados posteriormente no futuro. Ele é executado na mesmo thread que o próprio código JavaScript principal. Quando uma operação JavaScript bloqueia a thread principal, isso significa na prática que o <strong>event loop</strong> também está bloqueado, e isso deve ser evitado a todo custo pois é uma das principais razões de baixo desempenho e pouca responsividade em aplicações Node. Você ler mais sobre este aspecto em específico na documentação do Node: <a href="https://nodejs.org/en/docs/guides/dont-block-the-event-loop/">https://nodejs.org/en/docs/guides/dont-block-the-event-loop/</a></p><p>Um <strong>worker pool</strong> é um modelo de execução que gera e manipula threads separadas, ele executa a tarefa de forma síncrona e retorna o resultado para o <strong>event loop</strong>. O <strong>event loop</strong> então pode executar o retorno de chamada fornecido com o referido resultado.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*TWOKfHJ4J7QdX-tf" /></figure><p>Basicamente, os <strong>worker pools</strong> lidam com operações de I/O assíncronas — principalmente, interações com disco e chamadas de rede. Alguns módulos do Node usam <strong>worker pools</strong> por padrão como o fs (que faz trabalho pesado de I/O) ou módulos de criptografia (que fazem trabalhos pesados em termos de consumo de CPU).</p><p>O gerenciamento e controle do <strong>worker pool</strong> é implementado usando a <strong>libuv</strong>, o que resulta em pequenos atrasos sempre que o Node precisa transmitir dados internamente entre JavaScript e a implementação em C++ da <strong>libuv</strong>, mas isso dificilmente chega a ser perceptível.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/880/0*hDUiKZPV8eNz5Eeb" /></figure><p>Para os desenvolvedores de aplicações Node, é importante saber que praticamente todos os métodos I/O da biblioteca padrão tem uma versão assíncrona, que, por definição, são não-bloqueantes, e aceitam funções de callback. Alguns métodos também tem suas versões bloqueantes, que possuem o sufixo <strong>Sync</strong> no nome, isso pode ser visto nos exemplo de código abaixo:</p><p>Código com execução síncrona (note o uso da função “readFileSync”)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/760/1*cT9RFhdAsUC01cWzP0MIMg.png" /></figure><p>Código com execução assíncrona (note o uso da função “readFile” que é assíncrona)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/535/1*bngLgfJirVLgs4Onoh7dMA.png" /></figure><p><strong>Conhecendo melhor a LibUV</strong></p><p>A libuv (<a href="https://libuv.org/">https://libuv.org/</a>) é uma biblioteca escrita em C++ que ajuda na execução assíncrona de operações baseadas em I/O de maneira não bloqueante. Em termos simples, operações não bloqueantes podem ser definidas como sendo a capacidade de fazer operações de IO (acessar sistema de arquivos, banco de dados, rede, servidores, etc.) sem que a aplicação fique impedida de executar outras coisas em paralelo. Você pode obter mais informações sobre operações de IO bloqueantes e não bloqueantes na visão do Node, em sua própria documentação: <a href="https://nodejs.org/pt-br/docs/guides/blocking-vs-non-blocking/">https://nodejs.org/pt-br/docs/guides/blocking-vs-non-blocking/</a></p><p>A libuv foi desenvolvida principalmente para uso pelo Node, mas também é usada por outros projetos como o Luvit, Julia, uvloop e outros.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/600/0*YRg_070O78vGt23n" /></figure><p>Algumas das features mais importantes da libuv incluem:</p><ul><li>event loop com recursos completos (usa epoll, kqueue, IOCP e event ports)</li><li>TCP sockets, que em Node representam o módulo de rede</li><li>Resolução de DNS (parte das funções dentro do módulo dns são fornecidas pelo Libuv e algumas delas são fornecidas pelo c-ares)</li><li>UDP sockets, que representam o módulo dgram no Node</li><li>I/O de arquivo que inclui observação de arquivos, operações do sistema de arquivos (basicamente tudo dentro do módulo fs no Node)</li><li>Processos filhos (o módulo de child process no Node)</li><li>Um pool de threads de trabalho para lidar com tarefas de bloqueio de I/O (e desde o Node 10.5, o módulo worker threads está disponível para executar Javascript em processamento paralelo)</li><li>Primitivas de sincronização para threads (por exemplo, bloqueios, mutexes, semáforos, barreiras)</li><li>Relógio de alta resolução (se Date.now não for preciso o suficiente, process.hrtime pode ser usado)</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1020/0*mRBc5WgiwZXdV_O1.png" /></figure><p>Você pode entender melhor sobre o relacionamento entre o motor V8, a libuv e o código JavaScript executado por eles nos links abaixo</p><p><a href="https://medium.com/dkatalis/nodejs-architecture-relationship-between-libuv-v8-and-js-7dce74cf1c51">https://medium.com/dkatalis/nodejs-architecture-relationship-between-libuv-v8-and-js-7dce74cf1c51</a></p><p><a href="https://medium.com/softup-technologies/node-js-internals-libuv-and-the-event-loop-behind-the-curtain-30708c5ca83">Node.js Internals: Libuv and the event loop behind the curtain</a></p><p><a href="https://medium.com/softup-technologies/node-js-internals-libuv-and-the-event-loop-behind-the-curtain-30708c5ca83">https://medium.com/softup-technologies/node-js-internals-libuv-and-the-event-loop-behind-the-curtain-30708c5ca83</a></p><p><strong>Ações práticas para obter melhor desempenho das suas APIs escritas em Node</strong></p><p>Agora que já entendemos como funciona o <strong>event loop</strong> e o <strong>worker pool</strong>, podemos levar estas informações em consideração e elencar um conjunto básico de boas práticas para obter mais desempenho das suas APIs rodando em NodeJS:</p><ul><li>Estruturar sua aplicação de modo a evitar bloquear o <strong>event loop</strong> e o <strong>worker pool</strong> (<a href="https://nodejs.org/en/docs/guides/dont-block-the-event-loop/">https://nodejs.org/en/docs/guides/dont-block-the-event-loop/</a>), sendo cauteloso para não exagerar a quantidade de workers registrados e não realizar o dimensionamento inadequado das threads disponíveis (nem sempre criar mais workers necessariamente irá aumentar o desempenho)</li><li>Usar cache sempre que for possível , aplicando a estratégia de cache adequada para o contexto da sua API (<a href="https://blog.logrocket.com/caching-strategies-to-speed-up-your-api/">https://blog.logrocket.com/caching-strategies-to-speed-up-your-api/</a>)</li><li>Criar aplicações que são stateless (para poder rodar em containers e claro, em clusters kubernetes) e otimizar bem as suas imagens Docker (<a href="https://snyk.io/blog/10-best-practices-to-containerize-nodejs-web-applications-with-docker/">https://snyk.io/blog/10-best-practices-to-containerize-nodejs-web-applications-with-docker/</a>)</li><li>Rodar a aplicação em cluster mode caso ela não vá rodar em Kubernetes</li><li>Não usar console.log em produção (<a href="https://www.youtube.com/watch?v=H8DXniVxqFE">https://www.youtube.com/watch?v=H8DXniVxqFE</a>)</li><li>Fazer MUITOS testes incluindo testes de carga, testes de stress, testes de pico , testes de resistência, dentre outros</li><li>Não deixar erros em Promises e funções Async estourarem sem tratamento (erros não tratados em funções async poderão derrubar seu app). Você pode ver algumas formas de lidar com isso incluindo o uso de um pacote específico chamado “express-async-errors” (<a href="https://www.luiztools.com.br/post/error-handling-em-node-js-com-express/">https://www.luiztools.com.br/post/error-handling-em-node-js-com-express/</a>) caso sua API seja escrita com o Express</li><li>Evitar o callback hell (<a href="https://blog.risingstack.com/node-js-async-best-practices-avoiding-callback-hell-node-js-at-scale/">https://blog.risingstack.com/node-js-async-best-practices-avoiding-callback-hell-node-js-at-scale/</a>)</li><li>Não usar arquitetura de micro-serviços sem antes avaliar bem as consequências e o aumento da complexidade que isso irá acarretar (<a href="https://martinfowler.com/bliki/MonolithFirst.html">https://martinfowler.com/bliki/MonolithFirst.html</a>), mantendo em mente que as mudanças impactarão a estrutura organizacional e a comunicação entre diferentes equipes</li><li>Considere a possibilidade de usar outros frameworks além do Express como por exemplo o Fastify (voce pode ler mais sobre isso aqui <a href="https://www.fastify.io/benchmarks/">https://www.fastify.io/benchmarks/</a> e aqui <a href="https://github.com/fastify/benchmarks">https://github.com/fastify/benchmarks</a>)</li><li>Não confie nas configurações default</li><li>Sete valores otimizados para as V8 options, e você pode ler mais sobre isso aqui <a href="https://flaviocopes.com/node-runtime-v8-options/">https://flaviocopes.com/node-runtime-v8-options/</a> e aqui <a href="https://blog.logrocket.com/how-javascript-works-optimizing-the-v8-compiler-for-efficiency/">https://blog.logrocket.com/how-javascript-works-optimizing-the-v8-compiler-for-efficiency/</a> e aqui <a href="https://snird.medium.com/do-not-use-node-js-optimization-flags-blindly-3cc8dfdf76fd">https://snird.medium.com/do-not-use-node-js-optimization-flags-blindly-3cc8dfdf76fd</a></li><li>Tente reduzir a complexidade ciclomática (Big O) e a complexidade cognitiva (C-Cog: <a href="https://pt.slideshare.net/DouglasSiviotti/complexidade-cognitiva">https://pt.slideshare.net/DouglasSiviotti/complexidade-cognitiva</a>), usando ferramentas automáticas de análise estática do código como por exemplo o Sonar Qube ou a extensão CodeMetrics para VSCODE (<a href="https://marketplace.visualstudio.com/items?itemName=kisstkondoros.vscode-codemetrics">https://marketplace.visualstudio.com/items?itemName=kisstkondoros.vscode-codemetrics</a>)</li><li>Ler a documentação do NodeJS (<a href="https://nodejs.org/en/docs/">https://nodejs.org/en/docs/</a>)</li><li>Ler a documentação da sua ferramenta de teste de carga/stress/whatver para não subutilizar a ferramenta (exemplo: rodar testes com o Autocannon sem configurar o mesmo para usar vários workers)</li><li>Para aplicações que utilizam ORMs, verificar e otimizar as consultas que estão sendo executadas e cuidar para não cair em problemas como o famoso “SELECT N+1” (<a href="https://stackoverflow.com/questions/97197/what-is-the-n1-selects-problem-in-orm-object-relational-mapping#:~:text=The%20N%2B1%20query%20problem%20happens%20when%20the%20data%20access,the%20larger%20the%20performance%20impact">https://stackoverflow.com/questions/97197/what-is-the-n1-selects-problem-in-orm-object-relational-mapping#:~:text=The%20N%2B1%20query%20problem%20happens%20when%20the%20data%20access,the%20larger%20the%20performance%20impact</a>.)</li><li>Utilizar paginação nos endpoints de consulta</li><li>Aplicar compactação (alguns exemplos de como fazer isso com o Fastify aqui <a href="https://github.com/fastify/fastify-compress">https://github.com/fastify/fastify-compress</a> e com o Express aqui <a href="https://medium.com/@victor.valencia.rico/gzip-compression-with-node-js-cc3ed74196f9">https://medium.com/@victor.valencia.rico/gzip-compression-with-node-js-cc3ed74196f9</a>)</li><li>caso a sua API tenha “responsabilidades demais”, considere a possibilidade de delegar partes destas responsabilidades para um API Gateway (ex: rate limiting, segurança, validações spike arrest, roteamento dinâmico… dentre outras)</li><li>se a sua API for interna (comunicação leste-oeste), considere a possibilidade de usar gRPC ao invés de Rest (<a href="https://daily.dev/blog/build-a-grpc-service-in-nodejs">https://daily.dev/blog/build-a-grpc-service-in-nodejs</a>)</li></ul><p><strong>Rodando sua API em “Cluster Mode”</strong></p><p>O NodeJS possui um módulo cluster e com ele é possível , com poucas alterações no código, fazer com que a sua aplicação utilize melhor os recursos computacionais disponíveis na máquina em que está sendo executada.</p><p>Documentação: <a href="https://nodejs.org/api/cluster.html#cluster">https://nodejs.org/api/cluster.html#cluster</a></p><p>Estou disponibilizando dois repositórios mostrando, na prática, exemplos de implementação do Cluster mode em APIs de exemplo escritas em Fastify e Express. Estes mesmos repositórios possuem uma branch separada com a implementação da mesma API sem o uso do cluster mode, de modo que você possa verificar por conta própria (rodando testes de carga com a sua ferramenta favorita) a diferença brutal que o cluster mode pode trazer para uma API.</p><ul><li><a href="https://github.com/bovino/tdc-2022-fastify-api-with-cluster-mode/tree/with-cluster-mode">GitHub - bovino/tdc-2022-fastify-api-with-cluster-mode at with-cluster-mode</a></li><li><a href="https://github.com/bovino/tdc-2022-express-api-with-cluster-mode/tree/with-cluster-mode">GitHub - bovino/tdc-2022-express-api-with-cluster-mode at with-cluster-mode</a></li></ul><p>O Erick Wendell tem um ótimo vídeo explicando mais sobre o módulo Cluster do Node: <a href="https://www.youtube.com/watch?v=50-9uorSYw0">https://www.youtube.com/watch?v=50-9uorSYw0</a></p><p>Você também pode utilizar outras ferramentas tais como gerenciadores de processos, a exemplo do PM2</p><ul><li><a href="https://blog.rocketseat.com.br/pm2-com-funcionalidades-secretas/">PM2: Como utilizar no NodeJS e funcionalidades secretas</a></li><li><a href="https://imasters.com.br/back-end/executando-o-pm2-e-o-node-js-em-ambientes-de-producao">Executando o PM2 e o Node.js em ambientes de produção - iMasters - We are Developers</a></li></ul><p><strong>Conclusão</strong></p><p>Na próxima parte deste artigo, abordarei em mais detalhes a utilização de ferramentas de avaliação de desempenho, incluindo ferramentas para testes de carga e stress, além do Node Profiler (<a href="https://nodejs.org/en/docs/guides/simple-profiling/">https://nodejs.org/en/docs/guides/simple-profiling/</a>).</p><p>Na segunda parte também veremos como interpretar os resultados e informações geradas por estas ferramentas para ter mais clareza acerca de onde atuar para melhorar o desempenho das suas aplicações.</p><p>Na terceira parte deste artigo veremos como realizar trabalhos “pesados” com o Node, bem como veremos como trabalhar com processamento paralelo usando os “workers” e as “worker threads”. Veremos que é possível criar um worker para executar uma única tarefa fora do <strong>event loop</strong>, mas também podemos reutilizar o mesmo worker ao longo de várias execuções e ainda veremos como criar um “pool” de workers para processar um conjunto maior de tarefas.</p><p>Obrigado pela leitura e até a próxima :-)</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=51aacfab173b" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Introdução ao pattern API Gateway com o Kong Gateway]]></title>
            <link>https://medium.com/@bovino-dev/introdu%C3%A7%C3%A3o-ao-pattern-api-gateway-com-o-kong-gateway-8ff25a38e862?source=rss-77ac877038e2------2</link>
            <guid isPermaLink="false">https://medium.com/p/8ff25a38e862</guid>
            <category><![CDATA[spring-boot]]></category>
            <category><![CDATA[api]]></category>
            <category><![CDATA[api-gateway]]></category>
            <category><![CDATA[nodejs]]></category>
            <category><![CDATA[kong]]></category>
            <dc:creator><![CDATA[Marcelo Bezerra]]></dc:creator>
            <pubDate>Tue, 28 Jun 2022 13:50:09 GMT</pubDate>
            <atom:updated>2022-07-01T17:37:14.947Z</atom:updated>
            <content:encoded><![CDATA[<p><strong>[UPDATE 01/07/2022] este artigo foi mencionado numa lista de leituras recomendadas pelo Rodrigo Graciano, que é líder do NYJavaSIG , que é nada menos do que o maior Java User Group da América do Norte!</strong></p><p><strong>Calma que fica ainda mais legal que isso: nos posts de divulgação do Rodrigo Graciano, eu fui mencionado numa listagem juntamente com nomes como Vlad Mihalcea, Markus Eisele, Rafael Chinelato del Nero (os 3 são Java Champions!) e Alex Ellis! Eu não tenho nem roupa pra isso….</strong></p><p><strong>Confere ai: </strong><a href="https://graciano.dev/2022/06/30/weekend-reading-list-130/">https://graciano.dev/2022/06/30/weekend-reading-list-130/</a></p><p><strong>Introdução</strong><br>Conheça o que é o padrão API Gateway, aplique este padrão com o Kong API Gateway e entenda como ele pode ajudar o seu time a criar uma arquitetura de micro-serviços</p><p><strong>Monolitos x Micro-Serviços: A saga da migração e modernização tecnológica</strong></p><p>Antes de falarmos diretamente sobre o pattern API Gateway e sobre o Kong, gostaria de discutir sobre a adoção da arquitetura de micro-serviços e os desafios que ela costuma apresentar.</p><p>Imagine que uma empresa atualmente possua uma grande aplicação monolítica que precisará ser migrada para micro-serviços. Imagine uma aplicação empresarial que possua módulos como RH, Financeiro, Marketing, Segurança dentre outros. Ao decompor e migrar sua aplicação monolítica para vários micro-serviços, estes micro-serviços precisarão se comunicar entre si, e esta comunicação tipicamente ocorrerá por intermédio de APIs.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*ThJtSYuYHKsdm395" /></figure><p>Perceba que ao fazer isso, a complexidade tende a aumentar por algumas razões, dentre as quais destaco:</p><ul><li>mudanças na estrutura organizacional (impactos culturais, estruturação e capacitação dos times etc….), no final do dia, migrar para micro-serviços é bem mais do que um simples mudança tecnológica</li><li>necessidade de manter o monolito operando ao mesmo tempo em que conduzimos os projetos de migração e implantação dos novos micro-serviços (sua empresa tem times e pessoas suficientes para isso?)</li><li>adoção de uma arquitetura distribuída (leitura complementar: <a href="https://cem-basaranoglu.medium.com/the-biggest-challenges-in-distributed-systems-27520a58258c">https://cem-basaranoglu.medium.com/the-biggest-challenges-in-distributed-systems-27520a58258c</a>)</li><li>cada micro-serviço poderá ser desenvolvido em tecnologias distintas (essa não é necessariamente uma recomendação, é apenas uma possibilidade) visando resolver da melhor maneira um problema em específico (imagine por exemplo que um dos seus micro-serviços trabalha com tecnologias como ML/AI e nele faz sentido usar Python, enquanto que outros fazem apenas a exposição de APIs com endpoints disponibilizando operações CRUD nos quais sua empresa prefere usar NodeJS ou Java+SpringBoot)</li><li>necessidade de coordenar múltiplos deployments separados, incluindo pipelines CI/CD variadas</li><li>mais complexidades para saber o que ocorre ao longo do fluxo de chamadas e integrações entre os seus micro-serviços (logging, monitoramento, observabilidade)</li><li>mais complexidade para testar e garantir que as integrações entre os micro-serviços estão funcionando como esperado , onde é necessário ir além de práticas como teste unitário e teste de integração, em cenários onde criar testes fim a fim (E2E -&gt; end to end) fica cada vez mais complicado dada a quantidade de micro-serviços que precisam estar implantados e rodando para se construir estes testes</li><li>replicações de esforço e código para implementar capacidades transversais e necessárias para todos os micro-serviços, incluindo questões como autenticação, autorização, resiliência</li><li>problemas com desempenho e latência para conta de comunicações entre processos (IPC) e chamadas remotas de procedimentos (RPC) que passaram a ser necessárias para garantir a integração entre os vários micro-serviços</li></ul><p>E estes são apenas alguns dos desafios que enfretaremos ao adotar uma arquitetura de micro-serviços. Inclusive é muito possível que em alguns cenários, permanecer na arquitetura monolítica seja uma opção melhor, ou pelo menos, pode acontecer de a empresa ter que fazer uma migração bastante lenta e gradual (especialmente se o monolito for muito grande ou muito complexo).</p><p>Apesar de todos estes desafios, imagine agora que sua empresa avançou muito nessa jornada, e que agora vocês já possuem dezenas ou centenas de micro-serviços em execução. É neste momento que mais um problema pode se apresentar: o problema da “arquitetura da estrela da morte” (leitura adicional recomendada: <a href="https://www.linkedin.com/pulse/mon%C3%B3litos-microsservi%C3%A7os-estrelas-da-morte-voc%C3%AA-n%C3%A3o-deveria-ferreira/?originalSubdomain=pt">https://www.linkedin.com/pulse/mon%C3%B3litos-microsservi%C3%A7os-estrelas-da-morte-voc%C3%AA-n%C3%A3o-deveria-ferreira/?originalSubdomain=pt</a>), um cenário no qual há muitos micro-serviços rodando . existe uma enorme quantidade de integrações bem como uma grande dependência (acoplamento?) entre eles.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/645/0*Nry-DQCY0IedAmQO" /><figcaption>Visualização das dependências e integrações entre micro-serviços em empresas como a Amazon e a Netflix, observe que a visualização resultante lembra visualmente a “Estrela da Morte” do “Star Wars”</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*GpM-5qjyhCbwQmPa.jpg" /><figcaption>A “Estrela da Morte” dos filmes“Star Wars”</figcaption></figure><p><strong>API Gateway</strong></p><p>API Gateway é um padrão arquitetural (<a href="https://microservices.io/patterns/apigateway.html">https://microservices.io/patterns/apigateway.html</a>) que define um ponto de entrada única para determinados grupos de clients ou grupos de micro-serviços. É semelhante ao padrão “Facade” (<a href="https://refactoring.guru/pt-br/design-patterns/facade">https://refactoring.guru/pt-br/design-patterns/facade</a>) da orientação a objetos, mas, neste caso, faz parte de um sistema distribuído.</p><p>Portanto, o gateway de API fica entre os aplicativos cliente e os micro-serviços. Ele atua como um proxy reverso, roteando solicitações de clientes para serviços. Ele também pode fornecer muitos outros recursos e políticas transversais, como :</p><ul><li>autenticação e autorização</li><li>SSL</li><li>cache</li><li>validação básica</li><li>balanceamento de carga</li><li>políticas de retry</li><li>log</li><li>monitoramento e alertas</li><li>service discovery</li><li>transformação de requests</li><li>transformação , composição e agregação de responses</li><li>tratamento de erros</li><li>rate limiting e throttling</li><li>restrições de acesso baseado em IPs de origem</li></ul><p>Alguns gateways implementam padrões como API Composition (<a href="https://learn.co/lessons/microservices-patterns-chapter-7">https://learn.co/lessons/microservices-patterns-chapter-7</a>) e podem realizar operações de transformação avançada no response body obtido dos backends-alvo (upstream) e agregar funções para viabilizar monetização (billing) das suas APIs.</p><p>Existe uma diferenciação entre os “micro gateways” (também chamados de “thin gateways” ou ainda como “lightweight gateway”) e os “full gateways”, baseada na quantidade de recursos disponíveis e na quantidade de responsabilidades que serão designadas para o seu API Gateway. O Kong se posiciona na categoria de “micro gateway” enquanto que outros produtos como o Apigee da Google, o WSO2 e o Sensedia (<a href="https://br.sensedia.com/">https://br.sensedia.com/</a>) estão na categoria de “full gateway” ou “end-to-end gateway”.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/806/0*7Xnb9v2Qnot5ObWl" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/850/0*Ul5gAz03esVNTqd0" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/691/1*dlDr4BZyxWmnP5-kZBnimg.png" /></figure><p><strong>Kong: Um poderoso API Gateway</strong></p><p>Ao aplicar o padrão API Gateway e utilizar o Kong como API Gateway, você poderá usar o Kong Gateway como entrypoint das suas APIs e poderá realizar a aplicação de políticas de gateway por meio de um conjunto de plugins do Kong. Para fazer isso você irá configurar objetos de <strong>service </strong>e <strong>routes</strong> e definir quais políticas (plugins) irá aplicar em cada um deles.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*09XYkaz4VZ7Zud19" /></figure><p>Ao configurar o acesso à sua API, você começará especificando um <strong>Service, </strong>ou seja, um serviço. No Kong Gateway, um serviço é uma entidade que representa uma API ou microsserviço upstream externo , por exemplo, um microsserviço de transformação de dados, uma API de cobrança e assim por diante. O principal atributo de um Serviço é sua URL, onde o serviço escuta as requisições. Você pode especificar a URL com uma única string ou especificando seu protocolo, host, porta e caminho individualmente.</p><p>Antes de começar a fazer solicitações ao Serviço, você precisará adicionar pelo menos um objeto <strong>Route</strong>, ou seja, uma rota, a ele. As rotas determinam como (e se) as solicitações são enviadas aos seus serviços depois de chegarem ao Kong Gateway. Um único serviço pode ter muitas Rotas.</p><p>Após configurar pelo menos um serviço e pelo menos uma rota, você já poderá começar a fazer solicitações através do Kong Gateway.</p><p>Este diagrama ilustra o fluxo de solicitações e respostas sendo roteadas por meio do serviço para a API de back-end.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*ZFGYvSlPtEWdDC4s.png" /></figure><p><strong>Arquitetura e características do Kong API Gateway</strong></p><p>O Kong é um API Gateway que foi construído “em cima” do NGINX (web server) e Open Resty (<a href="https://openresty.org/en/">https://openresty.org/en/</a>) e na implementação altamente performática do Lua chamada LuaJIT (<a href="https://luajit.org/">https://luajit.org/</a>).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*y4WNEQZGYvy4FDXf.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/623/1*DWPASrW53ZNRxqJQOJlwGA.png" /></figure><p>Sendo mais específico, o Kong Gateway está disponível em dois modos:</p><p><strong>Kong Gateway OSS ou Kong open-source:</strong> possui os recursos do núcleo do Kong API gateway e um conjunto de plugins de código aberto. Você pode gerenciar o Gateway open-source com a API de administração do Kong, com configuração declarativa ou com aplicativos open-source como o Konga (veja a lista de ferramentas adicionais mencionadas no final deste artigo).</p><p><strong>Kong Gateway (disponível nos acessos Free, Plus, ou Enterprise subscription):</strong> é o Kong API Gateway com o núcleo baseado no Kong OSS porém com diversas funcionalidades e ferramentas adicionais quando comparado ao Kong OSS e suporte adicional da Kong Inc.</p><p>No Plus, você tem acesso a mais recursos do Kong Gateway, através do Konnect Cloud. Consulte a documentação do Konnect Cloud e os plug-ins com o rótulo Plus no Kong Plugin Hub (<a href="https://docs.konghq.com/hub/">https://docs.konghq.com/hub/</a>) para obter mais informações.</p><p>Com uma “subscription” Kong Enterprise, você e seu time tem acesso a itens adicionais como:</p><ul><li>Suporte da Kong Inc</li><li>Acesso a treinamento oficial da Kong Inc</li><li>Kong Manager GUI</li><li>Developer Portal</li><li>Kong Vitals</li><li>Ferramentas adicionais de RBAC</li><li>Enterprise plugins, com funcionalidades superiores as disponíveis para os plugins do Kong open-source</li></ul><p>Você pode gerenciar seu Kong Gateway tanto usando a Kong Admin API, pode usar configuração declarativa e, nas versões pagas do Kong você pode usar o Kong Manager (na verdade você pode usar o Kong Manager também ao rodar o Kong localmente em Free Mode).</p><p>Você pode gerenciar seu Kong Gateway tanto usando a Kong Admin API, pode usar configuração declarativa e, nas versões pagas do Kong você pode usar o Kong Manager (na verdade você pode usar o Kong Manager também ao rodar o Kong Enterprise localmente em Free Mode).</p><p>Este pacote também está disponível como parte do Kong Konnect (<a href="https://konghq.com/kong-konnect">https://konghq.com/kong-konnect</a>).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*GZeJJRDZ-vNX9OF0.png" /><figcaption>Diagrama dos módulos do Kong Gateway e como eles se relacionam com os componentes básicos do Gateway.<br>As solicitações partem de um cliente de API para o Gateway, são modificadas e gerenciadas pelo proxy com base na configuração do Gateway e encaminhadas para serviços e backends upstream (target).</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*D9PmxB2xzwDSZZ9Dr-NgRw.png" /><figcaption>Serviços disponíveis para usuários do Kong Konnect</figcaption></figure><p>O Kong Gateway é um produto extensível a partir de uma arquitetura de plugins (normalmente criados em Lua mas podendo ser feitos em outras linguagens tais como Python , Go e JavaScript) que implementam políticas que podem ser aplicadas de maneira global (para todas as rotas expostas em uma instância específica do Kong) ou que podem estar ativas apenas em algumas rotas específicas.</p><p>O Kong é altamente performático e foi projetado para ser “cloud-native” e para uso em arquiteturas de microserviços possuindo modelos de deployment sofisticados incluindo declarative DBLESS (sem banco de dados), uso com Postgres como DB e deployment híbrido (com separação de control plane e data plane) sem vendor lock-in (<a href="https://konghq.com/blog/kong-api-gateway-eks-anywhere">https://konghq.com/blog/kong-api-gateway-eks-anywhere</a>), permitindo clusterização e alta disponibilidade.</p><p>Atualmente (Junho/2022) o Kong se encontra na versão 2.8.1 (stable), com versão 3.0 estando muito perto de ser lançada.</p><p><strong>Plugins customizados para o Kong</strong></p><p>Como dito anteriormente, o Kong é extensível e possui uma arquitetura aberta para plugins customizados, que são preferivelmente escritos na linguagem Lua pelo fato de o Kong ser baseado no NGINX e OpenResty, ambos escritos em Lua.</p><p>O Lua (<a href="https://www.lua.org/">https://www.lua.org/</a>) é uma linguagem de programação aberta e muito fácil de se aprender, e caso você ainda não saiba, foi originalmente desenvolvida por pesquisados brasileiros (<a href="https://www.tecmundo.com.br/software/239478-lua-linguagem-programacao-brasileira-deu-origem-roblox.htm">https://www.tecmundo.com.br/software/239478-lua-linguagem-programacao-brasileira-deu-origem-roblox.htm</a>) e é bastante usada por exemplo no segmento de desenvolvimento de games.</p><p>Indo além do Lua, o Kong possui PDKs (plugin development kits) para fazer plugins em outras linguagens como Go, JavaScript e Python. Porém o desempenho deles é inferior ao desempenho dos plugins em Lua, pelo deles precisarem rodar num processo separado do Kong e havendo uma comunicação entre processos (IPC) por meio de uma bridge. Você pode obter mais informações sobre isso aqui (<a href="https://docs.konghq.com/gateway/latest/reference/external-plugins/">https://docs.konghq.com/gateway/latest/reference/external-plugins/</a>).</p><ul><li>Projeto de ambiente pronto para desenvolvimento de plugins para o Kong contendo plugins de exemplo em Lua e JS: <a href="https://github.com/bovino/kong-template-with-docker">https://github.com/bovino/kong-template-with-docker</a></li><li>PDK para Kong plugins em JavaScript: <a href="https://github.com/Kong/kong-js-pdk">https://github.com/Kong/kong-js-pdk</a></li><li>PDK para Kong plugins em Go: <a href="https://github.com/Kong/go-pdk">https://github.com/Kong/go-pdk</a></li><li>PDK para Kong plugins em Python: <a href="https://github.com/Kong/kong-python-pdk">https://github.com/Kong/kong-python-pdk</a></li><li>Boas práticas para desenvolvimento de plugins em Lua para o Kong: <a href="https://konghq.com/blog/lua-custom-plugin-best-practices">https://konghq.com/blog/lua-custom-plugin-best-practices</a></li></ul><p><strong>Funcionalidades disponíveis no Kong Gateway</strong></p><p>O Kong Gateway possui um conjunto amplo de funcionalidades dentre as quais convém destacar:</p><ul><li>Uma API REST para administração do Kong (Admin API)</li><li>Suporte a múltiplos protocolos e tipos de APIs (http, https, REST, GraphQL, grpc, websocket)</li><li>Permite fazer transformação entre protocolos, como por exemplo receber uma requisição REST do cliente e converter isso internamente numa requisição para um serviço GRPC ou GraphQL</li><li>Roteamento dinâmico baseado em elementos da requisição</li><li>Caching (in-memory ou Redis)</li><li>Balanceamento de carga</li><li>Tratamento de erros</li><li>Políticas de retry para adicionar mais resiliência na comunicação com as suas APIs</li><li>Autenticação e autorização para APIs usando vários métodos como JWT, basic auth, hmac, OAuth, ACLs, OpenID Connect etc…</li><li>Proxy, SSL/TLS (mTLS) e suporte a conectividade para algum controle de tráfego L4 (transport layer) ou L7 (application layer) -&gt; <a href="https://docs.konghq.com/gateway/latest/reference/proxy/">https://docs.konghq.com/gateway/latest/reference/proxy/</a></li><li><strong>API Gateways tipicamente focam mais em L7 (application layer) do que em L4 (transport layer)</strong>, podendo operar em conjunto com service meshs para lidar melhor com L4. <br>Caso você queira saber mais sobre o OSI Model e as camadas deste modelo , ou caso não conheça service mesh e como ele pode complementar as capacidades do seu API Gateway, segue abaixo links cuja leitura eu recomendo:<br><a href="https://en.wikipedia.org/wiki/OSI_model">https://en.wikipedia.org/wiki/OSI_model</a><br><a href="https://www.networkcomputing.com/networking/well-defined-api-layer-8">https://www.networkcomputing.com/networking/well-defined-api-layer-8</a> <br><a href="https://www.networkcomputing.com/networking/api-gateway-networking-layer-8">https://www.networkcomputing.com/networking/api-gateway-networking-layer-8</a></li><li>Modelos de deployment sofisticados incluindo declarative DBLESS (sem banco de dados), uso com Postgres como DB e deployment híbrido (com separação de control plane e data plane) sem vendor lock-in (<a href="https://konghq.com/blog/kong-api-gateway-eks-anywhere">https://konghq.com/blog/kong-api-gateway-eks-anywhere</a>), permitindo <strong>clusterização e alta disponibilidade</strong></li><li>Suporte nativo a um ingress controller para uso em ambiente Kubernetes: <a href="https://github.com/Kong/kubernetes-ingress-controller">https://github.com/Kong/kubernetes-ingress-controller</a></li><li>Ferramental para apoiar seu time durante todo o <strong>ciclo de vida das suas APIs</strong></li></ul><p>Quando falamos em ciclo de vida de APIs, considere tudo que acontece com a sua API desde o design desta API até os processos para aposentar e substituir sua API em produção com o mínimo de impacto ou downtime para os diversos clientes que passaram a depender dela.</p><p><strong>Rodando o Kong localmente com Docker Compose</strong></p><p>Existem várias maneiras de rodar o Kong Gateway localmente para estudos e desenvolvimento de suas aplicações. Neste artigo veremos como rodar o Kong utilizando o Docker Compose. Sendo mais específico, iremos rodar um Kong no modelo DBLESS (ou seja, sem banco de dados), utilizando configuração declarativa (Kong Declarative Config) e expondo um serviço e algumas rotas para uma API externa de exemplo, no caso a API <a href="http://httpbin.org/anything">http://httpbin.org/anything</a>, que é um endpoint que tem como características devolver no response todos os elementos que recebeu na requisição.</p><p>O que você precisará para rodar o Kong localmente usando o Docker Compose é basicamente instalar na sua máquina uma versão da Docker Engine</p><p>Feito isso, basicamente iremos precisar criar 2 arquivos: o script YAML com a instruções do Docker Compose e um segundo arquivo YAML que é a configuração declarativa do Kong, onde registraremos quais serviços e rotas iremos expor em nosso Kong, bem como definiremos quais plugins e políticas o gateway irá aplicar em cada rota exposta.</p><p><strong>Script do Docker Compose:</strong> (<a href="https://github.com/bovino/kong-gateway-introducao/blob/main/docker-compose.yml%C2%B4">https://github.com/bovino/kong-gateway-introducao/blob/main/docker-compose.yml</a>)</p><pre>version: &quot;3.9&quot;<br><br>volumes:<br>  kong_data: {}<br><br>networks:<br>  kong-net:<br>    external: false<br><br>services:<br>  kong:<br>    image: &quot;kong:2.8.1-alpine&quot;<br>    volumes:<br>     - ./kong-declarative-config.yml:/tmp/kong-declarative-config.yml<br>    environment:<br>      KONG_DATABASE: &quot;off&quot;<br>      KONG_DECLARATIVE_CONFIG: /tmp/kong-declarative-config.yml<br>      KONG_PROXY_ACCESS_LOG: /dev/stdout<br>      KONG_ADMIN_ACCESS_LOG: /dev/stdout<br>      KONG_PROXY_ERROR_LOG: /dev/stderr<br>      KONG_ADMIN_ERROR_LOG: /dev/stderr<br>      KONG_ADMIN_LISTEN: 0.0.0.0:8001, 0.0.0.0:8444 ssl<br>      KONG_LOG_LEVEL: debug<br>      KONG_PLUGINS: bundled<br>    restart: on-failure<br>    networks:<br>      - kong-net<br>    ports:<br>      - 8000:8000<br>      - 8001:8001<br>      - 8444:8444<br>      - 8443:8443</pre><p>Kong Declarative Config: (<a href="https://github.com/bovino/kong-gateway-introducao/blob/main/kong-declarative-config.yml">https://github.com/bovino/kong-gateway-introducao/blob/main/kong-declarative-config.yml</a>)</p><pre>_format_version: &quot;2.1&quot;<br><br>services:<br>  - name: my-service<br>    url: http://httpbin.org/anything<br>    # plugins: plugin ativo para todas as rotas desse service<br>    #  - name: kong-plugin-myplugin<br>    routes:<br>      - name: get-post-data<br>        methods: [GET, POST]<br>        paths: [/v1/my-route]<br>        plugins:<br>          - name: rate-limiting<br>            config:<br>              second: 3<br>              minute: 5<br>              hour: 10<br>              policy: local<br>              # policy: local, cluster, redis<br>      - name: only-post-https-data<br>        methods: [POST]<br>        protocols: [https]<br>        paths: [/v2/my-route]<br>      - name: post-data-http<br>        methods: [POST]<br>        protocols: [http]<br>        paths: [/v3/my-route]<br>        plugins:<br>          - name: request-size-limiting<br>            config:<br>              allowed_payload_size: 8<br>              size_unit: bytes<br>              require_content_length: false</pre><p>Após criar estes dois arquivos numa pasta, garanta que a sua máquina esteja com as portas 8000, 8001, 8444 e 8443 disponíveis e rode o seguinte comando no seu terminal:</p><p><strong>docker-compose up</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dvBN7xsd0kb45JvEDfkUPQ.png" /><figcaption>Tela apresentada no seu CLI quando o Kong estiver rodando</figcaption></figure><p>Depois que o servidor terminar de subir você poderá invocar a Admin API do Kong e também as três rotas expostas e ver as configurações e plugins do Kong sendo aplicados. Faça alguns experimentos conforme descrito abaixo:</p><p><strong>Requisição na Admin API do Kong para listar os services configurados</strong></p><pre>curl --request GET --url http://localhost:8001/services</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-PE_CTPjQ8FvQzILjjt38g.png" /></figure><p><strong>Requisição na Admin API do Kong para listar as rotas disponíveis dentro do service criado</strong></p><pre>curl --request GET --url http://localhost:8001/services/my-service/routes</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*D8S0TmoTtmmliESHsZ5FjQ.png" /></figure><p><strong>Rota 1:</strong> chame via GET a URL da rota “v1/my-route” várias vezes seguidas até ver o plugin de Rate Limiting do Kong limitar o acesso ao endpoint, com mensagem de erro específica e status code 429 (Too Many Requests)</p><pre>curl --request GET --url http://localhost:8000/v1/my-route</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uShJFe35gEcf-mX1WI8-JA.png" /><figcaption>Rota invocada várias vezes seguida cai na política de rate limiting aplicada via plugin do Kong</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JCq9OPncpQ0B8aNA0TNPzA.png" /><figcaption>Requisição chegando sucesso ao upstream target</figcaption></figure><p><strong>Rota 2:</strong> chame via POST a URL da rota “/v2/my-route” usando HTTP ao invés de HTTPS e verá que o Kong impede o acesso a rota, com mensagem de erro específica e com status code 426 (Upgrade required)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qT6g4IsVeiUAbZqnqy6fWQ.png" /><figcaption>Rota invocada por protocolo HTTP ao invés de HTTPS violando restrição definida pelo Kong na declaração da rota</figcaption></figure><p><strong>Rota 3:</strong> envie uma chamada POST para “/v3/my-route” enviando payload que excede o tamanho máximo definido via plugin “request size limiting”</p><p>Chamada que não excede tamanho máximo do payload:</p><pre>curl --request POST --url http://localhost:8000/v3/my-route \<br>  --header &#39;Content-Type: application/json&#39; \<br>  --data &#39;{&quot;id&quot;:1}&#39;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*pWINbw2Xo_3YcaXfOG-oAg.png" /></figure><p>Chamada que excede o tamanho máximo e dá erro com mensagem específica e status 413 (Request Entity Too Large)</p><pre>curl --request POST --url http://localhost:8000/v3/my-route \<br>  --header &#39;Content-Type: application/json&#39; \<br>  --data &#39;{ &quot;id&quot;:1 , &quot;nome&quot;: &quot;Marcelo Bezerra === bovino&quot; }&#39;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*oeZ5qC5uTN51plN9v3LCwg.png" /></figure><p>Para facilitar a sua vida, disponibilizei um repositório no GitHub (<a href="https://github.com/bovino/kong-gateway-introducao">https://github.com/bovino/kong-gateway-introducao</a>) com os exemplos acima já prontos e disponíveis para uso.</p><p><strong>Algumas ferramentas adicionais para uso em conjunto com o Kong Gateway:</strong></p><p>Se você estiver usando o Kong OSS, provavelmente irá querer utilizar algumas ferramentas complementares, para te ajudar em tarefas de administração, automação e visualização de serviços, rotas e configurações aplicadas no seu ambiente Kong. Para quem estiver usando o Kong Enterprise, estas ferramentas e várias outras já estarão incluídas no pacote.</p><p><strong>Insomnia:</strong> é uma ferramenta disponibilizada pela própria Kong (<a href="https://insomnia.rest/download">https://insomnia.rest/download</a>) e possui recursos para construção, design, e testes de APIs permitindo o uso de “spec-first development” bem como a integração da ferramenta com pipelines de CI/CD e implantação de modelos de trabalho APIOps (<a href="https://konghq.com/blog/what-is-apiops">https://konghq.com/blog/what-is-apiops</a>).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*qq6lu3nb3ncQhtTq.png" /></figure><p><strong>OpenAPI2Kong:</strong> é uma lib em JavaScript que faz parte do Insomnia e está disponível como package no NPM (<a href="https://www.npmjs.com/package/openapi-2-kong">https://www.npmjs.com/package/openapi-2-kong</a>) que pode ser usada para construir ferramentas e pipelines de automação visando realizar configuração automatizada a partir de specs OpenAPI.</p><p><strong>KongMap: </strong>O KongMap é uma ferramenta muito útil para visualizar serviços, rotas e configurações que estão aplicadas num determinado cluster de Kong, podendo ser usado para navegar por vários clusters.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*twp8OX3oo_lPBF1J" /></figure><p><strong>Konga:</strong> o Konga é uma interface web (GUI) que se conecta com a AdminAPI do Kong e permite gerenciar diversas operações de administração . O Konga é opensource e pode ser encontrado no GitHub (<a href="https://github.com/pantsel/konga">https://github.com/pantsel/konga</a>).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*1HfdNK7cm2Vk5E7l.png" /></figure><p><strong>Backstage:</strong> O Backstage é uma ferramenta muito útil para catalogação de software, que é especialmente útil numa arquitetura de micro-serviços. È uma ferramenta poderosa e que pode ser usada para construir developer portals. É opensource (<a href="https://github.com/backstage/backstage">https://github.com/backstage/backstage</a>), é usada por grandes empresas e possui uma arquitetura extensível com excelente documentação.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*yP4UaX8Pqagj0FRW" /></figure><p><strong>Pact + Pact Broker para testes de contrato:</strong> para garantir que a comunicação entre seus micro-serviços funciona como esperado, é possível estabelecer contratos entre as suas APIs, publicar estes contratos num repósitório e fazer com que suas APIs testem se o contrato está sendo respeitado, tanto do lado do consumer quanto do lado do provider desta API.</p><p>O Pact (<a href="https://docs.pact.io/">https://docs.pact.io/</a>)e o Pact Broker (<a href="https://github.com/pact-foundation/pact_broker">https://github.com/pact-foundation/pact_broker</a>) são ferramentas open-source que poderão ser utilizadas para atingir este objetivo.</p><p>Futuramente disponibilizarei artigos focados na criação de testes de contrato. Existem outras ferramentas disponíveis para testes de contrato tais como o Spring Cloud Contract, que podem trabalhar com o Pact Broker (<a href="https://cloud.spring.io/spring-cloud-contract/reference/html/howto.html#how-to-use-pact-broker">https://cloud.spring.io/spring-cloud-contract/reference/html/howto.html#how-to-use-pact-broker</a>).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*vzr_bwQHvX3KLko2.png" /><figcaption>Tela inicial do Pact Broker listando os contratos publicados e disponíveis para testes de verificação</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/982/0*1MMBnnWJoTxlu0Lo.png" /><figcaption>Representação mostrando cosumer e provider da API interagindo com contratos Pact para assegurar conformidade e compatibilidade na integração por APIs versionadas numa arquitetura de micro-serviços</figcaption></figure><p><strong>Conclusão</strong></p><p>API Gateway são poderosas ferramentas poderosas para estruturar e trabalhar de maneira organizada, segura e escalável com as suas APIs e o Kong é uma excelente opção em termos de desempenho, recursos e extensibilidade.</p><p>Tem interesse em conversar mais sobre API Gateways? Quais desafios sua empresa têm superado usando o Kong Gateway? Se quiser conversar mais sobre isso você me procurar no Linkedin (<a href="https://www.linkedin.com/in/bovino/">https://www.linkedin.com/in/bovino/</a>) ou interagir com o pessoal da comunidade Kong São Paulo (<a href="https://www.meetup.com/pt-BR/kong-sao-paulo/">https://www.meetup.com/pt-BR/kong-sao-paulo/</a>).</p><p>Obrigado e até o próximo artigo!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8ff25a38e862" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>