# Lancer un build

> Construisez l'image d'un service depuis une branche, un tag ou un commit de son dépôt Git.

Un build clone le code de votre service, exécute son Dockerfile et range l'image obtenue dans le registre de l'application. Il ne change rien à ce qui tourne : vous déploierez l'image ensuite.

## Avant de commencer

- Le service existe dans l'architecture et son dépôt est **Provisionné** : voir [Créer un service](/v1.0/services/creer-un-service).
- Le Dockerfile se trouve à l'emplacement déclaré dans le service.
- Si un quota de stockage est fixé pour votre application, il n'est pas atteint : voir la carte **Registre** de la page **Builds**.

## Lancer le build

::::steps
### Ouvrir le formulaire

Dans le menu de l'application, cliquez sur **Builds**, puis sur **Nouveau build**.

### Choisir le service

Dans **Service**, choisissez le service à construire. Chaque entrée affiche son nom, son slug et son rôle.

### Choisir la source

Dans **Type de source**, choisissez :

- **Branche** : puis, dans **Branche**, choisissez la branche dans la liste. La branche par défaut est marquée « (défaut) », et la mention « Sera déployé : » indique le commit qui sera construit ;
- **Tag** : puis choisissez le tag Git ;
- **Commit SHA** : puis saisissez le SHA **complet**, 40 caractères hexadécimaux.

Si la liste des branches ne se charge pas, un champ libre la remplace : saisissez le nom de la branche à la main.

### Régler le mode Boost

Laissez **Mode Boost** coché pour allouer plus de ressources au build. Décochez-le pour un petit service : le build utilise alors 1 CPU et 2 Gio de mémoire au plus.

L'encart **Image qui sera construite** affiche le chemin de l'image et le format de son tag, par exemple `…/api:<main-AAAAMMJJ-hhmmss>`.

### Déclencher

Cliquez sur **Déclencher le build**.

Résultat : le message « Build déclenché » (« Le build a été ajouté à la file d'attente ») s'affiche et la page du build s'ouvre, au statut **En attente**. Il passe à **Construction en cours** dans les 10 secondes.
::::

## Vérifier le résultat

Suivez le build jusqu'à son statut final : voir [Suivre un build](/v1.0/builds-et-deploiements/suivre-un-build). Un build **Succès** apparaît dans la liste **Historique des builds** avec son **Image Tag**, et son image devient disponible au déploiement.

## Dépannage

- « Quota du registre atteint : X Go utilisés sur Y Go. Libérez de la place (purge automatique, suppression de builds) ou demandez un relèvement du quota. » : voir [Gérer le registre d'images](/v1.0/builds-et-deploiements/gerer-le-registre).
- `sourceCommit must be a valid 40-character hexadecimal SHA` : saisissez le SHA complet du commit, pas sa forme courte.
- Le bouton **Nouveau build** n'apparaît pas : il vous manque le droit **Déclencher un build**.
- Le build échoue : voir [Résoudre les problèmes de build et de déploiement](/v1.0/builds-et-deploiements/depannage).

## Voir aussi

- [Suivre un build](/v1.0/builds-et-deploiements/suivre-un-build)
- [Automatiser les builds et les déploiements](/v1.0/builds-et-deploiements/automatiser-builds-et-deploiements)
- [Déployer une image](/v1.0/builds-et-deploiements/deployer-une-image)
