# 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.

Pour un build, la carte **Erreur** et les **Logs du build** de sa page donnent presque toujours la cause : voir [Suivre un build](/v1.0/builds-et-deploiements/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](/v1.0/services/depannage).

## Symptômes

- [GitHub App is not installed on repo](#github-app-is-not-installed-on-repo)
- [Le clone échoue sur la branche ou le commit](#le-clone-échoue-sur-la-branche-ou-le-commit)
- [Le Dockerfile est introuvable](#le-dockerfile-est-introuvable)
- [Une étape du Dockerfile échoue](#une-étape-du-dockerfile-échoue)
- [Build timed out: no workflow found](#build-timed-out-no-workflow-found)
- [Quota du registre atteint](#quota-du-registre-atteint)
- [La liste des branches ne se charge pas](#la-liste-des-branches-ne-se-charge-pas)
- [Aucun build après un push](#aucun-build-après-un-push)
- [Aucun déploiement après un build réussi](#aucun-déploiement-après-un-build-réussi)
- [Aucun build disponible au déploiement](#aucun-build-disponible-au-déploiement)
- [L'image est introuvable au démarrage](#limage-est-introuvable-au-démarrage)
- [Le déploiement reste En cours](#le-déploiement-reste-en-cours)
- [Le dépôt géré reste en attente](#le-dépôt-géré-reste-en-attente)
- [Le build ne peut pas être supprimé](#le-build-ne-peut-pas-être-supprimé)

## 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é](/v1.0/builds-et-deploiements/connecter-un-depot#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](/v1.0/services/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](/v1.0/builds-et-deploiements/gerer-le-registre).

## 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](#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](/v1.0/builds-et-deploiements/deployer-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](/v1.0/builds-et-deploiements/revenir-a-une-version-precedente).

## 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.
