Cómo nombrar contenedores

como-nombrar-contenedores-docker
como-nombrar-contenedores-docker

Al crear un contenedor, Docker puede asignarle un nombre aleatorio. Con –name puedes elegir uno reconocible y usarlo en órdenes como logs, inspect, stop o exec, en lugar de copiar un ID largo.

El nombre identifica al contenedor dentro del motor Docker y del contexto activo. No cambia la imagen ni el contenido del contenedor, y no es lo mismo que un nombre de servicio de Compose o un alias de red.

👉 Y recuerda, si quieres aprender más de Linux, visita el curso de Linux gratis.

🐳 Si quieres aprender más de Docker, visita el curso de Docker gratis.

Sintaxis para nombrar un contenedor

Puedes asignar el nombre al crear un contenedor con docker run. En este ejemplo, el nombre será web-demo y la imagen que se ejecutará es Nginx:

docker run -d --name web-demo -p 8080:80 nginx:stable-alpine

La opción -d ejecuta el contenedor en segundo plano; -p publica el puerto 80 del contenedor en el puerto 8080 del equipo. El nombre web-demo es una elección del ejemplo: usa uno que describa el propósito real del servicio.

Qué significa el nombre y cómo elegirlo

IdentificadorQué representaEjemplo
Nombre del contenedorAlias legible para manejar una instancia concreta en el motor Docker actual.web-demo
ID del contenedorIdentificador generado por Docker para esa instancia.Se puede consultar con docker ps.
Nombre de imagenPlantilla usada para crear contenedores. Puede incluir repositorio y tag.nginx:stable-alpine
Servicio de ComposeNombre lógico de un servicio dentro del proyecto Compose.web
Alias de redNombre por el que otros contenedores pueden resolver un destino en una red compatible.web en una red bridge personalizada

Elige nombres breves y consistentes, por ejemplo app-entorno-función: web-dev, api-test o worker-prod. No incluyas contraseñas, tokens ni datos personales. En equipos con varios Docker contexts, recuerda que el mismo nombre puede existir en motores distintos.

Consultar y usar el nombre del contenedor

Lista contenedores activos y detenidos para confirmar el nombre y el estado. La opción -a incluye también los que ya terminaron:

docker ps -a

Después puedes usar el nombre como argumento de otros comandos. Estas órdenes muestran el contenedor, consultan sus logs y lo detienen de forma ordenada:

docker container inspect web-demo
docker logs --tail 20 web-demo
docker stop web-demo

El filtro name de docker ps puede encontrar coincidencias parciales. Si necesitas confirmar que existe exactamente un contenedor llamado web-demo, usa docker container inspect web-demo o revisa cuidadosamente el resultado de la lista.

Cambiar el nombre de un contenedor existente

Si el contenedor ya existe, puedes cambiar su nombre con docker container rename. El nuevo nombre debe estar libre en el motor Docker activo:

docker container rename web-demo web-lab
docker container inspect web-lab

Renombrar no crea un contenedor nuevo ni cambia su imagen, ID, puertos o datos. Si el destino ya tiene ese nombre, Docker rechazará el cambio; lista primero los contenedores y decide cuál debe conservar cada nombre.

Nombres de contenedor y Docker Compose

Docker Compose administra servicios y crea nombres de contenedor a partir del proyecto y del servicio. En general, deja que Compose gestione esos nombres: fijar container_name en el archivo Compose puede impedir escalar un servicio a varias instancias porque un nombre fijo no puede repetirse.

En una red bridge definida por el usuario, los contenedores pueden descubrirse por nombre o alias de red. En la bridge predeterminada, la resolución automática por nombre no funciona igual. Por eso, no asumas que un nombre usado localmente por Docker será resoluble desde cualquier red.

Errores comunes al asignar nombres

  • El nombre ya está en uso: puede pertenecer a un contenedor detenido. Identifícalo con docker ps -a antes de renombrar o eliminar nada.
  • Se confunde el nombre con la imagen: –name identifica el contenedor; nginx:stable-alpine identifica la imagen.
  • Se espera que renombrar cambie el servicio: la orden solo cambia el alias local del contenedor, no modifica el proceso ni su configuración de red.
  • Se fuerza container_name en Compose: un nombre fijo limita la posibilidad de escalar el servicio.
  • Se interpreta el nombre como DNS universal: la resolución depende de la red Docker a la que están conectados los contenedores.

Lecciones relacionadas del curso Docker

Documentación oficial

Consulta la referencia de Docker para docker run, docker container rename y container_name en Compose.

Comentarios

No hay comentarios aún. ¿Por qué no comienzas el debate?

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *