Comment déboguer et résoudre les problèmes de conteneur courants dans Container Station ?

Les conteneurs héritent de tous les attributs de l'image source. Analysez le fichier image pour identifier les vulnérabilités de sécurité, les erreurs de configuration et les menaces de porte dérobée avant le déploiement.

Si le conteneur rencontre des problèmes après le déploiement, analysez les journaux du conteneur pour diagnostiquer et résoudre les problèmes.

Examinez les conditions préalables de l'image et effectuez toutes les étapes requises avant de déployer le conteneur.

Par exemple, déployer un conteneur PostgreSQL à l’aide de l'image postgres nécessite de définir la variable d'environnement POSTGRES_PASSWORD. Le conteneur ne parvient pas à se déployer sans cette variable.

Container Station enregistre toutes les activités des applications et des conteneurs. Les journaux d’échec fournissent des messages d’erreur explicites, notamment le nom de l’application ou du conteneur, le code d’erreur et les détails de l’erreur.

1. Ouvrez Container Station.
2. Cliquez sur Journaux d'événements.
3. Localiser les journaux d’échec.

Exemple 1

Dans cet exemple, le journal des événements a enregistré un échec de démarrage car les ports spécifiés étaient déjà utilisés par d'autres services, empêchant le conteneur de se lier aux interfaces réseau requises.

Exemple 2

Le journal des événements a enregistré un échec de démarrage dans cet exemple en raison d'une commande de point d'entrée mal configurée, ce qui a empêché le conteneur d'exécuter le processus prévu.

Analysez les journaux de conteneurs individuels pour détecter les messages d’erreur et d’avertissement. Container Station enregistre les états d'erreur détaillés, tels que les variables d'environnement manquantes, les formats de nommage non valides, les échecs de récupération d'image et les échecs d'initialisation.

1. Ouvrez Container Station.
2. Cliquez sur Conteneurs.
3. Sélectionnez un conteneur pour ouvrir la page d'autorisation.
4. Cliquez sur Journaux.
5. Examinez les messages d'erreur et d'avertissement.

Exemple 1

Le journal des événements a enregistré un échec de démarrage car la variable d'environnement MYSQL_ROOT_PASSWORD n'a pas été définie avant le déploiement du conteneur MySQL, ce qui a provoqué sa fermeture immédiatement après l'initialisation.

Exemple 2

Le journal des événements a enregistré un échec de démarrage car le conteneur Rancher a été déployé à l'aide d l’image rancher/rancher sans activer le mode privilégié. Sans le drapeau --privileged, le conteneur n'a pas pu s'initialiser correctement.

Assurez-vous que l’image est compatible avec l’architecture du processeur et le système d’exploitation de votre appareil QNAP. Des versions d'image ou des architectures incorrectes empêchent les conteneurs de s'exécuter.

Vérifiez que la plate-forme d’image correspond à l’architecture du processeur de votre appareil QNAP. Si vous transférez une image à partir d’un autre appareil QNAP, vérifiez que les deux appareils utilisent la même architecture.

Docker

La page de l'image Docker fournit une liste des architectures et des systèmes d'exploitation pris en charge pour chaque version d'image. Voici les directives générales de compatibilité pour les images Docker :

• linux/arm/v7 les images prennent en charge les architectures ARM 32 bits.
• linux/arm64/v8 les images prennent en charge les architectures ARM 64 bits.
• linux/amd64 les images prennent en charge les architectures x86 64 bits.

LXD

Pour plus de détails sur la compatibilité, visitez Serveur d'images LXD. Voici les directives générales de compatibilité architecturale pour les conteneurs LXD :

• armhf les conteneurs prennent en charge les architectures ARM 32 bits.
• arm64 les conteneurs prennent en charge les architectures ARM 64 bits.
• amd64 les conteneurs prennent en charge les architectures x86 64 bits.

Les conteneurs Docker incompatibles peuvent enregistrer un exec format error, indiquant une incompatibilité d'architecture.

Lors du déploiement de conteneurs LXD incompatibles, Container Station enregistre les journaux d'échec dans la page Journaux d'événements.

QNAP a mis à jour la taille de la page système de 4K à 32K pour améliorer les performances sur des appareils ARM 32 bits spécifiques. Cette modification peut limiter l’accès du conteneur aux ressources mémoire, provoquant des erreurs de segmentation. Vérifiez la compatibilité des conteneurs tiers avant le déploiement.

Assurez-vous que l'appareil QNAP est correctement configuré pour le déploiement et l'orchestration de conteneurs.

Vérification des paramètres du réseau

1. Connectez-vous à votre appareil QNAP et ouvrez Réseau et commutateur virtuel.
2. Sélectionnez le mode Avancé.
3. Allez dans Réseau > Commutateur virtuel.
4. Identifiez les segments de réseau utilisés par le réseau de conteneurs.
5. Rendez-vous dans Panneau de configuration > Système > Sécurité > Liste des autorisations/refus .
   Remarque

   Si QuFirewall est installé sur votre appareil, assurez-vous qu'il est activé, puis ouvrez QuFirewall et ajoutez les segments de réseau requis à la liste autorisée.
6. Assurez-volus que les segments de réseau du conteneur sont ajoutés à la liste autorisée.
   Important

   QNAP recommande fortement d'ajouter les plages IP suivantes à la liste d'autorisation : 10.0.3.0/24, 10.0.5.0/24, 10.0.7.0/24, 172.29.0.0/22, 172.30.0.0/22. Si les services Kubernetes sont activés, ajoutez également 10.42.0.0/24 (Réseau de pods Kubernetes CIDR).

Vérification des paramètres d'autorisation avancés

1. Allez dans Panneau de configuration > Privilège > Dossiers partagés> Autorisations avancées.
2. Désactivez Activer les autorisations avancées sur les dossiers.
3. Cliquez sur Appliquer.
4. Accédez à Panneau de configuration > Privilège > Quota  et vérifiez les paramètres de quota d'utilisateurs.
   Remarque

   Les paramètres de quota s'appliquent uniquement si la gestion des quotas est activée.
   Avertissement

   Vérifiez les paramètres de quota utilisateur pour vous assurer qu’aucune restriction de quota involontaire n’est en place. Des paramètres de quota accidentels peuvent amener le conteneur à signaler des erreurs en raison de limitations de stockage.

Vérification de la configuration du stockage et du réseau

1. Allez dans Stockage et snapshots > Stockage > Stockage/Snapshots.
2. Vérifiez la capacité de stockage disponible.
   
   
   Remarque

   Si l'état est différent de Prêt, vérifiez l'état du disque pour détecter les erreurs de stockage. Pour plus de détails, voir dans États des disques dans le Guide de l'utilisateur de QTS ou QuTS Hero.

Vérification de la configuration réseau

Assurez-vous que les paramètres réseau sont correctement configurés en suivant ces étapes :

1. Accédez à Réseau et commutateur virtuel > Réseau > Interfaces et vérifiez si les paramètres du DNS et de la passerelle.
2. Assurez-vous que le serveur DHCP peut attribuer des adresses IP aux conteneurs à l’aide d’un commutateur virtuel. Pour plus de détails, voir dans Configuration du commutateur virtuel dans le Guide de l'utilisateur de QTS ou QuTS Hero.
   Remarque

   Le paramètre  Ne pas attribuer d'adresses IP (à des fins spéciales, telles que la construction d'un réseau externe ou d'un réseau isolé) dans la configuration du commutateur virtuel est destiné à des configurations réseau spécifiques. Si vous n’avez pas besoin d’une configuration réseau personnalisée, il est recommandé de désactiver ce paramètre.
   Cependant, si vous configurez un réseau externe ou isolé, activez-le. Sachez que ce paramètre peut affecter la configuration réseau du conteneur. Pour plus de détails, voir Créer un commutateur virtuel en mode avancé dans le guide de l'utilisateur de QTS ou QuTS hero.
3. Accédez à Container Station > Préférences > Paramètres réseau  et assurez-vous que les segments du réseau de conteneurs ne sont pas en conflit avec l'environnement local.
   Important

   Container Station utilise 10.0.3.0/24, 10.0.5.0/24, et 10.0.7.0/24 comme réseaux IP par défaut.

Plusieurs images sont open source, permettant aux utilisateurs de modifier le code source. Si aucune des méthodes de dépannage ne résout le problème, l’image source peut être incompatible ou corrompue. Dans ce cas, QNAP recommande de visiter le site Web de l'image pour plus d'informations ou d'utiliser d'autres images de la même catégorie.

Si l'image provient du registre Docker, vous pouvez trouver plus de détails sur la page de Vue d'ensemble de l'image. Par exemple, l'image ubuntu dans Docker fournit des liens de référence rapides pour plus d'informations.