# Suivre un build

> Suivez l'avancement d'un build, lisez son message d'erreur et ses logs, et retrouvez l'historique des builds de l'application.

Chaque build a sa page, rafraîchie automatiquement tant qu'il tourne. Les logs s'y affichent une fois le build terminé.

## Avant de commencer

- Un build a été lancé, à la main ou automatiquement après un push.

## Retrouver un build

1. Dans le menu de l'application, cliquez sur **Builds**.
2. Dans le tableau **Historique des builds**, repérez le build : il liste les builds de tous les services, du plus récent au plus ancien.

| Colonne | Contenu |
|---|---|
| **Statut** | **En attente**, **En cours**, **Succès** ou **Échec** |
| **Service** | Service construit |
| **Source** | Branche, tag ou commit, avec les 7 premiers caractères du commit construit |
| **Image Tag** | Tag de l'image produite, avec les badges **Déployé · …** et **Conservé** |
| **Trigger** | **Manuel** ou **Automatique**, et **Boost** si le mode était actif |
| **Durée** | Temps entre le début et la fin du build |
| **Date** | Date de création du build |

3. Ouvrez le menu de la ligne et cliquez sur **Voir les détails**.

## Lire la page du build

La page **Build #<identifiant>** contient :

- le statut, avec sa description : « Le build est en file d'attente », « L'image Docker est en cours de construction », « Le build s'est terminé avec succès » ou « Le build a échoué » ;
- la carte **Informations** : source, commit et tag de l'image ;
- la carte **Erreur**, si le build a échoué : le message de synthèse ;
- la carte **Logs du build** : la sortie du clone et du Dockerfile.

Tant que le build tourne, la page indique « Cette page se rafraîchit automatiquement toutes les 5 secondes ». Cliquez sur **Actualiser** pour forcer un rafraîchissement.

:::important[Logs disponibles à la fin]
Les logs ne s'affichent qu'une fois le build terminé, en succès comme en échec. Seule la fin de la sortie est conservée (5 000 dernières lignes, 80 000 caractères au plus) : l'erreur, en fin de sortie, reste visible.
:::

## Lire les logs

Les logs suivent l'ordre du build :

1. `=== Git credentials check ===` puis `Using GitHub App authentication...` : connexion au dépôt ;
2. `Cloning branch: main` (ou `Cloning tag:`, `Checking out specific commit:`) puis `Clone completed successfully` ;
3. les étapes de votre Dockerfile ;
4. la publication de l'image dans le registre.

Cherchez la première ligne `ERROR` ou le premier échec d'une étape du Dockerfile : c'est en général la cause.

## Vérifier le résultat

Un build **Succès** affiche son **Image Tag** et son image apparaît dans la liste **Image à déployer** des environnements. Voir [Déployer une image](/v1.0/builds-et-deploiements/deployer-une-image).

## Voir aussi

- [Résoudre les problèmes de build et de déploiement](/v1.0/builds-et-deploiements/depannage)
- [Lancer un build](/v1.0/builds-et-deploiements/lancer-un-build)
- [Référence des builds et déploiements](/v1.0/builds-et-deploiements/reference)
