Aller au contenu

Amorcer vendor/ plutôt que le retélécharger

Créer un worktree, c'est créer un checkout neuf — et un checkout neuf n'a pas de vendor/. Jusqu'ici, chaque castor wt:up sur un worktree neuf repartait donc d'un composer install complet, paquet par paquet, à travers le proxy sortant. Cette page explique pourquoi la cible commence désormais par copier le vendor/ du dépôt principal, et surtout pourquoi cette copie reste une optimisation qui ne décide de rien.

Le geste et les messages affichés sont ailleurs : Créer et détruire un worktree pour le parcours, L'amorce de vendor/ pour la fiche factuelle.

Ce qu'un worktree neuf payait

Trois faits se combinent, et aucun n'est négociable pris isolément.

vendor/ est gitignoré : il n'appartient pas à la branche, donc git worktree add ne le crée pas. Le Dockerfile en construit bien un dans l'image, mais le bind .:/app du service php le masque intégralement — la stack démarre sur le répertoire de travail, pas sur celui de l'image. Et FrankenPHP exige vendor/autoload_runtime.php dès son premier tour de boucle : sans installation préalable, le conteneur boucle en crash. C'est pourquoi wt:up installe les dépendances avant de démarrer la stack, dans un conteneur jetable.

Cette installation, elle, part de zéro à chaque fois. Le conteneur est détruit derrière (run --rm), aucun cache Composer ne survit d'un worktree à l'autre, et tout ce qui est téléchargé traverse le proxy sortant à allowlist. Sur un dépôt de la taille de Kirexo, l'attente se compte en minutes, à chaque worktree créé.

Pendant ce temps, le dépôt principal porte, deux répertoires plus loin sur le même disque, ces mêmes paquets pour ce même composer.lock — dans la quasi-totalité des cas, puisque la branche d'un ticket part de main.

Copier coûte moins cher que télécharger

L'amorce consiste à poser ce vendor/ dans le worktree avant d'appeler Composer, qui n'a plus alors qu'à ajuster ce qui diffère.

Sur un système de fichiers copy-on-write — btrfs, xfs — la copie est près d'être gratuite : le système ne duplique aucun bloc tant que rien n'est réécrit, donc ni le temps ni l'espace disque n'augmentent avec la taille de vendor/. Sur les autres systèmes de fichiers, les fichiers sont réellement écrits, et la copie reste très en dessous du coût d'un téléchargement complet.

Sur macOS, cp ne connaît pas l'option --reflink, qui est une extension GNU coreutils : la copie a lieu quand même, simplement sans copy-on-write. Il n'y a rien à configurer, d'aucun côté — le comportement est déduit de l'outil présent sur le poste, jamais d'une variable ou d'une option de la cible.

Une optimisation, jamais une garantie

C'est le point qui compte le plus, parce qu'il détermine ce qu'il faut croire de l'amorce quand quelque chose ne va pas.

composer install est joué systématiquement derrière, et c'est lui qui fait foi. L'amorce ne dispense de rien : elle ne fait que rendre le travail de Composer plus court. Deux branches peuvent porter des composer.lock différents, et une copie tenue pour suffisante installerait silencieusement les mauvaises versions dans le worktree. La correspondance entre vendor/ et composer.lock n'est donc jamais affirmée par la copie — elle reste établie par Composer, comme avant.

Corollaire pratique : une amorce ratée coûte du temps, pas de la justesse. Il n'y a aucun état à rattraper, aucune commande de réparation à jouer.

Ne jamais interrompre wt:up

De ce statut découle la seconde propriété : l'amorce ne fait jamais échouer la cible. Disque plein, permissions, source en mouvement, copie devancée par un autre wt:up — dans tous ces cas, un avertissement s'affiche et l'installation complète prend le relais, exactement comme avant l'existence de cette étape.

Sortir en erreur ici transformerait une optimisation en point de rupture : on empêcherait de créer un worktree pour la seule raison qu'un raccourci n'a pas pu être pris. La règle vaut aussi pour le cas où il n'y a rien à copier — un dépôt principal sans vendor/ exploitable ne bloque pas, il annonce simplement une installation complète, c'est-à-dire une attente.

Les limites assumées

Trois cas ne sont pas couverts, et il vaut mieux les nommer que les croire fermés.

La source doit être au repos. Un castor install qui tourne dans le dépôt principal pendant la copie peut produire un instantané incohérent. Le cas courant est détecté et l'amorce est alors abandonnée, mais la détection ne prétend pas à l'exhaustivité — et c'est précisément pourquoi Composer repasse derrière.

Deux castor wt:up simultanés sur le même worktree ne sont pas un mode supporté. Deux wt:up sur des worktrees différents ne se gênent pas ; deux runs concurrents sur le même worktree se disputent le même vendor/, et fermer ce cas demanderait un verrou sur toute l'installation — un prix disproportionné pour une étape dont le seul enjeu est la vitesse.

Une interruption brutale peut laisser un résidu. La copie est construite à côté avant d'être publiée d'un coup ; un SIGKILL entre les deux laisse à la racine du worktree un répertoire vendor.seed-tmp.*, gitignoré et sans effet sur la stack, que rien ne nettoie automatiquement. Il occupe de l'espace disque : on le supprime à la main quand on le croise.

Pourquoi une copie, et pas un vendor/ partagé

Faire pointer les worktrees vers un vendor/ unique — lien symbolique, volume commun — supprimerait la copie elle-même. Mais le vendor/ d'un worktree doit rester le sien : deux branches dont les composer.lock diffèrent se réécriraient mutuellement leurs dépendances, et l'installation de l'une invaliderait la stack de l'autre, sans le moindre signal. C'est le même raisonnement que pour la base de données, qui reste dédiée quand Redis ou RabbitMQ sont mutualisés — cf. Profils de ressources et mutualisation des services : ce qui porte l'état d'une branche ne se partage pas.

La copie a exactement la propriété inverse, et c'est ce qui la rend acceptable : dès que Composer a rendu la main, plus rien ne rattache le vendor/ du worktree à celui du dépôt principal. Un cache Composer partagé, lui, s'attaquerait au téléchargement mais laisserait entière l'écriture des dizaines de milliers de fichiers de vendor/ — précisément ce que le copy-on-write rend gratuit.

Pour aller plus loin