Comment utiliser la commande docker container rename pour renommer un conteneur

Introduction

Dans ce lab, vous apprendrez à gérer les conteneurs Docker en les renommant. Vous commencerez par créer un conteneur Docker et lui attribuer un nom spécifique pour une identification facile.

Après la création, vous vérifierez le nom du conteneur à l'aide de commandes Docker. Le cœur de ce lab consiste à utiliser la commande docker container rename pour modifier le nom du conteneur, et enfin, vous vérifierez que le renommage a réussi en vérifiant le nouveau nom du conteneur.

Skills Graph

Créer un conteneur avec un nom spécifique

Dans cette étape, vous apprendrez à créer un conteneur Docker et à lui attribuer un nom spécifique. Nommer les conteneurs facilite leur identification et leur gestion.

Commencez par télécharger l'image hello-world depuis Docker Hub. Il s'agit d'une image très légère, utile pour les tests.

docker pull hello-world

Vous devriez voir une sortie indiquant que l'image est en cours de téléchargement.

Maintenant, nous allons exécuter un conteneur à partir de l'image hello-world et lui donner le nom my-hello-container. Nous utilisons la commande docker run avec l'option --name pour spécifier le nom du conteneur.

docker run --name my-hello-container hello-world

Lorsque vous exécutez cette commande, Docker crée et démarre un nouveau conteneur nommé my-hello-container basé sur l'image hello-world. Le conteneur hello-world affiche simplement un message puis se termine.

Après l'exécution du conteneur, vous pouvez vérifier sa création en listant tous les conteneurs (y compris ceux terminés) à l'aide de la commande docker ps -a.

docker ps -a

Dans la sortie, vous devriez voir un conteneur portant le nom my-hello-container.

Vérifier le nom du conteneur

À l'étape précédente, vous avez créé un conteneur Docker nommé my-hello-container. Dans cette étape, vous allez vérifier explicitement que le conteneur existe et qu'il porte bien le nom correct en utilisant des commandes Docker.

La commande docker ps permet de lister les conteneurs. Par défaut, elle n'affiche que les conteneurs en cours d'exécution. Comme le conteneur hello-world s'arrête après son exécution, nous devons utiliser l'option -a pour afficher tous les conteneurs, y compris ceux qui se sont terminés.

Exécutez la commande suivante pour lister tous les conteneurs :

docker ps -a

Examinez le résultat de la commande. Vous devriez voir un tableau avec des informations sur vos conteneurs. Recherchez la ligne correspondant au conteneur que vous venez de créer. La colonne NAMES dans ce tableau indique le nom du conteneur. Vérifiez que le nom est bien my-hello-container.

Pour vérifier spécifiquement l'existence d'un conteneur avec un nom particulier, vous pouvez combiner docker ps -a avec grep.

docker ps -a | grep my-hello-container

Si le conteneur nommé my-hello-container existe, cette commande affichera la ligne de docker ps -a contenant les informations du conteneur. S'il n'existe pas, grep ne trouvera aucune correspondance et il n'y aura aucun résultat. C'est une méthode courante pour vérifier programmatiquement l'existence d'un conteneur par son nom.

Renommer le conteneur

Dans les étapes précédentes, vous avez créé et vérifié le nom d'un conteneur Docker. Parfois, vous pourriez avoir besoin de modifier le nom d'un conteneur existant. Docker fournit la commande docker rename à cet effet.

La commande docker rename prend deux arguments : le nom actuel du conteneur et le nouveau nom que vous souhaitez lui attribuer.

Nous allons maintenant renommer le conteneur actuellement nommé my-hello-container en renamed-hello-container.

docker rename my-hello-container renamed-hello-container

Si la commande réussit, elle se terminera sans afficher de sortie. Cela indique que le conteneur a été renommé avec succès.

Pour confirmer le renommage, vous pouvez à nouveau lister tous les conteneurs en utilisant docker ps -a et vérifier la colonne NAMES.

docker ps -a

Vous devriez maintenant voir renamed-hello-container dans la colonne NAMES pour le conteneur que vous venez de renommer, et my-hello-container ne devrait plus apparaître.

Vérifier le nouveau nom du conteneur

À l'étape précédente, vous avez renommé le conteneur Docker de my-hello-container à renamed-hello-container. Dans cette dernière étape, vous allez effectuer une vérification définitive pour vous assurer que le conteneur porte désormais le nouveau nom et que l'ancien nom ne lui est plus associé.

Nous utiliserons à nouveau la commande docker ps -a pour lister tous les conteneurs et leurs détails.

docker ps -a

Examinez attentivement le résultat. Vous devriez voir le conteneur listé avec le nom renamed-hello-container. Il est également important de confirmer qu'aucun conteneur n'est listé avec l'ancien nom my-hello-container.

Pour vérifier spécifiquement la présence du nouveau nom et l'absence de l'ancien nom en utilisant des outils en ligne de commande, vous pouvez utiliser grep.

D'abord, vérifiez le nouveau nom :

docker ps -a | grep renamed-hello-container

Cette commande devrait retourner un résultat si le conteneur a été correctement renommé.

Ensuite, vérifiez l'ancien nom. Cette commande ne devrait pas retourner de résultat si le renommage a réussi.

docker ps -a | grep my-hello-container

En effectuant ces deux vérifications, vous pouvez être certain que le conteneur a été correctement renommé.

Résumé

Dans ce labo, vous avez appris à créer un conteneur Docker et à lui attribuer un nom spécifique en utilisant la commande docker run --name. Vous avez ensuite vérifié l'existence du conteneur et son nom à l'aide de la commande docker ps -a, qui liste tous les conteneurs, y compris ceux qui ont été arrêtés.

Après la création et la vérification, vous avez pratiqué le renommage du conteneur en utilisant la commande docker container rename, modifiant son nom de my-hello-container vers un nouveau nom. Enfin, vous avez confirmé le succès du renommage en utilisant à nouveau docker ps -a pour vérifier le nom mis à jour du conteneur dans la sortie.