Portales de Desarrollador
Plataformas centralizadas que proporcionan a los desarrolladores documentación, APIs, herramientas y catálogos de servicios en un solo lugar.
¿Qué es?
Un portal de desarrollador es una plataforma centralizada donde los desarrolladores encuentran todo lo que necesitan: catálogo de servicios, documentación de APIs, templates de proyectos, dashboards de salud y herramientas de self-service.
Componentes
| Componente | Función | Ejemplo |
|---|---|---|
| Catálogo de servicios | Inventario de microservicios, owners, dependencias | Backstage Software Catalog |
| Documentación | Docs técnicas centralizadas y buscables | TechDocs, Docusaurus |
| Templates | Scaffolding con mejores prácticas | Golden paths |
| Plugins | Integraciones con CI/CD, cloud, observabilidad | Kubernetes, Grafana, PagerDuty |
| Scorecards | Evaluación de madurez de servicios | Cortex, OpsLevel |
Backstage
Backstage (Spotify, CNCF) es la plataforma open-source más popular para developer portals. Extensible mediante plugins.
Beneficios
- Reducir tiempo buscando información
- Visibilidad del ecosistema de servicios
- Self-service para tareas comunes
- Onboarding acelerado
¿Cuándo no construir uno?
- Equipos pequeños (menos de 20 desarrolladores) — el overhead de mantener el portal no se justifica
- Si no hay equipo de plataforma dedicado — un portal sin mantenimiento se convierte en otro sistema abandonado
- Cuando un buen README y un wiki resuelven el problema
¿Por qué importa?
Un portal de desarrolladores centraliza el acceso a servicios, documentación, APIs y herramientas internas. Sin él, los desarrolladores pierden tiempo buscando información dispersa en wikis, Slack y repositorios. Es la capa de descubrimiento que hace escalable la plataforma interna.
Referencias
- Backstage — Plataforma open-source de Spotify para developer portals.
- Port — Alternativa comercial con enfoque en self-service.
- Adopting Backstage — Backstage, 2024. Guía de adopción del portal de desarrolladores más popular.