Aller au contenu

Résoudre les problèmes de build et de déploiement

Build qui échoue, image introuvable, build automatique qui ne part pas, déploiement bloqué : causes et corrections, avec les messages réels.

DépannageDéveloppeur
Voir en Markdown

Pour un build, la carte Erreur et les Logs du build de sa page donnent presque toujours la cause : voir Suivre un build. Pour un service qui ne démarre pas après un déploiement, voir aussi Résoudre les problèmes de services.

Symptômes

GitHub App is not installed on repo

Logs du build : ERROR: GitHub App is not installed on repo exemple-org/wk-monapp, suivi de Please install the GitHub App on the repository's organization.

Cause : le dépôt est importé et l'application GitHub de Wakastart n'y a pas accès.

Solution : voir Donner accès à un dépôt importé, puis relancez le build.

Le clone échoue sur la branche ou le commit

Logs du build : Cloning branch: … suivi d'une erreur Git comme Remote branch … not found, ou Checking out specific commit: … suivi d'un échec de git fetch.

Cause : la branche ou le tag n'existe pas, ou plus, sur GitHub ; ou le commit n'appartient pas au dépôt du service.

Solution : vérifiez la source sur GitHub, puis relancez le build en la choisissant dans la liste.

Le Dockerfile est introuvable

Logs du build : après Clone completed successfully, une erreur indiquant que le Dockerfile n'existe pas dans le contexte.

Cause : le Dockerfile est cherché dans <répertoire racine>/<contexte de build>/<Dockerfile> du service, et ce chemin n'existe pas.

Solution : la liste ls -la /workspace/src affichée juste après le clone montre la racine du dépôt. Corrigez Répertoire racine, Contexte de build ou Dockerfile dans la fiche du service : voir Modifier un service.

Une étape du Dockerfile échoue

Logs du build : la sortie d'une instruction RUN en erreur, par exemple un échec d'installation de dépendances ou de compilation.

Cause : une erreur dans votre code ou votre Dockerfile. Le build se fait sans cache et sans accès à vos variables d'environnement d'exécution.

Solution :

  1. Reproduisez le build sur votre poste avec docker build --no-cache -f <Dockerfile> <contexte>.
  2. Corrigez, poussez, relancez le build.
  3. Si le build manque de mémoire (processus tué pendant une compilation), relancez-le avec Mode Boost coché.

Build timed out: no workflow found

Carte Erreur : Build timed out: no workflow found.

Cause : le build n'a pas pu démarrer dans les 30 minutes.

Solution : relancez le build. Si l'erreur se répète, contactez le support avec l'identifiant du build affiché dans Build #….

Quota du registre atteint

Message au lancement : « 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. ».

Cause : la place occupée par les images atteint le quota fixé pour votre application. Les builds automatiques ne partent pas non plus.

Solution : activez la purge automatique ou supprimez des builds anciens, puis attendez le nettoyage hebdomadaire du dimanche. Pour un relèvement, contactez Wakastart. Voir Gérer le registre d'images.

La liste des branches ne se charge pas

Dans Nouveau build, un message d'erreur remplace la liste et un champ libre apparaît.

Cause : le dépôt n'est pas encore Provisionné, GitHub ne répond pas, ou la plateforme n'a pas accès au dépôt importé.

Solution : saisissez le nom de la branche à la main. Si le build échoue ensuite au clone, voir GitHub App is not installed on repo.

Aucun build après un push

Cause : une des conditions du build automatique n'est pas remplie.

Solution : vérifiez dans l'ordre :

  1. l'environnement suit exactement la branche poussée, avec le type Branche et Build automatique coché (badge Build auto) ;
  2. le service est déployé dans cet environnement ;
  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 ;
  5. le quota du registre n'est pas atteint.

Aucun déploiement après un build réussi

Cause : le déploiement automatique ne concerne que les builds lancés depuis une branche, vers les environnements qui suivent cette même branche avec Auto-deploy on new build coché. Il est aussi ignoré si un déploiement plus récent a déjà réussi sur l'instance.

Solution : vérifiez la configuration Git de l'environnement, ou déployez l'image à la main : voir Déployer une image.

Aucun build disponible au déploiement

Message : « Aucun build disponible » dans Déployer une image, ou « Aucun build disponible pour ce service. Lancez un build depuis l'onglet Builds avant de déployer. ».

Cause : aucun build du service n'a réussi, ou les builds réussis ont été supprimés.

Solution : lancez un build et attendez son succès.

L'image est introuvable au démarrage

Message de santé du service : pod …: ImagePullBackOff ou ErrImagePull.

Cause : l'image demandée n'est pas dans le registre. Un service déployé sans avoir jamais reçu d'image cherche le tag latest, qui n'existe pas tant qu'aucun build n'a réussi.

Solution : lancez un build, puis déployez explicitement son image.

Le déploiement reste En cours

Cause : les nouveaux conteneurs ne deviennent pas prêts : erreur au démarrage, sondes de santé en échec, mémoire insuffisante.

Solution : lisez l'état de santé et l'onglet Logs du service, corrigez, puis déployez une image corrigée ou revenez à l'image précédente : voir Revenir à une version précédente.

Le dépôt géré reste en attente

Le dépôt reste En attente ou Provisionnement… plusieurs minutes, ou passe en Échec.

Cause : la création du dépôt sur GitHub n'a pas encore abouti.

Solution : la plateforme réessaie d'elle-même. Si le dépôt reste en Échec, supprimez-le et recréez-le sous un autre nom, ou contactez le support.

Le build ne peut pas être supprimé

Message : Cannot delete build … it is currently deployed on N service instance(s) — … Deploy another build on these instances first., ou menu Supprimer grisé.

Cause : l'image tourne sur au moins une instance, ou le build est encore en cours.

Solution : déployez une autre image sur les instances citées, ou attendez la fin du build.

Toujours bloqué ?

Contactez le support Wakastart avec le nom court de l'application, le service, l'identifiant du build (Build #…) ou le slug de l'environnement, l'heure du problème et le message exact.