# Builds et déploiements

> Construisez les images de vos services depuis Git, à la main ou à chaque push, puis déployez-les ou revenez à une version précédente.

Wakastart transforme le code de vos dépôts Git en images de conteneur, les range dans le registre privé de votre application, puis les fait tourner dans vos environnements. Deux opérations distinctes : le **build** fabrique une image, le **déploiement** la met en service.

## Comment ça marche

```mermaid
flowchart LR
  PUSH["git push<br/>branche develop"] -->|"Build automatique"| BUILD["Build<br/>clone + Dockerfile"]
  MANUEL["Nouveau build"] --> BUILD
  BUILD -->|"pousse"| REG[("Registre de l'app<br/>api:develop-20261023-101500")]
  REG -->|"Auto-deploy on new build"| DEV["Instance en dev"]
  REG -->|"Déployer une image"| PROD["Instance en prod"]
  PROD -.->|"redéployer un tag plus ancien"| REG
```

Un [build](/v1.0/glossaire#build) clone une branche, un tag ou un commit de votre dépôt, exécute son Dockerfile et pousse l'image obtenue sous un tag unique et horodaté. Un [déploiement](/v1.0/glossaire#déploiement) remplace l'image d'une instance de service par une autre, progressivement. Les deux s'automatisent par environnement : chaque push sur la branche suivie peut déclencher un build, et chaque build réussi un déploiement. Voir [Builds et déploiements : la différence](/v1.0/builds-et-deploiements/builds-et-deploiements).

## Choisissez votre approche

::::cards{cols=2}
:::card{title="Livraison continue" href="/v1.0/builds-et-deploiements/automatiser-builds-et-deploiements" icon="Workflow"}
Build et déploiement à chaque push sur la branche de l'environnement. Idéal pour dev et staging.
:::
:::card{title="Livraison à la main" href="/v1.0/builds-et-deploiements/lancer-un-build" icon="Hand"}
Vous lancez le build, puis vous choisissez l'image à déployer. Recommandé pour la production.
:::
::::

## Commencer

::::cards{cols=3}
:::card{title="Connecter un dépôt Git" href="/v1.0/builds-et-deploiements/connecter-un-depot" icon="GitBranch"}
Créez un dépôt géré par Wakastart ou référencez votre dépôt GitHub.
:::
:::card{title="Lancer un build" href="/v1.0/builds-et-deploiements/lancer-un-build" icon="Hammer"}
Construisez l'image d'un service depuis une branche, un tag ou un commit.
:::
:::card{title="Déployer une image" href="/v1.0/builds-et-deploiements/deployer-une-image" icon="Rocket"}
Mettez une image construite en service dans un environnement.
:::
::::

## Fonctionnalités

::::cards{cols=3}
:::card{title="Suivi en direct" href="/v1.0/builds-et-deploiements/suivre-un-build" icon="Activity"}
Statut rafraîchi toutes les 5 secondes, logs affichés à la fin du build.
:::
:::card{title="Monorepo" href="/v1.0/builds-et-deploiements/automatiser-builds-et-deploiements" icon="FolderTree"}
Seuls les services dont le dossier a changé sont reconstruits.
:::
:::card{title="Retour arrière" href="/v1.0/builds-et-deploiements/revenir-a-une-version-precedente" icon="Undo2"}
Redéployez une image précédente en quelques clics.
:::
:::card{title="Historique des déploiements" href="/v1.0/builds-et-deploiements/consulter-l-historique-des-deploiements" icon="History"}
Qui a changé quoi, quand, avec l'image avant et après.
:::
:::card{title="Purge automatique" href="/v1.0/builds-et-deploiements/gerer-le-registre" icon="Trash2"}
Gardez les N derniers builds par branche, sans jamais perdre une image en service.
:::
:::card{title="Mode Boost" href="/v1.0/builds-et-deploiements/lancer-un-build" icon="Zap"}
Plus de CPU et de mémoire pour les builds lourds.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Services" href="/v1.0/services" icon="Container"}
Définissez ce que chaque build construit et où il tourne.
:::
:::card{title="Applications et environnements" href="/v1.0/applications" icon="AppWindow"}
Choisissez la branche suivie par chaque environnement.
:::
:::card{title="Supervision et logs" href="/v1.0/supervision" icon="LineChart"}
Vérifiez le comportement d'une nouvelle version.
:::
::::

## Ressources

- [Référence des builds et déploiements](/v1.0/builds-et-deploiements/reference)
- [Résoudre les problèmes de build et de déploiement](/v1.0/builds-et-deploiements/depannage)
- [Liste de contrôle de livraison](/v1.0/builds-et-deploiements/liste-de-controle)
- [Limites et quotas](/v1.0/limites)
