Em nossa solução de gestão e gateway de APIs e integrações: Nasph, nós utilizamos duas formas de expor os Develeper Portals (Portal de Desenvolvedores):
Docussaurus - Este é um projeto mantido pelo Facebook. Para documentações mais técnicas, onde a responsabilidade de documentação de APIs fica a cargo do time de desenvolvimento/criação das APIs. Como exemplo de DevPortal temos este aqui:
Drupal - Para Developer Portals que geralmente existem times que produzem a documentação, geralmente equipes de marketing, ou conteúdo, que contém uma prática de API Product Managers etc. Veja o exemplo abaixo:
Ambas soluções são opensource, e facilmente integráveis ao Nasph. Porém, percebemos que poderíamos ir um pouco além, e nosso time de Engenharia chegou ao Backstage.
Backstage como visão de DevExp
Nós tentamos o Backstage a primeira vez em abril de 2020, se demonstrou um projeto muito promissor, tendo em vista que a empresa por trás do mesmo é a Spotify. O que antes era promessa, para nós, acabou chegando como uma grande realidade, e abraçando até mais casos de uso do que simplesmente catálogos de APIs, pois o backstage permite ter uma visão completa de todo o ciclo de desenvolvimento, permitindo práticas importantes como Agilidade e Governança de Ativos.
x
Nós observamos que podemos governar muito mais que APIs, mas também serviços, fazer com que os times (squads) sigam os mesmos templates de desenvolvimento, os mesmos padrões, trazendo inúmeras facilidades para deployment (Cloud-Native).
Com o Backtage percebemos que podemos ajudar primeiramente nós mesmos dentro do grupo Squadra, a conhecer nossos ativos em termos de software, uma vez que somos mais de 650 pessoas onde grande parte destas entrega códigos todos os dias. E claro, ajudarmos nossos clientes a sairem de uma fase artesanal de criação de software, e realmente passar para um modelo mais ágil e pragmático.
Gostou do Backstage? Aqui a demonstração oficial da plataforma: Backstage Catalog | Backstage Demo, se você quiser ver uma instância com mais plugins e já customizada, por favor, entre em contato com a gente .
Fique atento as novidades que iremos lançar muito em breve.
Comments