# Automatiser les builds et les déploiements

> Construisez chaque service à chaque push sur la branche d'un environnement, et déployez automatiquement chaque build réussi.

Deux options d'un environnement mettent en place la livraison continue : **Build automatique** construit les services à chaque push sur la branche suivie, **Auto-deploy on new build** déploie chaque build réussi de cette branche. Elles s'activent séparément.

## Avant de commencer

- L'environnement suit une **branche** : les deux options sont indisponibles avec un tag ou un commit.
- Le service est déjà déployé dans l'environnement : le build automatique ne construit que les services qui y ont une instance.
- Pour un dépôt importé, l'application GitHub de Wakastart y a accès : voir [Connecter un dépôt Git](/v1.0/builds-et-deploiements/connecter-un-depot#donner-accès-à-un-dépôt-importé).

## Activer les options

1. Dans **Environnements**, ouvrez l'environnement, puis l'onglet **Résumé**.
2. Dans la carte **Informations**, à côté de **Git Ref**, cliquez sur **Éditer**.
3. Dans la fenêtre **Configuration Git**, vérifiez **Branche / tag / commit** (par exemple `develop`) et choisissez **Branche** dans **Type**.
4. Cochez **Build automatique**, **Auto-deploy on new build**, ou les deux.
5. Cliquez sur **Enregistrer**.

Résultat : le message « Configuration Git mise à jour » s'affiche ; la carte **Informations** porte les badges **Build auto** et **Auto-deploy**.

L'activation ne lance pas de build : seuls les push suivants sont concernés.

## Ce qui déclenche un build automatique

À chaque push sur un dépôt de l'application, Wakastart construit un service si toutes ces conditions sont réunies :

1. le service utilise ce dépôt ;
2. au moins un environnement actif suit la branche poussée, avec **Build automatique**, et y fait tourner le service ;
3. le push modifie au moins un fichier du **Répertoire racine** du service, hors des chemins ignorés ;
4. aucun build de ce commit n'existe déjà pour ce service.

Le build est lancé en **Mode Boost**, avec le déclencheur **Automatique**. La suppression d'une branche ne déclenche rien. Un push sur une branche nouvelle, ou un service sans répertoire racine ni chemin ignoré, déclenche toujours le build.

Si le quota de stockage de l'application est atteint, le build automatique n'est pas lancé.

## Ce qui déclenche un déploiement automatique

Quand un build lancé depuis une branche réussit, Wakastart déploie son image, dans les 30 secondes, sur chaque instance du service dont l'environnement :

- est actif et a **Auto-deploy on new build** coché ;
- suit exactement la branche du build.

Le déploiement apparaît dans l'historique avec le déclencheur **Auto**. Il n'a pas lieu si un déploiement plus récent a déjà réussi sur l'instance depuis la fin du build. Les builds lancés depuis un tag ou un commit ne sont jamais déployés automatiquement.

## Limiter les builds dans un monorepo

Pour qu'un changement de documentation ne reconstruise pas un service :

1. Dans **Architecture** > **Services**, ouvrez le service, puis cliquez sur **Modifier**.
2. Sous **Ignorer ces chemins pour le build automatique**, ajoutez les motifs à exclure, par exemple `*.md`, `docs/**` ou `.github/**`, avec **Ajouter**.
3. Cliquez sur **Enregistrer**.

Les motifs sont relatifs au répertoire racine du service. Un push qui ne modifie que des fichiers ignorés ne déclenche pas de build.

## Vérifier le résultat

1. Poussez un commit sur la branche suivie, dans le dossier d'un service.
2. Dans **Builds**, un build apparaît avec le déclencheur **Automatique**.
3. S'il réussit et que le déploiement automatique est actif, l'onglet **Deployments** de l'environnement affiche un déploiement « Image mise à jour » déclenché par **Auto**.

## Dépannage

- « Build automatique indisponible » : un dépôt importé de l'environnement n'est pas accessible à la plateforme. Voir [Donner accès à un dépôt importé](/v1.0/builds-et-deploiements/connecter-un-depot#donner-accès-à-un-dépôt-importé).
- Aucun build après un push : voir [Résoudre les problèmes de build et de déploiement](/v1.0/builds-et-deploiements/depannage#aucun-build-après-un-push).

## Voir aussi

- [Builds et déploiements, la différence](/v1.0/builds-et-deploiements/builds-et-deploiements)
- [Configurer un environnement](/v1.0/applications/configurer-un-environnement)
- [Liste de contrôle de livraison](/v1.0/builds-et-deploiements/liste-de-controle)
