Résoudre les problèmes de services
Un service qui ne démarre pas, redémarre en boucle, reste en provisionnement ou refuse une modification : causes et corrections.
Commencez toujours par la page du service : son état de santé, le message affiché dessous et l'onglet Logs donnent la cause dans la plupart des cas. Voir Consulter l'état d'un service.
Symptômes
- Le service reste en provisionnement
- CrashLoopBackOff : le conteneur redémarre en boucle
- OOMKilled : le conteneur dépasse sa mémoire
- ImagePullBackOff : l'image est introuvable
- CreateContainerConfigError : la configuration est invalide
- Le service est Dégradé
- Impossible de mettre à jour le service
- Champs requis manquants à la création
- Erreur de création du service
- Le bouton Redémarrer n'apparaît pas
Le service reste en provisionnement
Le statut reste Provisionnement…, ou le déploiement reste En cours, plusieurs minutes.
Cause : les nouveaux conteneurs ne deviennent jamais prêts. L'état de santé et son message en donnent la raison : voir les symptômes qui suivent. Sans message d'erreur, le cluster peut manquer de place pour des conteneurs aux ressources très élevées.
Solution :
- Lisez l'état de santé en haut de la page du service et cliquez sur Vérifier maintenant.
- Ouvrez l'onglet Logs pour lire la sortie de votre application.
- Corrigez la cause, puis déployez une image corrigée ou cliquez sur Réconcilier.
- Si vous venez d'augmenter fortement les ressources, revenez à des valeurs plus modestes.
CrashLoopBackOff : le conteneur redémarre en boucle
Message de santé : pod …: CrashLoopBackOff.
Cause : votre application s'arrête juste après son démarrage (variable manquante, base injoignable, erreur de code), ou la sonde de vie échoue sans cesse et la plateforme la redémarre.
Solution :
- Dans l'onglet Logs, cherchez l'erreur juste avant l'arrêt.
- Si une variable manque, vérifiez l'onglet Configuration du service : voir Variables et secrets.
- Si votre application ne répond pas sur
GET /healthou n'écoute pas sur le port déclaré, corrigez l'application ou le port, ou désactivez les sondes : voir Sondes de santé.
Pour vérifier : l'état passe à Sain et le message à N/N pods running.
OOMKilled : le conteneur dépasse sa mémoire
Message de santé : pod …: OOMKilled.
Cause : le conteneur a utilisé plus que sa Memory Limit ; il a été arrêté.
Solution : augmentez Memory Limit de l'instance, par exemple de 512Mi à 1Gi. Voir Dimensionner un service. Si la consommation croît sans fin dans l'onglet Metrics, cherchez une fuite mémoire dans votre code.
ImagePullBackOff : l'image est introuvable
Message de santé : pod …: ImagePullBackOff ou ErrImagePull.
Cause : l'image déployée n'existe pas, ou plus, dans le registre de l'application. Cela arrive si le service a été déployé sans image et qu'aucun build n'a encore réussi, ou si l'image a été purgée.
Solution :
- Vérifiez dans Builds qu'un build du service a réussi ; sinon, lancez-en un.
- Déployez une image récente : voir Déployer une image.
CreateContainerConfigError : la configuration est invalide
Message de santé : pod …: CreateContainerConfigError.
Cause : une variable du service est reliée à un secret ou à une ressource qui n'existe pas encore dans l'environnement, par exemple une base pas encore Prêt.
Solution : attendez que la base ou le bucket soit prêt, vérifiez les liaisons de l'onglet Configuration du service, puis cliquez sur Réconcilier. Voir Variables et secrets.
Le service est Dégradé
Message de santé : 1/2 pods ready, ou ArgoCD application progressing.
Cause : un déploiement est en cours, ou une partie des conteneurs n'est pas prête.
Solution : attendez la fin du déploiement dans l'onglet Déploiements. Si l'état persiste, un des conteneurs échoue : consultez l'onglet Logs.
Impossible de mettre à jour le service
Message : « Impossible de mettre à jour le service » sur la fiche du service, ou « Impossible de mettre à jour les ressources » dans Modifier les ressources.
Cause : un champ a un format refusé.
Solution : vérifiez les ressources.
| Saisie | Problème | Correction |
|---|---|---|
500 | CPU sans unité : 500 cœurs | 500m |
0.5 ou 1 | CPU en cœurs | 500m, 1000m |
3000m | Au-delà de 2000m | 2000m au plus |
512 | Mémoire sans unité : 512 octets | 512Mi |
1G ou 512M | Unité décimale | 1Gi, 512Mi |
16Gi | Au-delà de 8Gi | 8Gi au plus |
La fenêtre Modifier les ressources affiche ces erreurs sous chaque champ, par exemple « Unité manquante : sans unité, « 500 » signifie 500 cœurs entiers — pas 500 millicores. ».
Champs requis manquants à la création
Message : « Champs requis manquants » suivi de la liste, par exemple « Le repository est requis, L'instance Harbor est requise ».
Solution : renseignez les champs cités. Si la liste Repository est vide, connectez d'abord un dépôt : voir Connecter un dépôt Git.
Erreur de création du service
Message : « Erreur de création » suivi du détail.
| Détail | Cause | Correction |
|---|---|---|
contient role must be one of the following values | Le rôle choisi n'est pas accepté | Choisissez Frontend, Backend ou Worker |
contient already exists | Un service de l'application a déjà ce nom court | Choisissez un nom dont les 12 premiers caractères alphanumériques diffèrent |
contient repoUrl | Le dépôt choisi n'a pas encore d'URL | Attendez que le dépôt soit Provisionné |
Le bouton Redémarrer n'apparaît pas
Cause : aucune image n'est déployée sur le service, ou il vous manque le droit Redémarrer un service (et Accès infrastructure en production en production).
Solution : déployez d'abord une image, ou demandez le droit manquant.
Toujours bloqué ?
Contactez le support Wakastart avec le nom court de l'application, le slug de l'environnement, le nom du service, le tag de l'image déployée, le message de santé et l'heure du problème.