Introducing Attribute by DoiT - Runtime, Token-Level AI Attribution.
PerfectScalePerfectScale
Demander une démoConnexion

PerfectScale

CreateContainerConfigError vs CreateContainerError : le guide K8s

CreateContainerConfigError vs CreateContainerError dans Kubernetes : les causes de chaque erreur, comment les diagnostiquer avec kubectl et comment les corriger.

Cette page est également disponible en English, Deutsch, Español, Italiano, 日本語 et Português.

Tania Duggal
By Tania DuggalMay 26, 202410 min read

TLDR : Ces deux erreurs surviennent avant même le démarrage de votre conteneur : il n'y a donc aucun log applicatif à consulter, uniquement les événements Kubernetes et la description des pods. CreateContainerConfigError signifie que Kubernetes n'a pas pu assembler la configuration du conteneur (le plus souvent un ConfigMap ou un Secret manquant). CreateContainerError signifie que la configuration était correcte, mais que le runtime de conteneurs (containerd, Docker) n'a pas réussi à créer concrètement le conteneur (image invalide, contraintes de ressources, montages de volumes incorrects ou problème de runtime). Pour corriger : créez le ConfigMap/Secret manquant, vérifiez l'image et l'entrypoint, et comparez les ressources demandées à celles réellement disponibles.

Les messages d'erreur CreateContainerConfigError et CreateContainerError jouent un rôle essentiel dans la supervision et le dépannage. Ces erreurs fournissent des informations précieuses sur les problèmes de configuration des conteneurs et contribuent à des déploiements sans accroc. Voyons donc ce que signifient CreateContainerConfigError et CreateContainerError, pourquoi elles surviennent dans Kubernetes et comment les résoudre. La principale différence entre les deux tient au moment où elles se produisent dans le cycle de vie du déploiement d'un Pod.

CreateContainerConfigError signifie que Kubernetes ne parvient pas à assembler les données de configuration requises, comme des variables ou des fichiers de configuration manquants, avant de lancer le conteneur. CreateContainerError signifie que la configuration est prête, mais que le moteur d'exécution de conteneurs sous-jacent, comme containerd ou Docker, n'a pas réussi à créer physiquement le conteneur sur le nœud hôte. Comme ces deux erreurs surviennent avant le démarrage du conteneur, aucun log applicatif n'est généré à l'intérieur du conteneur, dans un cas comme dans l'autre.

Voici quelques-unes des principales erreurs Kubernetes, avec des conseils rapides pour les diagnostiquer.

Dans cet article :

Qu'est-ce que CreateContainerConfigError ?

CreateContainerConfigError est une erreur qui survient lors de la création du conteneur, parce que la configuration est incorrecte ou qu'un élément manque dans la configuration du conteneur du Pod. Kubernetes est alors incapable de produire la configuration nécessaire au conteneur.

Logigramme CreateContainerConfigError : Kubernetes vérifie la configuration du conteneur du pod ; si elle est correcte, il génère la configuration du conteneur et celui-ci est créé avec succès ; sinon, Kubernetes déclenche une erreur CreateContainerConfigError

Logigramme CreateContainerConfigError

Au démarrage d'un nouveau conteneur, Kubernetes s'appuie sur la méthode generateContainerConfig pour lire les données de configuration du conteneur ou les métadonnées du pod. Cela inclut les commandes de démarrage, les références aux ConfigMaps et aux Secrets, ainsi que les définitions de ressources de stockage. En conditions normales, Kubernetes localise ces ressources définies dans la configuration et y connecte le conteneur. S'il ne parvient pas à les trouver, il déclenche un événement CreateContainerConfigError.

Causes générales de CreateContainerConfigError dans Kubernetes

CreateContainerConfigError survient souvent lorsque Kubernetes ne trouve pas des ressources essentielles à la configuration d'un conteneur, généralement des ConfigMaps ou des secrets.

ConfigMaps manquants

Un ConfigMap est un objet API servant à stocker des données de configuration accessibles aux conteneurs qui s'exécutent au sein des pods. Il permet de découpler les détails de configuration des images de conteneurs, pour plus de flexibilité et une gestion simplifiée des paramètres.

Voyons comment définir un ConfigMap, puis le référencer dans la configuration d'un Pod.

apiVersion: v1
kind: ConfigMap
metadata:
  name: my-configmap
data:
  config.json: |
    {
        "key": "value"
    }

Configuration du Pod référençant le ConfigMap :

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
spec:
  containers:
  - name: my-container
    image: <image-name>
    volumeMounts:
    - name: config-volume
      mountPath: /etc/config
  volumes:
  - name: config-volume
    configMap:
      name: my-configmap

À la création d'un Pod, vous devez référencer le ConfigMap dans sa configuration. Si ce ConfigMap existe, le Pod peut y accéder. Sinon, vous rencontrerez l'erreur CreateContainerConfigError.

Secrets manquants

Dans Kubernetes, les Secrets permettent de stocker de manière sécurisée des informations sensibles utilisées par les applications qui s'exécutent dans un cluster.

Prenons maintenant un exemple où un Pod est configuré pour utiliser un Secret afin de stocker des informations sensibles.

apiVersion: v1
kind: Secret
metadata:
  name: my-secret
type: Opaque
data:
  password: cGFzc3dvcmQ=  # Base64 encoded value of 'password'

Configuration du Pod référençant le Secret :

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
spec:
  containers:
  - name: my-container
    image: <image-name>
    env:
    - name: DATABASE_PASSWORD
      valueFrom:
        secretKeyRef:
          name: my-secret
          key: password

Vous obtenez la même erreur si vous configurez un conteneur pour utiliser des secrets qui n'existent pas.

Veillez donc à créer les ConfigMaps et les secrets avant de lancer le pod et de les référencer dans sa configuration.

Diagnostiquer CreateContainerConfigError

Pour diagnostiquer CreateContainerConfigError, commencez par consulter les logs et les événements pertinents afin de confirmer qu'il s'agit bien d'une erreur due à une configuration incorrecte ou à un élément manquant.

Voici les étapes à suivre pour identifier l'origine de l'erreur :

  1. Consultez le Pod et ses logs : Utilisez la commande kubectl logs pour vérifier les logs du Pod concerné. Recherchez les messages indiquant une CreateContainerConfigError.
   ~ kubectl get pods
     NAME    READY    STATUS                       RESTARTS     AGE
     my-pod   0/2     CreateContainerConfigError   1 (10s ago)  28s
  1. Vérifiez les événements avec kubectl : Exécutez la commande kubectl get events pour identifier les événements liés à CreateContainerConfigError. Recherchez ceux qui mentionnent explicitement cette erreur.
   ~ kubectl get events
  1. Inspectez les Pods en détail : Utilisez la commande kubectl describe pod pod-name pour inspecter la configuration du Pod. Vous y verrez les éventuelles ressources manquantes ou mal configurées.
   ~ kubectl describe pod my-pod
     Warning  Failed   56s (x6 over 1m45s)
     kubelet   Error: configmap "my-configmap" not found
  1. Vérifiez les permissions et les paramètres de namespace : Si toutes les ressources sont correctement configurées mais que l'erreur CreateContainerConfigError persiste, vérifiez les permissions et les paramètres de namespace. Assurez-vous que les ressources sont accessibles au pod et se trouvent dans le même namespace.

Corriger CreateContainerConfigError

Pour résoudre CreateContainerConfigError, suivez ces bonnes pratiques :

  1. Créez les ConfigMaps et Secrets manquants : Si un ConfigMap ou un Secret référencé est manquant, créez-le avec la commande kubectl create appropriée. Assurez-vous que la ressource est créée dans le même namespace que le pod.
   ~ kubectl create configmap my-configmap
     kubectl create secret generic my-secret

  1. Configurez correctement les permissions : Vérifiez que les permissions des ressources sont bien définies et permettent au pod d'y accéder. Ajustez-les si nécessaire.

  2. Revérifiez la configuration des ressources : Passez en revue la configuration du pod et assurez-vous que toutes les références aux ConfigMaps et aux Secrets sont exactes et correctement orthographiées. Évitez les fautes de frappe qui pourraient conduire le pod à chercher les ressources au mauvais endroit.

Qu'est-ce que CreateContainerError ?

CreateContainerError est une erreur qui survient lorsque Kubernetes échoue à créer un conteneur au sein d'un pod. Elle indique un échec dans le processus de conteneurisation : le problème concerne la création du conteneur elle-même.

Diagramme de séquence d'une erreur de création de conteneur Kubernetes : le client demande la création du conteneur à l'API Kubernetes, qui demande au runtime de conteneurs d'initialiser le conteneur ; le runtime échoue à créer le conteneur, et l'API Kubernetes renvoie une erreur CreateContainerError au client.

CreateContainerError

Causes générales de CreateContainerError dans Kubernetes

Les problèmes suivants sont généralement à l'origine des événements CreateContainerError :

  1. Problèmes d'image : L'une des causes les plus fréquentes est un problème lié à l'image du conteneur. Il peut s'agir d'une image invalide ou inexistante, ou de l'absence d'entrypoint par défaut sans qu'un entrypoint manuel soit spécifié dans la configuration de l'application.

  2. Contraintes de ressources : Des ressources insuffisantes, en CPU ou en mémoire, peuvent provoquer une CreateContainerError. Si les ressources demandées dépassent la capacité disponible, le processus de création du conteneur échoue.

  3. Montages de volumes incorrects : Si les montages de volumes du conteneur sont mal configurés ou référencent des ressources de stockage inexistantes, la création du conteneur peut échouer. Cela peut se produire lorsque les volumes de stockage ou les persistent volume claims (PVC) spécifiés n'existent pas ou ne sont pas accessibles.

  4. Problèmes de runtime de conteneurs : Les runtimes de conteneurs sont chargés de gérer et d'exécuter les conteneurs au sein d'un cluster Kubernetes. Si le runtime est défaillant ou manque de ressources pour fonctionner normalement, cela peut entraîner des comportements inattendus et des erreurs comme CreateContainerError.

Diagnostiquer CreateContainerError

Les étapes de diagnostic sont très proches de celles de CreateContainerConfigError ; passons-les en revue :

  1. Vérifiez l'état du Pod et ses logs : Avec la commande kubectl get pods, consultez l'état des Pods disponibles ; si votre Pod a échoué à cause d'une CreateContainerError, vous verrez CreateContainerError dans la colonne STATUS de la sortie.

  2. Inspectez les Pods en détail : Utilisez kubectl describe pod pod-name pour inspecter le pod et obtenir des informations détaillées sur un Pod spécifique.

  3. Vérifiez les événements avec kubectl : Exécutez la commande kubectl get events pour identifier les événements liés à CreateContainerError. Recherchez ceux qui mentionnent explicitement cette erreur.

  4. Vérifiez les manifestes du Pod : Assurez-vous que la configuration de votre Pod est correcte, que le Pod peut accéder au volume si vous le référencez dans la configuration, et vérifiez également que l'image du conteneur est valide et inclut un entrypoint correctement défini.

Corriger CreateContainerError

La correction de CreateContainerError dépend de la cause du problème :

  1. Entrypoint manquant : Vous pouvez résoudre ce problème en sélectionnant la bonne image ou en définissant manuellement l'entrypoint dans la configuration de l'application.

  2. Problèmes de stockage : Assurez-vous que votre Pod peut accéder aux volumes configurés et que sa configuration les référence correctement.

  3. Problème de runtime de conteneurs : Vérifiez que le runtime est à jour et compatible avec les composants système sous-jacents. Par ailleurs, allouer suffisamment de ressources au runtime et surveiller ses performances aide à prévenir les erreurs qui lui sont liées. Une maintenance régulière, des mises à jour et un dépannage suivi permettent de résoudre les problèmes de runtime et de garantir le bon fonctionnement des conteneurs dans Kubernetes.

Faire face à CreateContainerConfigError et CreateContainerError dans Kubernetes peut s'avérer délicat, mais comprendre leurs causes et savoir les diagnostiquer efficacement améliore considérablement vos processus de gestion et de déploiement de conteneurs. En suivant les étapes et bonnes pratiques décrites ici, vous pouvez limiter ces erreurs et garantir un environnement Kubernetes plus stable et plus efficace.

Dépannez les erreurs Kubernetes 10 fois plus vite avec PerfectScale by DoiT

La plateforme de gouvernance Kubernetes PerfectScale surveille en continu le comportement des workloads et détecte les signes d'instabilité, comme les événements OOM ou le throttling CPU, qui mènent souvent à des crash loops.

Identifiez jusqu'à 30 types de risques liés à la résilience

PerfectScale suit jusqu'à 30 alertes K8s conçues spécifiquement pour Kubernetes. Elles couvrent un large éventail de problèmes potentiels, comme les échecs de pods ou l'épuisement des ressources, sans exiger d'expertise Kubernetes approfondie.

Identifiez jusqu'à 30 types de risques liés à la résilience avec PerfectScale

Des alertes en temps réel, sans surcharge d'alertes

PerfectScale permet de configurer facilement des alertes pour vos clusters et de les gérer efficacement grâce aux Alert Profiles. Vous pouvez aisément surveiller les alertes pertinentes pour votre environnement et en être notifié.

Pour être informé encore plus vite, utilisez les profils d'intégration Slack ou MS Teams afin de recevoir des notifications dès qu'une alerte est générée.

Des recommandations concrètes pour éliminer les erreurs CreateContainerConfigError dans Kubernetes

En s'appuyant sur des données d'usage réelles et des politiques tenant compte de la résilience, PerfectScale fournit des recommandations précises de right-sizing des workloads au niveau du conteneur, garantissant que les workloads disposent exactement de ce dont ils ont besoin. Qu'elles soient appliquées manuellement ou de façon autonome pour un impact immédiat, ces recommandations rétablissent la stabilité des workloads, éliminent les redémarrages récurrents et aident à prévenir des défaillances similaires à l'avenir.

Pour appliquer les recommandations, il vous suffit de copier le .yaml et de le déployer dans votre cluster.

Des recommandations concrètes pour éliminer les erreurs CreateContainerConfigError dans Kubernetes

Rejoignez des leaders du secteur comme Paramount Pictures et Creditas, qui ont déjà optimisé leurs environnements Kubernetes avec PerfectScale. Inscrivez-vous ou réservez une démo avec nos experts techniques dès maintenant !

FAQ

Quelle est la différence entre CreateContainerConfigError et CreateContainerError ? CreateContainerConfigError survient plus tôt : Kubernetes ne peut pas assembler la configuration du conteneur, généralement parce qu'un ConfigMap ou un Secret référencé est manquant. CreateContainerError survient une fois la configuration prête, lorsque le runtime de conteneurs échoue lui-même à créer le conteneur (image invalide, limites de ressources, montages de volumes incorrects ou problème de runtime).

Pourquoi n'y a-t-il aucun log applicatif pour ces erreurs ? Ces deux erreurs surviennent avant le démarrage effectif du conteneur : l'application qu'il contient ne s'exécute jamais et ne produit donc aucun log. Il faut s'appuyer sur kubectl describe pod et kubectl get events à la place.

Comment corriger une CreateContainerConfigError causée par un ConfigMap ou un Secret manquant ? Créez la ressource manquante dans le même namespace que le pod, par exemple kubectl create configmap my-configmap ou kubectl create secret generic my-secret, puis vérifiez que la spécification du pod référence le bon nom et le bon namespace.

Quelles sont les causes habituelles de CreateContainerError ? Le plus souvent : une image de conteneur invalide ou manquante, l'absence d'entrypoint défini, des ressources CPU/mémoire insuffisantes pour satisfaire les demandes du pod, des montages de volumes mal configurés, ou un problème du runtime de conteneurs lui-même (containerd, Docker).

Quelle est la première commande à exécuter face à l'une de ces erreurs ? kubectl get pods pour confirmer l'erreur dans la colonne STATUS, puis kubectl describe pod <pod-name> pour voir le message d'événement précis (par exemple "configmap not found"), puis kubectl get events pour obtenir davantage de contexte.

PerfectScale peut-il aider à prévenir ces erreurs ? Oui. PerfectScale surveille le comportement des workloads pour détecter les signes d'instabilité (comme les événements OOM ou le throttling CPU) et fournit des recommandations de right-sizing au niveau du conteneur, afin d'identifier et de prévenir les défaillances de configuration et d'exécution liées aux ressources avant qu'elles ne se reproduisent.