Définition du golden path : un parcours recommandé et pris en charge
Un golden path, traduit ici par chemin balisé, est le parcours qu’une organisation recommande à ses équipes de développement pour un besoin courant, et qu’elle s’engage à maintenir.
Le blog d’ingénierie de Spotify (engineering.atspotify.com) a publié le 17 août 2020, sous la signature de Gary Niemen, un article sur l’emploi de la notion dans cette entreprise. Le golden path y est défini comme le chemin « opinionated and supported » pour construire quelque chose : un service applicatif, un site web, un pipeline de données. Autrement dit, les choix d’outils y sont déjà faits (opinionated) et le parcours bénéficie d’un support (supported). Un tutoriel, par discipline, guide le développeur.
L’article part d’un constat. Des équipes autonomes avaient produit un outillage fragmenté, où l’on apprenait comment faire en interrogeant ses collègues : l’auteur parle de « rumour-driven development ». Avec un chemin tracé, écrit-il, les équipes ne réinventent pas la roue et ont moins de décisions à prendre. Le tutoriel sert aussi à l’intégration des nouveaux ingénieurs.
Le livre blanc « Platforms » du TAG App Delivery de la CNCF (tag-app-delivery.cncf.io) emploie le terme dans un sens voisin. Une chaîne réutilisable de construction, de test et de déploiement, offerte avec un modèle de projet initial et une documentation, y forme un ensemble souvent décrit, selon ce texte, comme un golden path.
Golden path, modèle de projet, norme imposée, portail développeur : ne pas confondre
- Le modèle de projet crée le squelette d’un dépôt. Le chemin l’inclut et lui ajoute la chaîne de livraison, la documentation et le support.
- La norme imposée ferme les autres voies. Le golden path se quitte : dans le texte de Spotify, l’équipe qui s’en écarte ne bénéficie plus du même support.
- Le portail développeur (internal developer portal) est l’endroit où les parcours se trouvent et se lisent. Le livre blanc de la CNCF range les portails web et les golden paths dans deux familles de capacités distinctes.
- « Paved Road » (route pavée) et « Silver Path » figurent dans l’article de Spotify comme des notions dérivées, sans y être définies.
Ces parcours sont l’un des produits du platform engineering, défini dans une fiche distincte.
Des choix déjà faits, un support assuré
Les deux adjectifs de la définition disent ce que contient un chemin balisé.
Les choix portent sur les outils et sur leur enchaînement : langage, chaîne de livraison, ressources décrites par de l’infrastructure as code, mode de déploiement, par exemple en GitOps. L’article de Spotify demande que les outils recommandés soient faciles à découvrir et que le trajet de l’un à l’autre soit clair.
Le support recouvre, dans le même article, des instructions de qualité, un recours évident pour qui reste bloqué, et un tutoriel mis à jour chaque fois qu’un outil du parcours est remplacé.
Un groupe de presse trace son premier chemin
Imaginons un groupe de presse dont plusieurs équipes développent les services de ses sites. Chacune a choisi son langage et monté sa chaîne de livraison. L’équipe plateforme retient un besoin qui revient, le service web exposant une interface de programmation, et en trace le chemin : modèle de dépôt, chaîne de livraison, environnements à la demande, tutoriel, canal de support.
L’équipe chargée des podcasts a besoin d’un traitement audio que le chemin ne couvre pas. Elle s’en écarte pour ce composant et en assume l’exploitation. Si d’autres équipes font le même écart, l’équipe plateforme y lit le besoin d’un second chemin.
Les limites d’un chemin balisé
L’article de Spotify signale plusieurs difficultés. Un tutoriel jugé trop long reflète un parcours trop long : c’est le parcours qu’il faut raccourcir. Un parcours très simplifié cache des boîtes noires, alors que le tutoriel a aussi une fonction pédagogique. Enfin, répartir la propriété du contenu entre de nombreuses équipes pose un problème de coordination.
Notre page DevOps et platform engineering décrit la conception de ces chemins au sein d’une plateforme interne de développement.