Cómo usar el comando docker container rename para renombrar un contenedor

Introducción

En este laboratorio, aprenderás a gestionar contenedores de Docker cambiándoles el nombre. Comenzarás creando un contenedor de Docker y asignándole un nombre específico para facilitar su identificación.

Después de la creación, verificarás el nombre del contenedor utilizando comandos de Docker. El núcleo de este laboratorio consiste en usar el comando docker container rename para cambiar el nombre del contenedor, y finalmente, comprobarás que el cambio de nombre se realizó correctamente verificando el nuevo nombre del contenedor.

Skills Graph

Crear un contenedor con un nombre específico

En este paso, aprenderás cómo crear un contenedor de Docker y asignarle un nombre específico. Nombrar contenedores facilita su identificación y gestión.

Primero, descargaremos la imagen hello-world de Docker Hub. Esta es una imagen muy pequeña útil para pruebas.

docker pull hello-world

Deberías ver una salida que indica que la imagen se está descargando.

Ahora, ejecutaremos un contenedor a partir de la imagen hello-world y le asignaremos el nombre my-hello-container. Usamos el comando docker run con la bandera --name para especificar el nombre del contenedor.

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

Al ejecutar este comando, Docker creará e iniciará un nuevo contenedor llamado my-hello-container basado en la imagen hello-world. El contenedor hello-world simplemente imprime un mensaje y luego finaliza.

Después de que el contenedor se ejecute, puedes verificar que fue creado listando todos los contenedores (incluyendo los que han finalizado) usando el comando docker ps -a.

docker ps -a

En la salida, deberías ver un contenedor con el nombre my-hello-container.

Verificar el nombre del contenedor

En el paso anterior, creaste un contenedor de Docker y lo nombraste my-hello-container. En este paso, verificarás explícitamente que el contenedor existe y tiene el nombre correcto usando comandos de Docker.

El comando docker ps se utiliza para listar contenedores. Por defecto, solo muestra los contenedores en ejecución. Como el contenedor hello-world finaliza después de ejecutarse, necesitamos usar la bandera -a para mostrar todos los contenedores, incluyendo los que han finalizado.

Ejecuta el siguiente comando para listar todos los contenedores:

docker ps -a

Observa la salida del comando. Deberías ver una tabla con información sobre tus contenedores. Busca la fila correspondiente al contenedor que acabas de crear. La columna NAMES en esta tabla muestra el nombre del contenedor. Verifica que el nombre sea efectivamente my-hello-container.

Para verificar específicamente la existencia de un contenedor con un nombre particular, puedes combinar docker ps -a con grep.

docker ps -a | grep my-hello-container

Si el contenedor llamado my-hello-container existe, este comando mostrará la línea de docker ps -a que contiene la información del contenedor. Si no existe, grep no encontrará coincidencias y no habrá salida. Esta es una forma común de verificar programáticamente la existencia de un contenedor por su nombre.

Renombrar el contenedor

En los pasos anteriores, creaste y verificaste el nombre de un contenedor Docker. En ocasiones, puede ser necesario cambiar el nombre de un contenedor existente. Docker proporciona el comando docker rename para este propósito.

El comando docker rename recibe dos argumentos: el nombre actual del contenedor y el nuevo nombre que deseas asignarle.

Ahora renombraremos el contenedor actualmente llamado my-hello-container a renamed-hello-container.

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

Si el comando se ejecuta correctamente, finalizará sin mostrar salida alguna. Esto indica que el contenedor ha sido renombrado exitosamente.

Para confirmar el cambio de nombre, puedes listar nuevamente todos los contenedores usando docker ps -a y verificar la columna NAMES.

docker ps -a

Ahora deberías ver renamed-hello-container en la columna NAMES para el contenedor que acabas de renombrar, y my-hello-container ya no debería aparecer.

Verificar el nuevo nombre del contenedor

En el paso anterior, renombraste el contenedor Docker de my-hello-container a renamed-hello-container. En este paso final, realizarás una verificación definitiva para asegurarte de que el contenedor ahora tiene el nuevo nombre y que el nombre anterior ya no está asociado a él.

Utilizaremos nuevamente el comando docker ps -a para listar todos los contenedores y sus detalles.

docker ps -a

Examina cuidadosamente la salida. Deberías ver el contenedor listado con el nombre renamed-hello-container. También es importante confirmar que no haya ningún contenedor listado con el nombre anterior, my-hello-container.

Para verificar específicamente la presencia del nuevo nombre y la ausencia del nombre anterior usando herramientas de línea de comandos, puedes usar grep.

Primero, verifica el nuevo nombre:

docker ps -a | grep renamed-hello-container

Este comando debería devolver resultados si el contenedor fue renombrado exitosamente.

Luego, verifica el nombre anterior. Este comando no debería devolver ningún resultado si el renombrado fue exitoso.

docker ps -a | grep my-hello-container

Al realizar ambas verificaciones, puedes estar seguro de que el contenedor ha sido renombrado correctamente.

Resumen

En este laboratorio, aprendiste a crear un contenedor Docker y asignarle un nombre específico utilizando el comando docker run --name. Luego verificaste la existencia y el nombre del contenedor usando el comando docker ps -a, que lista todos los contenedores, incluyendo aquellos que han finalizado.

Después de la creación y verificación, practicaste el cambio de nombre del contenedor usando el comando docker container rename, modificando su nombre de my-hello-container a uno nuevo. Finalmente, confirmaste el renombrado exitoso utilizando nuevamente docker ps -a para verificar el nombre actualizado del contenedor en la salida.