# 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](/v1.0/services/consulter-l-etat-d-un-service).

## Symptômes

- [Le service reste en provisionnement](#le-service-reste-en-provisionnement)
- [CrashLoopBackOff : le conteneur redémarre en boucle](#crashloopbackoff--le-conteneur-redémarre-en-boucle)
- [OOMKilled : le conteneur dépasse sa mémoire](#oomkilled--le-conteneur-dépasse-sa-mémoire)
- [ImagePullBackOff : l'image est introuvable](#imagepullbackoff--limage-est-introuvable)
- [CreateContainerConfigError : la configuration est invalide](#createcontainerconfigerror--la-configuration-est-invalide)
- [Le service est Dégradé](#le-service-est-dégradé)
- [Impossible de mettre à jour le service](#impossible-de-mettre-à-jour-le-service)
- [Champs requis manquants à la création](#champs-requis-manquants-à-la-création)
- [Erreur de création du service](#erreur-de-création-du-service)
- [Le bouton Redémarrer n'apparaît pas](#le-bouton-redémarrer-napparaî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** :

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](/v1.0/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é](/v1.0/services/sondes-de-sante).

**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](/v1.0/services/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](/v1.0/builds-et-deploiements/deployer-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](/v1.0/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](/v1.0/builds-et-deploiements/connecter-un-depot).

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