Portada de Backstage e Internal Developer Platforms: De Cero a Experto Libro técnico · Backstage · IDP

Backstage e Internal Developer Platforms

De Cero a Experto · Construye, opera y evangeliza una IDP soberana sobre Backstage, con la profundidad de un manual y la accesibilidad de un artículo largo.

📖 16 capítulos + 10 apéndices 🍳 Tono culinario 🎯 4 itinerarios (junior, jefe, consultor, CTO) v1.0 · Julio 2026
Empezar a leer →

Índice del libro

Parte I: Parte 1 — Fundamentos: por qué una IDP y por qué Backstage

  1. 01Por qué necesitamos una IDP (y por qué Backstage)
  2. 02El problema: la jungla de microservicios
  3. 03Qué es (y qué no es) una IDP
  4. 04Platform thinking: el equipo que cocina para otros equipos
  5. 05Historia de Backstage: de Spotify a CNCF
  6. 06Cuándo NO merece la pena montar una IDP
  7. 07Mapa del libro: 4 itinerarios para 4 lectores
  8. 08Resumen
  9. 09Glosario del capítulo
  10. 10Próximo capítulo
  11. 11Anatomía de Backstage: dos mitades y un plugin
  12. 12Las dos mitades: el portal y la cocina
  13. 13Frontend: React + Material UI
  14. 14Backend: Node, Express, Knex
  15. 15El CLI @backstage/cli
  16. 16New Backend System vs legacy
  17. 17El modelo de plugins: tres categorías
  18. 18Cómo se monta todo: flujo de arranque
  19. 19Resumen
  20. 20Glosario del capítulo
  21. 21Próximo capítulo
  22. 22Mise-en-place: tu primera IDP local
  23. 23Antes de empezar: mise-en-place
  24. 24Bootstrap: el asistente de cocina
  25. 25El monorepo: estructura
  26. 26Arrancar la cocina
  27. 27La primera entidad del catalog
  28. 28¿Por qué usamos el catálogo desde el primer momento?
  29. 29Resumen
  30. 30Glosario del capítulo
  31. 31Próximo capítulo
  32. 32Catalog en serio: kinds, relaciones y providers
  33. 33De una entidad a un catálogo
  34. 34Los cinco componentes semilla
  35. 35La entidad System
  36. 36Relaciones: cómo se habla el catálogo
  37. 37Providers: discovery automático desde GitHub
  38. 38Importar proyectos existentes en bloque
  39. 39Resumen
  40. 40Glosario del capítulo
  41. 41Próximo capítulo

Parte II: Parte 2 — Backend: la cocina por dentro

  1. 42New Backend System: la cocina real
  2. 43Más allá del index.ts legacy
  3. 44createBackend y backend features
  4. 45Servicios core
  5. 46Configuración por capas
  6. 47Backend features: plugins vs módulos
  7. 48Migración desde legacy
  8. 49Resumen
  9. 50Glosario del capítulo
  10. 51Próximo capítulo
  11. 52Escribe tu primer plugin backend
  12. 53El primer plugin: sazon-status
  13. 54Anatomía de un plugin backend
  14. 55El router con Zod
  15. 56Middleware de autenticación
  16. 57Tests con supertest
  17. 58Registrar el plugin en el backend
  18. 59Resumen
  19. 60Glosario del capítulo
  20. 61Próximo capítulo
  21. 62Persistencia, eventos y auth flow en el backend
  22. 63Tres bases de datos, tres capas
  23. 64Migraciones con Knex
  24. 65plugin-database: el servicio de DB
  25. 66Eventos: el bus interno
  26. 67Auth flow: proteger endpoints
  27. 68Resumen
  28. 69Glosario del capítulo
  29. 70Próximo capítulo

Parte III: Parte 3 — Frontend: la sala y la carta

  1. 71Tu primer plugin frontend
  2. 72El frontend, esa otra mitad
  3. 73createPlugin y RouteRef
  4. 74FlatRoutes: el router del shell
  5. 75El componente de página
  6. 76Integrar el plugin en el shell
  7. 77Resumen
  8. 78Glosario del capítulo
  9. 79Próximo capítulo
  10. 80Frontend: datos, APIs y APIs de Backstage
  11. 81ApisRegistry: el bus del frontend
  12. 82Consumir el catalog con useApi
  13. 83Consumir tu propio backend
  14. 84Manejo de errores
  15. 85Resumen
  16. 86Glosario del capítulo
  17. 87Próximo capítulo
  18. 88Componentes, tablas y UX consistente
  19. 89Sistema de diseño: una sola carta
  20. 90Componentes de core-components
  21. 91Un InfoCard con un StatusBadge
  22. 92Composición: de un widget a una página
  23. 93Resumen
  24. 94Glosario del capítulo
  25. 95Próximo capítulo
  26. 96Theming, branding y la carta del menú
  27. 97La carta del menú
  28. 98El archivo themes.json
  29. 99Página principal del portal
  30. 100Dark mode
  31. 101Logo y favicon
  32. 102Resumen
  33. 103Glosario del capítulo
  34. 104Próximo capítulo

Parte IV: Parte 4 — Scaffolder y Auth: el libro de recetas y la puerta

  1. 105Scaffolder: el libro de recetas
  2. 106Scaffolder, el libro de recetas de la IDP
  3. 107Anatomía de un template
  4. 108Actions built-in
  5. 109El template completo
  6. 110Cargar el template en Backstage
  7. 111El esqueleto: skeleton/
  8. 112Resumen
  9. 113Glosario del capítulo
  10. 114Próximo capítulo
  11. 115Forms, dry-run y un template serio
  12. 116Forms que se adaptan al developer
  13. 117Conditional fields con dependencias
  14. 118Custom widgets: EntityNamePicker, OwnerPicker
  15. 119Dry-run: ensayar antes de publicar
  16. 120Un template serio: servicio con DB opcional
  17. 121Resumen
  18. 122Glosario del capítulo
  19. 123Próximo capítulo
  20. 124Auth: GitHub OAuth, Keycloak/OIDC y RBAC
  21. 125Identidad: quién entra al restaurante
  22. 126Flujo OAuth/OIDC
  23. 127GitHub OAuth (desarrollo)
  24. 128Keycloak/OIDC (laboratorio y producción)
  25. 129Sign-in resolvers
  26. 130RBAC con permission-backend
  27. 131Cómo se aplica en el cliente
  28. 132Resumen
  29. 133Glosario del capítulo
  30. 134Próximo capítulo
  31. 135El ecosistema de plugins: la carta del restaurante
  32. 136El menú ya no es solo el Software Catalog
  33. 137Anatomía de un plugin
  34. 138El catálogo oficial de plugins
  35. 139Plugin-paths: cómo descubre Backstage plugins externos
  36. 140Dynamic plugins (Backstage 1.30+)
  37. 141El "metadata" de un plugin publicable
  38. 142Escribir un plugin que el equipo vecino pueda instalar
  39. 143Errores comunes
  40. 144Cuándo construir un plugin vs cuándo comprar SaaS
  41. 145Resumen
  42. 146Glosario del capítulo
  43. 147Próximo capítulo
  44. 148Seguridad: cuando el portal tiene las llaves de la cocina
  45. 149La pregunta incómoda
  46. 150El threat model oficial de Backstage
  47. 151Los CVEs que ya han afectado a Backstage
  48. 152Hardening por superficie
  49. 153Manejo de secretos en Scaffolder
  50. 154Auditoría: quién hizo qué
  51. 155Lista de verificación de seguridad pre-producción
  52. 156Resumen
  53. 157Glosario del capítulo
  54. 158Próximo capítulo
  55. 159Permisos: la matriz que decide quién cocina qué
  56. 160Por qué un "allow all" no es buena idea
  57. 161Conceptos fundamentales
  58. 162El flujo de una decisión
  59. 163Tu primera policy: solo owners pueden editar
  60. 164Frontend: ocultando lo que el usuario no puede hacer
  61. 165Conditional decisions: el patrón elegante
  62. 166Integración con Open Policy Agent (OPA)
  63. 167RBAC legacy → Permission Framework: migración incremental
  64. 168Los 5 errores más comunes
  65. 169Auditar decisiones de permiso
  66. 170Resumen
  67. 171Glosario del capítulo
  68. 172Próximo capítulo
  69. 173Software Templates avanzados: el golden path completo
  70. 174El golden path: cuando el template hace TODO
  71. 175Anatomía de un template complejo
  72. 176Custom fields avanzados
  73. 177Conditional execution: if
  74. 178Manejo de secretos en templates: las 3 reglas
  75. 179Dry-run: simular antes de ejecutar
  76. 180Auditar la adopción de templates
  77. 181Marketplace interno de templates
  78. 182Testear templates con CI
  79. 183Resumen
  80. 184Glosario del capítulo
  81. 185Próximo capítulo

Parte V: Parte 5 — Operaciones, IaC y plataforma como producto

  1. 186Operar la IDP: Docker, kind, OpenTofu, Crossplane, observabilidad
  2. 187Operar la cocina: del dev al cluster
  3. 188Stack local con Docker Compose
  4. 189Cluster local con kind
  5. 190IaC con OpenTofu
  6. 191Crossplane: CRDs como infra
  7. 192Desplegar Backstage en Kubernetes
  8. 193Observabilidad: métricas, logs y traces
  9. 194Logs y alertas
  10. 195Backup y disaster recovery
  11. 196Upgrades: el baile de versiones
  12. 197Multi-tenant: aislamiento por namespace
  13. 198Plugins extra útiles
  14. 199Resumen
  15. 200Glosario del capítulo
  16. 201Próximo capítulo

Parte VI: Parte 6 — Comparativa y cierre

  1. 202Backstage vs Port vs Compass vs Cortex: guía de compra
  2. 203No hay un "mejor", hay un "para quién"
  3. 204Tabla comparativa (5 ejes)
  4. 205Backstage en detalle
  5. 206Port en detalle
  6. 207Compass en detalle
  7. 208Cortex en detalle
  8. 209Radar comparativo
  9. 210Métricas de adopción
  10. 211ROI: el argumentario para la CTO
  11. 212Scoring honesto: cómo lo construirías para tu empresa
  12. 213Cierre del libro
  13. 214Resumen
  14. 215Glosario del capítulo
  15. 216Próximo paso

Parte VII: Parte 7 — Patrones, principios y casos de estudio: las recetas que sobreviven al tiempo

  1. 217Patrones de implementación: las recetas que sobreviven al tiempo

Apéndices · Referencia y prerrequisitos