Skip to content

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.

TroubleshootingDeveloper

This page has not been translated yet and is shown in French.

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

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 :

  1. Lisez l'état de santé en haut de la page du service et cliquez sur Vérifier maintenant.
  2. Ouvrez l'onglet Logs pour lire la sortie de votre application.
  3. Corrigez la cause, puis déployez une image corrigée ou cliquez sur Réconcilier.
  4. 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 :

  1. Dans l'onglet Logs, cherchez l'erreur juste avant l'arrêt.
  2. Si une variable manque, vérifiez l'onglet Configuration du service : voir Variables et secrets.
  3. Si votre application ne répond pas sur GET /health ou 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 :

  1. Vérifiez dans Builds qu'un build du service a réussi ; sinon, lancez-en un.
  2. 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.

SaisieProblèmeCorrection
500CPU sans unité : 500 cœurs500m
0.5 ou 1CPU en cœurs500m, 1000m
3000mAu-delà de 2000m2000m au plus
512Mémoire sans unité : 512 octets512Mi
1G ou 512MUnité décimale1Gi, 512Mi
16GiAu-delà de 8Gi8Gi 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étailCauseCorrection
contient role must be one of the following valuesLe rôle choisi n'est pas acceptéChoisissez Frontend, Backend ou Worker
contient already existsUn service de l'application a déjà ce nom courtChoisissez un nom dont les 12 premiers caractères alphanumériques diffèrent
contient repoUrlLe dépôt choisi n'a pas encore d'URLAttendez 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.