Définition de l’internal developer portal
Quels services logiciels existent déjà, qui en répond, comment en créer un nouveau ? L’internal developer portal, ou portail développeur interne, est l’interface web qui réunit ces réponses pour les équipes de développement d’une organisation. Il rassemble un catalogue des composants logiciels, des modèles de projet, la documentation technique et un accès aux capacités de la plateforme interne.
L’expression appartient au vocabulaire des projets et des éditeurs d’outils. Le livre blanc « Platforms » du TAG App Delivery de la CNCF (tag-app-delivery.cncf.io) ne l’emploie pas. Il parle de portails web (« Web portals ») et en fait l’une des familles de capacités d’une plateforme, chargée de publier la documentation, les catalogues de services et les modèles de projet.
Deux documentations d’outils, consultées le 12 novembre 2026, parlent de portail développeur. Celle de Backstage, projet de la CNCF, décrit « an open source framework for building developer portals », soit un cadre open source pour construire des portails développeur. Celle de Port, produit d’un éditeur, voit dans l’internal developer portal une interface centrale (« a central interface ») où les développeurs trouvent les services, consultent l’information d’ingénierie et lancent des actions en libre-service (traduction).
Portail, plateforme, catalogue ITSM, portail d’API : ne pas confondre
La plateforme interne de développement (internal developer platform), définie dans notre fiche platform engineering, est l’ensemble des capacités offertes en libre-service. Le portail en est une interface : le livre blanc de la CNCF cite aussi les API, la ligne de commande et les environnements de développement. Les deux expressions partagent le sigle IDP.
Dans la gestion des services informatiques (ITSM), l’usage appelle catalogue de services la liste de ce qu’une direction informatique propose à ses utilisateurs. Le catalogue d’un portail développeur recense des composants logiciels et les équipes qui en répondent.
Le portail d’API, présenté dans la fiche API management, s’adresse à ceux qui consomment des API, tiers compris.
Le golden path est un parcours recommandé, que le portail donne à trouver.
Catalogue, modèles, documentation, libre-service
La documentation de Backstage détaille trois fonctions de base, que des plugins complètent.
- Le catalogue logiciel suit la propriété et les métadonnées des logiciels de l’organisation : services, sites web, bibliothèques, pipelines de données. Il s’alimente de fichiers YAML rangés avec le code. Son but déclaré : que chaque logiciel et son responsable puissent être retrouvés. Le besoin croît avec le nombre de composants, comme dans une architecture microservices.
- Les modèles servent à créer de nouveaux projets conformes aux pratiques de l’organisation.
- La documentation technique est gérée comme du code (« docs like code »).
S’y ajoute le libre-service, que Port nomme « self-service actions ». Le livre blanc de la CNCF en donne un exemple : demander une base de données par un formulaire, puis en recevoir l’adresse et les identifiants.
Chez un transporteur : retrouver le responsable d’un service
Supposons un transporteur dont les équipes maintiennent des services de suivi de colis, de planification des tournées et de facturation. Une développeuse doit appeler le service des tournées. Elle le cherche dans le catalogue du portail, y lit le nom de l’équipe propriétaire et ouvre la documentation de l’interface.
Plus tard, cette équipe est scindée, et personne ne corrige le fichier de métadonnées du service. Le catalogue affiche alors une équipe qui n’existe plus.
Ce qu’un portail ne règle pas
Le portail est une interface. Si aucune capacité automatisée ne répond derrière un formulaire, la demande est traitée à la main.
Le catalogue vaut ce que valent les métadonnées tenues par les équipes.
Un portail n’est pas non plus un préalable. D’après le livre blanc de la CNCF, une plateforme très simple peut se réduire à une page de wiki renvoyant vers des procédures. Enfin, un portail est lui-même un logiciel à exploiter et à maintenir.
Notre page DevOps et platform engineering précise à quel moment d’une démarche de plateforme un portail trouve sa place.