Inspecter la configuration et l'état d'un conteneur (docker inspect)

Introduction à la commande docker inspect

La commande `docker inspect` est un outil puissant qui permet d’obtenir une vue détaillée de la configuration et de l’état d’un conteneur ou d’une image Docker. Que ce soit pour comprendre la configuration réseau, les volumes associés, les variables d’environnement ou les ressources consommées par un conteneur, `docker inspect` fournit toutes ces informations sous la forme d’un objet JSON structuré et détaillé.

En tant qu'administrateur ou développeur utilisant Docker, il est essentiel de maîtriser cet outil pour diagnostiquer les problèmes, analyser les performances et vérifier les configurations. Par exemple, si un conteneur ne se connecte pas correctement à un réseau ou si une variable d’environnement semble manquante, `docker inspect` peut rapidement identifier ces problèmes.

Dans cette section, nous allons explorer les fonctionnalités de la commande `docker inspect`, examiner les informations qu’elle peut fournir et expliquer comment interpréter ces données pour résoudre des problèmes courants et optimiser vos conteneurs.

Utilisation de la commande docker inspect

### Commande de base pour inspecter un conteneurLa commande de base pour inspecter un conteneur est :```bashdocker inspect ou ```Cette commande renvoie un objet JSON contenant tous les détails relatifs au conteneur spécifié. Par exemple :```bashdocker inspect web_server```Cela affichera des informations telles que l’ID du conteneur, son image d'origine, ses volumes, ses paramètres réseau, ses variables d'environnement, etc.

### Inspection d’une image DockerVous pouvez également utiliser `docker inspect` pour obtenir des informations sur une image Docker :```bashdocker inspect ou ```

### Limiter les informations avec --formatPour extraire des informations spécifiques de l’objet JSON renvoyé, utilisez l’option `--format` avec une syntaxe de modèle Go. Par exemple, pour afficher uniquement l’adresse IP d’un conteneur :```bashdocker inspect --format='{{.NetworkSettings.IPAddress}}' web_server```

### Inspecter un conteneur avec des ID courts ou des noms partielsDocker permet d’utiliser un ID partiel ou un nom partiel tant qu’il est unique. Par exemple :```bashdocker inspect abc123```

Informations clés fournies par docker inspect

### Configuration réseauLa section `NetworkSettings` de la sortie JSON contient des informations sur le réseau auquel le conteneur est connecté, y compris l’adresse IP, les ports exposés et les paramètres de réseau. Par exemple :```json"NetworkSettings": { "IPAddress": "172.17.0.2", "Ports": { "80/tcp": [ { "HostIp": "0.0.0.0", "HostPort": "8080" } ] }}```

### Volumes et points de montageLa section `Mounts` fournit des informations sur les volumes montés dans le conteneur, y compris leur source et leur cible :```json"Mounts": [ { "Type": "volume", "Name": "my_volume", "Source": "/var/lib/docker/volumes/my_volume/_data", "Destination": "/data", "RW": true }]```

### Variables d’environnementLes variables d’environnement définies pour le conteneur sont listées dans la section `Config.Env`. Par exemple :```json"Config": { "Env": [ "ENV_VAR1=value1", "ENV_VAR2=value2" ]}```

### Ressources utiliséesLa section `HostConfig` contient des informations sur les limites de ressources appliquées au conteneur, comme la mémoire et le CPU :```json"HostConfig": { "Memory": 512000000, "CpuShares": 1024}```

Exemples pratiques d’utilisation de docker inspect

### Exemple 1 : Vérifier l’adresse IP d’un conteneurPour obtenir rapidement l’adresse IP d’un conteneur nommé `web_server` :```bashdocker inspect --format='{{.NetworkSettings.IPAddress}}' web_server```

### Exemple 2 : Lister les volumes montés dans un conteneurPour voir les volumes associés à un conteneur :```bashdocker inspect --format='{{json .Mounts}}' web_server```

### Exemple 3 : Vérifier les variables d’environnementPour afficher toutes les variables d’environnement définies :```bashdocker inspect --format='{{json .Config.Env}}' web_server```

### Exemple 4 : Extraire les ressources allouéesPour afficher les limites de mémoire d’un conteneur :```bashdocker inspect --format='{{.HostConfig.Memory}}' web_server```

Meilleures pratiques pour docker inspect

### Utilisez --format pour des requêtes cibléesLa commande `docker inspect` génère une sortie JSON souvent volumineuse. Utilisez l’option `--format` pour extraire uniquement les informations nécessaires et éviter la surcharge visuelle.

### Automatiser les diagnosticsIntégrez `docker inspect` dans des scripts pour automatiser les diagnostics et collecter des données sur plusieurs conteneurs en même temps. Par exemple :```bashfor container in $(docker ps -q); do docker inspect --format='{{.Name}}: {{.State.Status}}' $container echo "---"done```

### Combinez avec d'autres commandesUtilisez `docker inspect` avec d'autres commandes comme `docker logs` ou `docker stats` pour un diagnostic complet des conteneurs. Par exemple, commencez par inspecter la configuration réseau, puis suivez les logs pour détecter des anomalies.

Résolution des problèmes courants avec docker inspect

### Problème : Le conteneur ne démarre pasUtilisez `docker inspect` pour vérifier les variables d’environnement ou les volumes montés qui pourraient causer des problèmes. Par exemple :```bashdocker inspect --format='{{.Config.Env}}' ```

### Problème : Problèmes de réseauSi un conteneur n’est pas accessible, inspectez la configuration réseau pour vérifier les ports exposés et les adresses IP :```bashdocker inspect --format='{{json .NetworkSettings.Ports}}' ```

### Problème : Ressources insuffisantesSi un conteneur montre des performances médiocres, utilisez `docker inspect` pour vérifier les limites de ressources appliquées :```bashdocker inspect --format='{{.HostConfig.Memory}}' ```