Aller au contenu
Cabinet d'expertise en transformation technologique · ARDIANE Group Innover, sécuriser, réussir

Lexique

Internal developer portal : définition du portail développeur interne

Domaine

Cloud et plateformes

L'essentiel

Un internal developer portal, ou portail développeur interne, est l'interface web où les équipes de développement d'une organisation trouvent le catalogue des composants logiciels, leurs responsables et leur documentation, créent des projets à partir de modèles et accèdent aux capacités de la plateforme interne. L'expression est d'usage : le livre blanc « Platforms » de la CNCF parle de portails web.

Sommaire de la page

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.

FAQ

Questions fréquentes

Une autre question ? Posez-la-nous

À quoi sert un internal developer portal ?

Un internal developer portal sert de point d'entrée aux équipes de développement d'une organisation : elles y trouvent les composants logiciels existants, leurs responsables et leur documentation, et y créent de nouveaux projets à partir de modèles. Le livre blanc « Platforms » du TAG App Delivery de la CNCF confie aux portails web la publication de la documentation, des catalogues de services et des modèles de projet. Selon ce texte, un formulaire de portail permet aussi de demander une capacité de la plateforme, une base de données par exemple.

Quelle différence entre internal developer portal et internal developer platform ?

L'internal developer platform est l'ensemble des capacités qu'une équipe plateforme offre en libre-service aux équipes de développement : environnements, chaînes de livraison, bases de données. L'internal developer portal est l'une des interfaces qui y donnent accès. Le livre blanc « Platforms » de la CNCF cite les portails à côté des interfaces graphiques, des API, de la ligne de commande et des environnements de développement.

Backstage est-il un internal developer portal ?

Backstage se présente, dans sa documentation, comme un cadre open source pour construire des portails développeur (« an open source framework for building developer portals »), bâti autour d'un catalogue logiciel centralisé. Backstage sert donc à construire un internal developer portal, que l'organisation assemble elle-même. D'après la page du projet sur le site de la CNCF, consultée le 12 novembre 2026, Backstage a été accepté par la CNCF le 8 septembre 2020 et se trouve au niveau de maturité « Incubating » depuis le 15 mars 2022.

Un projet à faire aboutir ?

Un premier échange suffit pour situer votre enjeu, identifier les bons interlocuteurs et vous dire franchement ce que nous pouvons apporter.