Mario Rodríguez - Photo

Mario Rodríguez

Temas y Tips sobre Programación y Tecnología


Comandos básicos de Docker: guía práctica para principiantes

4 minutos

Introducción

Cuando empezás a usar Docker (abre en una pestaña nueva) , uno de los primeros retos es recordar qué comando sirve para cada cosa. Descargar una imagen, crear un contenedor, ver si sigue corriendo o eliminarlo parece sencillo, pero la sintaxis se puede mezclar al principio.

Este artículo reúne esos comandos básicos en un solo lugar. No cubre todo lo que Docker puede hacer; es una referencia para empezar a moverte sin sentir que cada operación es un comando nuevo.

¿Qué es Docker?

Docker (abre en una pestaña nueva) permite empaquetar una aplicación con sus dependencias y ejecutarla dentro de un contenedor. Ese contenedor queda aislado del resto del sistema, pero comparte el kernel del host.

La idea práctica es que la aplicación tenga un entorno predecible: si la imagen es la misma, no deberías tener que reconstruir toda la configuración cada vez que la ejecutás en otra máquina.

Comandos esenciales de Docker

Estos son los comandos que más vas a encontrar durante tus primeros pasos:

1. docker —version

Muestra la versión de Docker instalada. Es una forma rápida de comprobar que el comando está disponible.

docker --version
      

2. docker pull

Descarga una imagen desde Docker Hub o desde otro registro configurado. Una imagen contiene el sistema de archivos y la configuración que Docker necesita para crear un contenedor.

docker pull nombre-imagen
# Ejemplo: docker pull nginx
      

3. docker images

Muestra las imágenes que tenés guardadas localmente.

docker images
      

4. docker run

Este es uno de los comandos que más vas a usar: crea e inicia un contenedor a partir de una imagen. Podés agregarle muchas opciones, pero en su forma más simple solo necesita el nombre de la imagen.

docker run nombre-imagen
# Ejemplo: docker run nginx
      

Algunos parámetros útiles:

  • •
    -d: Deja el contenedor corriendo en segundo plano para que podás seguir usando la terminal. Sin esta opción, el proceso queda en primer plano hasta que lo detengás.
  • •
    -p: Conecta un puerto del host con uno del contenedor. La sintaxis es -p <puerto_host>:<puerto_contenedor>.

Si una aplicación como Nginx escucha en el puerto 80 dentro del contenedor, podés conectarlo con el puerto 8080 de tu máquina y entrar desde http://localhost:8080 .

Ejemplo de ejecución en modo de fondo y exponiendo un puerto:

docker run -d -p 8080:80 nginx
      

En este ejemplo:

  • •
    -d: Indica que el contenedor debe ejecutarse en segundo plano.
  • •
    -p 8080:80: Expone el puerto 80 del contenedor en el puerto 8080 del host. Esto permite que cualquier solicitud a http://localhost:8080 se redirija al puerto 80 dentro del contenedor, donde Nginx está escuchando.

5. docker ps

Muestra los contenedores que están corriendo. Para incluir también los detenidos, usá docker ps -a .

docker ps
docker ps -a
      

6. docker stop

Para detener un contenedor, usá docker stop seguido de su ID o nombre.

docker stop <container_id>
      

Podés obtener el <container_id> con docker ps .

7. docker rm

Cuando ya no necesitás un contenedor, podés eliminarlo con este comando. Primero tiene que estar detenido.

docker rm <container_id>
      

Si querés revisar y eliminar todos los contenedores detenidos, Docker tiene un comando específico para eso:

docker container prune
      

8. docker rmi

Este comando elimina una imagen concreta. Te puede servir para liberar espacio o quitar una versión que ya no usás.

docker rmi nombre-imagen
      

Para revisar y eliminar imágenes que ya no estén asociadas a ningún contenedor, podés usar:

docker image prune
      

9. docker build

Construye una imagen a partir de un Dockerfile . La opción -t le asigna un nombre.

docker build -t nombre-imagen .
      

10. docker exec

Ejecuta un comando dentro de un contenedor que ya está corriendo. Por ejemplo, podés abrir una shell para revisar qué está pasando dentro.

docker exec -it <container_id> /bin/bash
      

La opción -it abre una sesión interactiva. Tené en cuenta que algunas imágenes no incluyen Bash; en esos casos podés probar con /bin/sh .

Conclusión

No hace falta memorizar todos estos comandos de una vez. Es normal volver a la lista varias veces; después de crear y romper algunos contenedores, la mayoría empieza a salir de memoria.

Con pull , run , ps , stop y rm ya tenés una base para experimentar. Redes, volúmenes y Docker Compose pueden venir después, cuando estos conceptos dejen de sentirse nuevos.

Comentarios