Os leitores de minhas publicações provavelmente estão familiarizados com a ideia de empregar uma abordagem API First para desenvolver microsserviços. Inúmeras vezes, percebi os benefícios de descrever os URIs previstos e os modelos de objetos subjacentes antes do início de qualquer desenvolvimento.  Em meus mais de 30 anos navegando na tecnologia, porém, passei a esperar a realidade dos   . Em outras palavras, espero que haja situações em que o API First simplesmente não seja possível. fluxos alternativos  Para este artigo, gostaria de apresentar um exemplo de como as equipes que produzem microsserviços ainda podem ter sucesso no fornecimento de uma especificação OpenAPI para outros consumirem sem definir manualmente um arquivo openapi.json.  Eu também queria sair da minha zona de conforto e fazer isso sem usar Java, .NET ou mesmo JavaScript.  Descobrindo FastAPI  Na conclusão da maioria dos meus artigos, menciono frequentemente a minha declaração de missão pessoal:  “Concentre seu tempo em fornecer recursos/funcionalidades que ampliem o valor de sua propriedade intelectual. Aproveite estruturas, produtos e serviços para todo o resto.” – J. Vester  Meu objetivo nesta declaração de missão é responsabilizar-me por fazer o melhor uso do meu tempo ao tentar alcançar metas e objetivos definidos em um nível superior. Basicamente, se nosso foco é vender mais widgets, meu tempo deveria ser gasto procurando maneiras de tornar isso possível – evitando desafios que já foram resolvidos por estruturas, produtos ou serviços existentes.  Escolhi Python como linguagem de programação para meu novo microsserviço. Até o momento, 99% do código Python que escrevi em meus artigos anteriores foi o resultado de respostas orientadas por   (SODD) ou ChatGPT. Claramente, Python está fora da minha zona de conforto. Stack Overflow Driven Development  Agora que defini o nível das coisas, queria criar um novo microsserviço RESTful baseado em Python que seguisse minha declaração de missão pessoal com experiência mínima na linguagem de origem.  Foi quando encontrei   . FastAPI  FastAPI existe desde 2018 e é uma estrutura focada no fornecimento de APIs RESTful usando dicas do tipo Python. A melhor parte do FastAPI é a capacidade de gerar automaticamente especificações OpenAPI 3 sem nenhum esforço adicional da perspectiva do desenvolvedor.  O caso de uso da API do artigo  Para este artigo, surgiu a ideia de uma API de artigo, fornecendo uma API RESTful que permite aos consumidores recuperar uma lista de meus artigos publicados recentemente.  Para simplificar, vamos supor que um determinado   contenha as seguintes propriedades: Article    – propriedade de identificador simples e exclusivo (número) id    – o título do artigo (string) title    – o URL completo do artigo (string) url    – o ano em que o artigo foi publicado (número) year  A API do artigo incluirá os seguintes URIs:  GET   – irá recuperar uma lista de artigos /articles  GET   – recuperará um único artigo pela propriedade id /articles/{article_id}  POST   – adiciona um novo artigo /articles  FastAPI em ação  No meu terminal, criei um novo projeto Python chamado fast-api-demo e executei os seguintes comandos:   $ pip install --upgrade pip $ pip install fastapi $ pip install uvicorn  Criei um novo arquivo Python chamado   e adicionei algumas importações, além de estabelecer uma variável   : api.py app   from fastapi import FastAPI, HTTPException from pydantic import BaseModel app = FastAPI() if __name__ == "__main__": import uvicorn uvicorn.run(app, host="localhost", port=8000)  A seguir, defini um objeto   para corresponder ao caso de uso da API Article: Article   class Article(BaseModel): id: int title: str url: str year: int  Com o modelo estabelecido, precisei adicionar as URIs… o que acabou sendo bem fácil:   # Route to add a new article @app.post("/articles") def create_article(article: Article): articles.append(article) return article # Route to get all articles @app.get("/articles") def get_articles(): return articles # Route to get a specific article by ID @app.get("/articles/{article_id}") def get_article(article_id: int): for article in articles: if article.id == article_id: return article raise HTTPException(status_code=404, detail="Article not found")  Para evitar envolver um armazenamento de dados externo, decidi adicionar alguns dos meus artigos publicados recentemente de forma programática:   articles = [ Article(id=1, title="Distributed Cloud Architecture for Resilient Systems: Rethink Your Approach To Resilient Cloud Services", url="https://dzone.com/articles/distributed-cloud-architecture-for-resilient-syste", year=2023), Article(id=2, title="Using Unblocked to Fix a Service That Nobody Owns", url="https://dzone.com/articles/using-unblocked-to-fix-a-service-that-nobody-owns", year=2023), Article(id=3, title="Exploring the Horizon of Microservices With KubeMQ's New Control Center", url="https://dzone.com/articles/exploring-the-horizon-of-microservices-with-kubemq", year=2024), Article(id=4, title="Build a Digital Collectibles Portal Using Flow and Cadence (Part 1)", url="https://dzone.com/articles/build-a-digital-collectibles-portal-using-flow-and-1", year=2024), Article(id=5, title="Build a Flow Collectibles Portal Using Cadence (Part 2)", url="https://dzone.com/articles/build-a-flow-collectibles-portal-using-cadence-par-1", year=2024), Article(id=6, title="Eliminate Human-Based Actions With Automated Deployments: Improving Commit-to-Deploy Ratios Along the Way", url="https://dzone.com/articles/eliminate-human-based-actions-with-automated-deplo", year=2024), Article(id=7, title="Vector Tutorial: Conducting Similarity Search in Enterprise Data", url="https://dzone.com/articles/using-pgvector-to-locate-similarities-in-enterpris", year=2024), Article(id=8, title="DevSecOps: It's Time To Pay for Your Demand, Not Ingestion", url="https://dzone.com/articles/devsecops-its-time-to-pay-for-your-demand", year=2024), ]  Acredite ou não, isso conclui o desenvolvimento do microsserviço Article API.  Para uma verificação rápida de integridade, ativei meu serviço de API localmente:   $ python api.py INFO: Started server process [320774] INFO: Waiting for application startup. INFO: Application startup complete. INFO: Uvicorn running on http://localhost:8000 (Press CTRL+C to quit)  Então, em outra janela do terminal, enviei uma solicitação curl (e canalizei para   ): json_pp   $ curl localhost:8000/articles/1 | json_pp { "id": 1, "title": "Distributed Cloud Architecture for Resilient Systems: Rethink Your Approach To Resilient Cloud Services", "url": "https://dzone.com/articles/distributed-cloud-architecture-for-resilient-syste", "year": 2023 }  Preparando para implantar  Em vez de apenas executar a API do artigo localmente, pensei em ver como seria fácil implantar o microsserviço. Como nunca havia implantado um microsserviço Python no   antes, achei que agora seria um ótimo momento para tentar. Heroku  Antes de mergulhar no Heroku, precisei criar um arquivo   para descrever as dependências do serviço. Para fazer isso, instalei e executei   : requirements.txt pipreqs   $ pip install pipreqs $ pipreqs  Isso criou um arquivo   para mim, com as seguintes informações: requirements.txt   fastapi==0.110.1 pydantic==2.6.4 uvicorn==0.29.0  Eu também precisava de um arquivo chamado   que informa ao Heroku como ativar meu microsserviço com   . Seu conteúdo ficou assim: Procfile uvicorn   web: uvicorn api:app --host=0.0.0.0 --port=${PORT}  Vamos implantar no Heroku  Para aqueles que são novos em Python (como eu), usei a documentação   como um guia útil. Introdução ao Heroku com Python  Como já tinha o Heroku CLI instalado, só precisei fazer login no ecossistema Heroku a partir do meu terminal:   $ heroku login  Fiz questão de verificar todas as minhas atualizações em meu repositório no GitLab.  A seguir, a criação de um novo aplicativo no Heroku pode ser realizada usando a CLI por meio do seguinte comando:   $ heroku create  A CLI respondeu com um nome de aplicativo exclusivo, juntamente com a URL do aplicativo e o repositório baseado em git associado ao aplicativo:   Creating app... done, powerful-bayou-23686 https://powerful-bayou-23686-2d5be7cf118b.herokuapp.com/ | https://git.heroku.com/powerful-bayou-23686.git   Observe: no momento em que você ler este artigo, meu aplicativo não estará mais online.  Veja isso. Quando emito um comando git remote, posso ver que um controle remoto foi adicionado automaticamente ao ecossistema Heroku:   $ git remote heroku origin  Para implantar o aplicativo   no Heroku, tudo o que preciso fazer é usar o seguinte comando: fast-api-demo   $ git push heroku main  Com tudo definido, consegui validar que meu novo serviço baseado em Python está instalado e funcionando no painel do Heroku:  Com o serviço em execução, é possível recuperar o   com   da API do Artigo emitindo o seguinte comando curl: Article id = 1   $ curl --location 'https://powerful-bayou-23686-2d5be7cf118b.herokuapp.com/articles/1'  O comando curl retorna uma resposta   e a seguinte carga JSON: 200 OK   { "id": 1, "title": "Distributed Cloud Architecture for Resilient Systems: Rethink Your Approach To Resilient Cloud Services", "url": "https://dzone.com/articles/distributed-cloud-architecture-for-resilient-syste", "year": 2023 }  Entregando especificações OpenAPI 3 automaticamente  Aproveitar a funcionalidade OpenAPI integrada do FastAPI permite que os consumidores recebam uma especificação v3 totalmente funcional navegando até o URI   gerado automaticamente: /docs   https://powerful-bayou-23686-2d5be7cf118b.herokuapp.com/docs  Chamar esse URL retorna o microsserviço da API Article usando a UI Swagger amplamente adotada:  Para quem procura um arquivo   para gerar clientes para consumir a API do artigo, o URI   pode ser usado: openapi.json /openapi.json   https://powerful-bayou-23686-2d5be7cf118b.herokuapp.com/openapi.json  Para meu exemplo, a especificação OpenAPI v3 baseada em JSON aparece conforme mostrado abaixo:   { "openapi": "3.1.0", "info": { "title": "FastAPI", "version": "0.1.0" }, "paths": { "/articles": { "get": { "summary": "Get Articles", "operationId": "get_articles_articles_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { } } } } } }, "post": { "summary": "Create Article", "operationId": "create_article_articles_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Article" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/articles/{article_id}": { "get": { "summary": "Get Article", "operationId": "get_article_articles__article_id__get", "parameters": [ { "name": "article_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Article Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } } }, "components": { "schemas": { "Article": { "properties": { "id": { "type": "integer", "title": "Id" }, "title": { "type": "string", "title": "Title" }, "url": { "type": "string", "title": "Url" }, "year": { "type": "integer", "title": "Year" } }, "type": "object", "required": [ "id", "title", "url", "year" ], "title": "Article" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" } } } }  Como resultado, a especificação a seguir pode ser usada para gerar clientes em diversas linguagens diferentes por meio   . do OpenAPI Generator  Conclusão  No início deste artigo, eu estava pronto para lutar e enfrentar qualquer pessoa que não estivesse interessada em usar uma abordagem API First. O que aprendi com este exercício é que um produto como FastAPI pode ajudar a definir e produzir um microsserviço RESTful funcional rapidamente, ao mesmo tempo que inclui uma especificação OpenAPI v3 totalmente consumível… automaticamente.  Acontece que o FastAPI permite que as equipes permaneçam focadas em suas metas e objetivos, aproveitando uma estrutura que produz um contrato padronizado no qual outros podem confiar. Como resultado, surgiu outro caminho para aderir à minha declaração de missão pessoal.  Ao longo do caminho, usei o Heroku pela primeira vez para implantar um serviço baseado em Python. Isso acabou exigindo pouco esforço de minha parte, além de revisar alguma documentação bem escrita. Portanto, outro bônus de declaração de missão também precisa ser mencionado para a plataforma Heroku.  Se você estiver interessado no código-fonte deste artigo, poderá encontrá-lo no   . GitLab  Tenha um ótimo dia!

2022 - HackerNoon Contributor of the Year - Cloud Computing

2022 - HackerNoon Contributor of the Year - Design

2022 - HackerNoon Contributor of the Year - Heroku

2022 - HackerNoon Contributor of the Year - Javascript

2022 - HackerNoon Contributor of the Year - Salesforce

2022 - Hackernoons Tech Storyteller of the Year

I ♥ writing code. Find me on GitLab.

Nominated for 2022 - HackerNoon Contributor of the Year - Javascript

Nominated for 2022 - Hackernoons Tech Storyteller of the Year

Nominated for 2022 - HackerNoon Contributor of the Year - Cloud Computing

Nominated for 2022 - HackerNoon Contributor of the Year - Heroku

Nominated for 2022 - HackerNoon Contributor of the Year - Design

Nominated for 2022 - HackerNoon Contributor of the Year - Salesforce

Este áudio é produzido no idioma original da história!

Muito longo; Para ler

Make resilience your competitive advantage

FastAPI me deu uma especificação OpenAPI muito... rápida

FastAPI me deu uma especificação OpenAPI muito... rápida

About Author

COMENTARIOS

Rótulos

ESTE ARTIGO FOI APRESENTADO EM

Related Stories

O guia completo para uma migração bem-sucedida para a nuvem: estratégias e práticas recomendadas

Criando produtos criptográficos centrados no usuário: a importância do feedback do cliente

Liberando o poder da IA. Uma revisão sistemática de técnicas de ponta: resumo e introdução

Telegram: a ponte da Crypto Island para o continente

O guia completo para uma migração bem-sucedida para a nuvem: estratégias e práticas recomendadas

Criando produtos criptográficos centrados no usuário: a importância do feedback do cliente

Liberando o poder da IA. Uma revisão sistemática de técnicas de ponta: resumo e introdução

Telegram: a ponte da Crypto Island para o continente

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps