Orbit
Affichage des journaux de compilation
Every Orbit deployment keeps its complete build log, plus a structured breakdown of what the build did and how long each phase took. This guide covers where to find the log, how to read the…
Affichage du journal pour le dernier déploiement
Ouvrez le projet dans Orbit. Le panneau Latest build de l'onglet Overview affiche le journal de déploiement le plus récent. Si une compilation est en cours en ce moment, le journal s'affiche en direct, ligne par ligne, au fur et à mesure que l'agent de compilation le produit.
Cliquez sur Full details pour ouvrir la page complète des détails du déploiement.
Affichage des journaux pour un déploiement spécifique
- Ouvrez votre projet dans Orbit.
- Ouvrez l'onglet Deployments.
- Cliquez sur un déploiement quelconque pour ouvrir sa page de détails.
- Le journal de compilation complet se trouve sur cette page.
La liste Recent deployments de l'onglet Overview dispose d'un lien View logs sur chaque ligne qui accède au même endroit. Les déploiements d'aperçu disposent du même lien dans la section Preview deployments.
Phases de compilation
La page de détails divise la compilation en phases nommées, chacune avec une durée :
| Phase | Ce qui se passe |
|---|---|
| Clone | Récupération de votre référentiel au commit déployé |
| Cache restore | Décompactage du cache node_modules, sur les forfaits avec cache de compilation |
| Install | Exécution de votre commande d'installation |
| Cache save | Recompactage de node_modules pour la compilation suivante |
| Build | Exécution de votre commande de compilation |
| Upload | Empaquetage du répertoire de sortie et stockage de l'artefact |
| Done | L'artefact est en avant du trafic |
C'est le moyen le plus rapide de répondre à « pourquoi cette compilation a-t-elle été lente ». Une longue phase Install avec un badge Cold build signifie que le cache a été manqué. Une longue phase Build signifie que votre propre compilation a ralenti.
Métadonnées de compilation
Les cartes au-dessus du journal affichent les faits concernant le déploiement :
| Carte | Ce qu'elle affiche |
|---|---|
| Status | Queued, Building, Deploying, Succeeded, Failed, Cancelled, Rolled back ou Awaiting approval |
| Commit | Le commit que ce déploiement a compilé, avec lien vers le fournisseur |
| Branch | La branche git d'où il provient |
| Author | Qui a poussé le commit |
| Build time | Durée totale du mur horaire, avec une évaluation Fast, Normal ou Slow par rapport à votre propre historique |
| Artifact | Taille de la sortie empaquetée, avec un lien de téléchargement |
| Framework | Le framework qu'Orbit a détecté |
| Package manager | npm, yarn ou pnpm, détecté à partir de votre lockfile |
| Build cache | Cache hit ou Cold build |
| Build host | Quel hôte de compilation l'a exécuté |
| Queue position | Votre place dans la file d'attente, tandis que le déploiement est toujours en attente |
| Pull request | Le numéro de PR, pour un déploiement d'aperçu |
| Health score | Un score sur 100 avec les déductions énumérées |
Analyse qu'Orbit exécute sur le journal
La page de détails n'est pas juste un vidage de texte. Orbit analyse le journal et expose ce qui importe.
- Build timeline avec des durées par phase.
- Slow build detected quand une compilation est considérablement plus lente que votre médiane, avec le pourcentage et votre temps typique des 10 dernières compilations.
- TypeScript errors, extraites et comptées, quand la compilation a échoué sur la vérification des types.
- Build analysis pour les compilations Next.js : tailles par route, JS de premier chargement, et nombres de routes statiques, dynamiques et ISR.
- Bundle regression avertissements quand le JS de premier chargement d'une route croît de plus de 20 % par rapport au déploiement précédent, ou quand le bundle JS partagé croît.
- npm audit résultats analysés directement à partir de la sortie d'installation, résumés par gravité.
- Security headers audit noté sur 60 points.
- Smoke test résultats, si vous avez configuré des chemins de test de fumée.
- Performance budgets dépassés, si vous avez défini des budgets.
- Build optimization advisor, énumérant des changements concrets avec une économie de taille estimée, classés par impact.
- Real user metrics, le p75 Core Web Vitals enregistré pendant que ce déploiement était en direct.
Variables d'environnement que la compilation a réellement vues
La page de détails énumère les clés de variable d'environnement qui ont été injectées au moment de la compilation, et les compare avec votre configuration actuelle : ajoutées, modifiées, supprimées, inchangées. Les clés cyan proviennent d'une substitution spécifique à l'environnement, les grises du niveau du projet.
Les valeurs ne sont jamais stockées et jamais affichées. En survolant une clé, vous obtenez une empreinte digitale SHA-256, suffisante pour confirmer que deux environnements ont la même valeur sans la révéler.
Cette différence est le moyen le plus rapide de répondre à « ma modification de variable d'environnement a-t-elle réellement été intégrée à la compilation ». Si le déploiement précède la modification, Orbit l'indique avec un avis Environment variables updated since this deployment et vous rappelle que la modification ne prendra effet que lors d'un nouveau déploiement.
Comparaison de deux déploiements
Cliquez sur Compare sur un déploiement pour le différencier du précédent : durée de compilation, taille d'artefact, état du cache, framework, et la différence d'artefact au niveau des fichiers. C'est l'itinéraire le plus rapide vers « qu'est-ce qui a réellement changé » quand un déploiement se comporte différemment du précédent.
Quand une compilation échoue
La carte de statut passe à Failed et le journal affiche où elle s'est arrêtée. Au-dessus du journal, Orbit ajoute un résumé d'échec catégorisé avec une correction suggérée. Les catégories reconnues incluent manque de mémoire, erreur de compilation, échec du test, erreur de lint, erreur d'installation, erreur réseau et délai d'attente, et Orbit correspond à des modèles spécifiques tels qu'un module manquant, un conflit de dépendance pair ERESOLVE, un code d'erreur TypeScript, un disque de compilation plein, un package 404 et un lockfile obsolète.
Il y a aussi un bouton Get AI diagnosis, qui lit les 120 dernières lignes du journal ainsi que le framework détecté et la catégorie d'échec, et retourne une explication en langage clair.
Le diagnostic IA est étiqueté AI-generated, verify before acting pour une raison. Il est très doué pour vous pointer la bonne ligne du journal, et il n'est pas faisant autorité sur votre base de code. Lisez la ligne du journal à laquelle il se réfère avant de changer quoi que ce soit.
Nouvelle tentative d'une compilation échouée
Sur la page de détails du déploiement, cliquez sur Retry build pour réexécuter le même commit sans pousser un nouveau. Cela corrige les défaillances transitoires telles qu'une erreur réseau lors de l'installation.
Si vous soupçonnez une dépendance en cache obsolète, utilisez More retry options, puis Retry with cleared cache, qui supprime le cache de compilation avant de réessayer.
Des conseils complets d'échec à échec se trouvent dans Dépannage des compilations échouées.
Annulation d'une compilation en cours
Cliquez sur Cancel pendant qu'une compilation est en cours.
L'annulation termine la machine de compilation immédiatement et ne peut pas être annulée. Le déploiement est enregistré comme Cancelled, et le déploiement précédemment en direct continue à servir le trafic, donc l'annulation ne met jamais votre site hors ligne. Notez que pousser un nouveau commit vers la même branche pendant qu'une compilation est en cours annule automatiquement la compilation en vol, donc un déploiement annulé suivi d'un déploiement en cours est normal.
Téléchargement de l'artefact
Chaque déploiement réussi conserve sa sortie empaquetée. Cliquez sur Download sur la carte Artifact pour extraire l'exact bundle qui a été servi. Il y a aussi un navigateur d'artefacts pour inspectionner le contenu sans télécharger l'ensemble.
La durée de conservation des artefacts est définie dans Settings, sous Artifact retention : le nombre d'artefacts réussis à conserver par environnement, de 10 à 500, par défaut 50. Les artefacts plus anciens sont supprimés quotidiennement. L'artefact du déploiement actuellement en direct est toujours conservé, indépendamment du paramètre.
La conservation des artefacts est ce qui rend la restauration possible. Le fixer trop bas raccourcit la distance jusqu'à laquelle vous pouvez restaurer un mauvais déploiement sans reconstruction. Si vous déployez plusieurs fois par jour, augmentez-le plutôt que de le diminuer.