Aller au contenu

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.

GuideDéveloppeur
Accès requis
Droit « Modifier un environnement » ; « Accès infrastructure en production » en plus pour un environnement de production
Durée
5 min
Voir en Markdown

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.

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

Voir aussi