Docker – Guía Rápida 25-05-2021

Mini guía: primeros pasos

1/23
Docker – Guía Rápida 25-05-2021

Bienvenido/a a este pequeño tutorial enfocado al manejo de

contenedores y todo lo relacionado a la virtualización.
Antes de arrancar e instalar lo que necesitamos, es fundamental
entender algunas cuestiones básicas.

Un resumen rápido:

• ¿Qué es y para qué sirve Docker?

“Docker es una herramienta que permite empaquetar una

aplicación y sus dependencias en un contenedor muy
ligero. Es como si tomaras una app completa con
absolutamente todo lo que necesita para funcionar, de
modo que se pueda transportar sin problema a cualquier
otro servidor con Docker instalado, ya sea para seguir
desarrollándola o para hacer deploy. Esto significa que
podremos trabajar en un entorno Windows, Linux o Mac,
con tener previamente configurada dicha tecnología.
Docker, a diferencia de las máquinas virtuales, trabaja con
contenedores para que nuestros proyectos puedan
ejecutarse de manera abstracta compartiendo el kernel
del Sistema Operativo. Es decir, cada contenedor opera
como un proceso aislado dentro del entorno del usuario y
a su vez ocupan una cantidad reducida de espacio. En
base a esto último, es clave saber que Docker no es una
máquina virtual (VM). Recordar que las máquinas
virtuales, a diferencia de los contenedores, toman
recursos del S.O para poder arrancar y virtualizar el
funcionamiento de la parte del hardware. Conllevando a
que en algunos casos, podría ocurrir que el tiempo de
carga al iniciar la o las VMS sea significativamente
superior.
En definitiva, Docker se desacopla de algunas capas, y
corre las apps con los ficheros que ellas necesitan.”

2/23
Docker – Guía Rápida 25-05-2021

Con el siguiente gráfico se deja más claro lo que se mencionó

antes. Las aplicaciones interaccionan de forma directa con
Docker, y éste al mismo tiempo con el S.O.

Por último, dos cosas. La primera es que hay que tener en

cuenta que Docker no es necesario para todos nuestros
trabajos; por un lado, va a añadirle una capa más de
complejidad que previamente debe ser considerada según el
proyecto que vayamos a encarar. Por el otro, es una
herramienta que debería utilizarse para solucionar un problema
que existe o es probable que llegue a encontrarse.
La segunda cuestión, es que hay dos versiones: la versión
Docker EE (Enterprise Edition), de pago y con funciones
adicionales para sacarle el máximo provecho. Y su contraparte,
Docker CE (Community Edition), de código abierto. Aclaro que
con esta última vamos a trabajar, señalando que es una
genialidad.

Ahora si, ¡vamos con todo!

3/23
Docker – Guía Rápida 25-05-2021

Instalación en Linux:

Perdón a todas aquellas personas amantes de Windows y Mac,

pero me voy a enfocar en distribuciones Linux basadas en
Ubuntu, ya que actualmente estoy trabajando con Mint. Si
necesitan información de cómo instalar Docker en dichos
sistemas, al final de este documento encontrarán enlaces
relacionados.(1)

Bien. Asumiendo que tenés conocimientos básicos del manejo

de la consola, los siguientes comandos te permitirán instalarlo
en tu equipo. Si no sabés iniciar la terminal, podes hacerlo
tecleando Ctrl+Alt+T o dirigiéndote hacia el ícono que se
encuentra en el panel.

Comandos para distribuciones basadas en Ubuntu: (2)

• sudo apt-get update

• sudo apt-get -y install apt-transport-https ca-
certificates curl software-properties-common
• curl -fsSL
https://download.docker.com/linux/ubuntu/gpg |
sudo apt-key add -
• sudo add-apt-repository "deb [arch=amd64]
https://download.docker.com/linux/ubuntu $(.
/etc/os-release; echo "$UBUNTU_CODENAME")
stable"
• sudo apt-get update
• sudo apt-get -y install docker-ce
• sudo docker –version

(1) Puede llegar a fallar o andar mal si un contenedor Linux corre en un servidor Windows. Lo
aconsejable es que opere en un mismo server.
(2) Si no tenés instalado curl, basta con hacer un sudo apt update & sudo apt
upgrade, seguido de sudo apt install curl y por último curl –version.

4/23
Docker – Guía Rápida 25-05-2021

Una vez ya instalado, vamos a dirigirnos hacia el directorio

Documentos/Documents y creamos un directorio para nuestro
proyecto. El mismo, lo vamos a hacer con NodeJS+Express.
Algo sencillo... ¡a no preocuparse!

Seguí los siguientes pasos:

• Abrir la consola y ejecutar ls (para listar).

• Ingresamos a Documentos con el comando cd

Documentos.

• Una vez estando ahí, ponemos mkdir proyecto_node.

Este comando va a crear un directorio el cual se va a
llamar “proyecto_node”. Posteriormente, ingresamos a él
con cd.

• Ahora es momento de hacer nuestro pequeño programa

para luego dockerizarlo. Podes utilizar tu editor de código
favorito, en mi caso voy a usar VIM. Para empezar a
codear, simplemente poné <editor> server.js. Por
ejemplo: atom server.js o si preferís y usas VSC, tan solo
pones code . y creas un fichero ahí mismo con ese
nombre.

5/23
Docker – Guía Rápida 25-05-2021

• Genial. Ahora que ya estamos listos para editar. Vamos a

plasmar lo básico y necesario.

Explicación nivel Speedy Gonzalez:

• Importamos el módulo de Express, el cual posteriormente

instalaremos. Configuramos el Router y la forma con la
que queremos trabajar, en este caso con el método json()
para reconocer el objeto de la solicitud entrante como un
objeto JSON. Valga la redundancia. Luego creamos una
ruta tipo GET para obtener un simple mensaje. Paso
siguiente, con app.use le indicamos al router cómo deben
definirse las rutas. En este caso le especifiqué /docker.
Adicional, si la URL ingresada no corresponde, mostrará el
mensaje por default de error.
Por último, creamos una constante “puerto” con una
variable de entorno asignada (esto por si se despliega en
un server que automáticamente le asigna un puerto para
iniciar). En este caso, va a correr en el 3000. Luego se
encapsuló dicha variable (configuración dinámica) para
finalmente indicarle a la constante “server” dónde tiene
que lanzarse. Por consola podrás visualizar los siguientes
mensajes: si todo está ok o si todo no está ok. ;)

6/23
Docker – Guía Rápida 25-05-2021

• Guardamos los cambios y volvemos a la consola.

Ejecutamos el siguiente comando: npm init -y(3)

• Ejecutamos ls y vemos que se nos generó un

package.json. Lo editamos y le añadimos dos cosas nada
más: type y engines. Guardamos los cambios.

(3) si no tenés instalado Node ni el gestor NPM, basta con que lo descargues con los siguientes
comandos: curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash -, luego
sudo apt-get install -y nodejs

7/23
Docker – Guía Rápida 25-05-2021

• Perfecto. Ya casi terminando con esta parte, instalamos

Express con npm i express. Quedando en la interfaz lo
siguiente:

• ¡LISTO! Ponemos npm start ó node server.js y podemos

ir a nuestro Browser (Chrome/Firefox/etc) ó API Client para
ver en acción nuestra mini app.

8/23
Docker – Guía Rápida 25-05-2021

Terminada la primer parte, ya podemos ir avanzando con el

tema principal de este documento.
Como bien mencioné al principio, Docker trabaja con
contenedores. Para hacerlo, corre un contenedor a partir de
una imagen la cual generalmente está compuesta por un
Sistema Operativo (puede ser alguna Distro), Software (como
PHP, paquetes Apache, librerías, extensiones, etc) y el código
de la aplicación.
Para generar una imagen se utiliza un fichero llamado
Dockerfile. Éste archivo tiene una serie de instrucciones que
indican cómo va a estar compuesta esa imagen. Una vez que
hayamos creado el Dockerfile, lo único que tenemos que hacer
es ejecutar dos comandos más:

docker build y docker run

9/23
Docker – Guía Rápida 25-05-2021

Las ventajas de trabajar con esta tecnología, es que alguien

puede crear una imagen y nosotros descargarla para añadirle
nuestro código. Al mismo tiempo, terceros puede hacer
exactamente lo mismo.

Sin más que añadir por el momento, haremos nuestro primer

Dockerfile para el proyecto que levantamos antes.

• Volvemos a la consola donde está corriendo Node y

cancelamos su ejecución con Ctrl+c (usá el comando
clear para limpiar la interfaz).
• Y con el editor, en la raíz del proyecto (donde estamos
ubicados) creamos el fichero: Dockerfile.

• Una vez que estemos dentro del fichero, vamos a escribir

y analizar la siguiente estructura:

FROM: Siempre al crear una imagen se empieza con un FROM

el cual va a indicar la tecnología que vamos a utilizar para
nuestro proyecto y su correspondiente versión (tag). Una
buena práctica es la de indicar la versión que vamos a utilizar,
porque cuando, ya sea que bajemos el trabajo de alguien más
u otras personas bajen el nuestro, Docker desde su plataforma

10/23
Docker – Guía Rápida 25-05-2021

principal va a descargarnos por default la versión más reciente.

Acá indiqué Node en la versión 14.17.0-alpine (4).
WORKDIR: En resumidas palabras, estamos señalando que se
debe crear un directorio dentro de nuestro proyecto llamado
app donde se podrán ejecutar comandos.
COPY . .: Bien. Este tema puede ser para rato, pero acá se
decidió copiar todos los directorios y ficheros de la raíz del
proyecto, dentro de app.
RUN: Específicamente con el comando yarn install –production
indica que se deben instalar las dependencias Javascript
necesarias para que nuestra applicación pueda ejecutarse.
CMD: Cuando ejecutamos nuestro server, recordarás que
señalé que podes hacer npm start o node server.js. Bueno,
con CMD se indica cómo debe iniciar la aplicación.

• Guardamos los cambios y a continuación ponemos lo

siguiente: sudo docker build -t proyecto_node .
Debería quedar así (ignorá lo que está con color rojo):

(4) Alpine es una de las distros Linux más ligeras que existen. No tiene sentido instalar una
distribución, por ej Debian para un proyecto tan pequeño como este.

11/23
Docker – Guía Rápida 25-05-2021

• Por último, para ver en funcionamiento todo, alcanza con

ejecutar el siguiente cmd y abrir el navegador: sudo
docker run -p 3000:3000 proyecto_node

• ¡Muy bien! Primera tu primera app corriendo con

Docker :D

Hay que aclarar algo: se puede ejecutar de múltiples maneras.

Lo anterior significa que el contenedor va a correr en el puerto
3000 que apunta al puerto 3000 del proyecto Node. Si vos
necesitas que se ejecute en el puerto 4000, solo tendrías que
especificar: 4000:3000. También se puede especificar una
variable de entorno, pero eso es para otro momento.

Habrás notado que la consola quedó bloqueada. Para evitar

esto haremos:

• Cancelar con Ctrl+C, escribimos el mismo comando que

utilizamos pero cambiamos el argumento -p por -dp (-d =
detach). El resultado sería…

Y… ¿ahora? Bueno, básicamente podes entrar de nuevo al

navegador y observar que el mensaje JSON sigue apareciendo.
Pero para ver los procesos que están siendo ejecutados ya no
son visibles como antes.

12/23
Docker – Guía Rápida 25-05-2021

• Ponemos lo siguiente: sudo docker ps

• Si queremos detener ese contenedor tenemos que escribir

el cmd especificando el ID: sudo docker stop 8f08fa715c50

• En el caso de que necesitemos ver las imágenes que

hemos creado o tenemos en nuestro ordenador, ponemos:
sudo docker images

Acá tenemos cinco títulos bien descriptivos. El primero detalla

el nombre del repositorio, el segundo la versión actual del
proyecto (último porque no especificamos nada aún), el ID de
la imagen, el tiempo que lleva creado y por último el tamaño
de dicha imagen.

Último antes de adentrarnos a otras cosas:

• si por alguna razón querés borrar la imagen que

creaste/descargaste, pones: sudo docker rmi -f
proyecto_node y se terminó todo!

• Al hacer docker images notarás que ya no figura más ;)

13/23
Docker – Guía Rápida 25-05-2021

Repaso:

(1) Descargamos Docker.

(2) Descargamos y desarrollamos un nuevo proyecto
NodeJS+Express.
(3) Creamos un Dockerfile con sus correspondientes
instrucciones.
(4) Hicimos building para posteriormente correr la app en los
puertos que le indicamos.
(5) Vimos cómo hacer que el proceso no sea bloqueante con
detach.
(6) Analizamos los procesos en el background.
(7) Listamos las imágenes que tenemos creadas hasta el
momento.
(8) Borramos la imagen.

Espero que no estés así aún para hacer todo de nuevo…

pd: Para la persistencia de datos, trabajar de forma

bidireccional y hacer push, o sea, enviar nuestros proyectos a
la nube para que alguien más lo descargue, lo dejo pendiente
para un próximo tutorial.

14/23
Docker – Guía Rápida 25-05-2021

Docker Hub:

Como para darle un cierre al tema y te pongas a jugar con los

comandos, vamos a ver de manera superficial la plataforma
oficial de Docker, la cual permite subir y descargar imágenes a
lo loco. Te recomiendo de antemano que vayas haciendo una
cuenta ahí mismo para seguir indagando más al respecto.

Link: https://hub.docker.com/search?q=&type=image

Ya estando allí, como podrás observar, hay imágenes del

software que se te ocurra. Podes encontrar distribuciones
Linux, Bases de Datos, entornos de desarrollo configurados
para usarse a la primera, herramientas de trabajo, frameworks,
librerías, y un sin fin de cosas más. Vamos a ver cómo
descargar una DB e interactuar con ella.

15/23
Docker – Guía Rápida 25-05-2021

• Ponemos en el buscador postgres o simplemente

scrolleamos y ahí mismo aparece.
• Accedemos haciendo clic y veremos lo siguiente:

• Para descargar la imagen, simplemente copiamos el

comando que nos figura allí en nuestra consola y
esperamos un poquito: sudo docker pull postgres

16/23
Docker – Guía Rápida 25-05-2021

• Comprobamos la imagen que hemos descargado:

• Observación: si intentas hacer docker run te saldrá un

mensaje de error. ¡No te preocupes!

• Basta con leer y darse cuenta cuál es el herror. ;) Más allá

de la broma de mal gusto, basta con poner: sudo docker
run -e POSTGRES_PASSWORD=password postgres

Recordar: para evitar la consola bloqueada, usar -d.

17/23
Docker – Guía Rápida 25-05-2021

• Podemos observar con el comando docker ps que nuestra

base ya está disponible para ser utilizada.

Y… ¿cómo se supone que voy a interactuar con la base, si está

en background y no sale más nada? Sencillo:

• Utilizamos docker exec para para ejecutar comandos

dentro de un contenedor activo. Debemos especificar el
container id: sudo docker exec -it 80fd40d3663b sh

Los argumentos utilizados significan:

-i: Interactivo.
-t: Emular la terminal.
sh: Shell.

Otro ejemplo, podría ser con MariaDB!

18/23
Docker – Guía Rápida 25-05-2021

• Ejecutamos sudo docker pull mariadb

• Para correr el contenedor de sudo docker run --name

mariadbtest -e MYSQL_ROOT_PASSWORD=password
-d mariadb

• Recordá hacer sudo docker ps para comprobar que esté

todo bien y obtener el ID del container! Ahora vamos a
ingresar con docker exec: sudo docker exec -it
1c21d39c0f86 bash

• Bien. Tenemos que saber cuál es la IP que Docker le asigna

al contenedor. Para ello ponemos docker inspect
1c21d39c0f86 | grep IPAddress

19/23
Docker – Guía Rápida 25-05-2021

• Con esa información, ejecutamos mysql -u root -p -h

172.17.0.2

¡LISTO!

Casi terminando, algunos detalles más:

1. Cuando hacemos docker run de una imagen que no está

en nuestro equipo, Docker lo que hará es descargar una
imagen de la nube, instalarla y luego ejecutarla. Esa es
una diferencia sutil entre hacer docker pull (descargar) y
docker run (descargar y ejecutar) en este caso específico.
2. Se puede utilizar el comando docker start <container_id>
para también arrancar un container y docker stop para
detenerlo.
3. Un comando muy útil, cuando tenemos en nuestro
ordenador muchísimas imágenes y tenemos que filtrar. Ya
sea por nombre o tags: sudo docker images | grep
alpine

20/23
Docker – Guía Rápida 25-05-2021

4. Para cambiar la versión de nuestro proyecto, mientras

hacemos docker build indicamos el tag correspondiente.
Por ej: sudo docker build proyecto_node:v1.0 .

5. Para ver información de los contenedores, se puede

utilizar el comando docker logs <contenedor_id>. Si
necesito que sea en tiempo real uso -f. Por ejemplo, con
postgres:

Ahora si, ya hemos concluido con este primer encuentro con

Docker. Espero honestamente que te sea de utilidad y que
puedas seguir investigando más al respecto, para sacarle todo
el provecho a esta fantástica herramienta.
A continuación repasamos lo visto hace unos instantes y ya
queda en vos el resto!

21/23
Docker – Guía Rápida 25-05-2021

Repaso:

(1) Ingresamos a Docker Hub para ver imágenes disponibles.

(2) Descargamos Postgres y lo configuramos.
(3) Echamos un vistazo al disparar un comando.
(4) Vimos su proceso en background.
(5) Averiguamos información sobre el contenedor mientras se
ejecutaba.
(6) Descargamos MariaDB e hicimos las configuraciones
necesarias.
(7) Ingresamos a la base de datos.

Comandos + adicionales:

sudo docker create crea un contenedor pero no lo comienza.

sudo docker rename permite renombrar al contenedor.
sudo docker run crea y comienza un contenedor en una operación.
sudo docker rm borra un contenedor.
sudo docker update actualiza los recursos limitados de un contenedor.
sudo docker start comienza un contenedor si se cayó o salió.
sudo docker stop detiene un contenedor.
sudo docker restart detiene y comienza un contenedor.
sudo docker pause pausa un contenedor corriendo, "lo congela".
sudo docker unpause quita la pausa de un contenedor corriendo.
sudo docker wait bloquea hasta que un contenedor corriendo se detiene.
sudo docker kill envía una SIGKILL a un contenedor corriendo.
sudo docker attach se conecta a un contenedor corriendo.
sudo docker history muestra el historial de una imagen.
sudo docker tag taggea una imagen a un nombre asignado.
sudo docker images muestra todas las imágenes.
sudo docker import crea una imagen de un tarball.
sudo docker build crea imagen de un Dockerfile.
sudo docker commit crea imagen de un contenedor, pausándolo temporalmente si esta corriendo.
sudo docker rmi remueve una imagen.
sudo docker load carga una imagen de un archivo tar como STDIN, incluyendo imagenes y tags.
sudo docker save salva una imagen a un archivo tar a STDOUT con todas las capas padre, tags y
versiones.
sudo docker ps muestra los contenedores corriendo.
sudo docker logs obtiene logs de un container.
sudo docker inspect observa toda la info en un contenedor.
sudo docker events obtiene eventos de un contenedor.
sudo docker port muestra el puerto publico de un contenedor.
sudo docker top muestra los procesos corriendo en un contenedor.
sudo docker stats muestra las estadísticas de recursos usados por contenedor.
sudo docker diff muestra los archivos cambiados en el FS del contenedor.

22/23
Docker – Guía Rápida 25-05-2021

sudo docker ps -a muestra todos los contenedores corriendo y detenidos.

sudo docker stats --all muestra una lista de los contenedores corriendo.

Links:
https://hub.docker.com/
https://www.docker.com/
https://docs.docker.com/engine/install/debian/
https://www.ibm.com/cloud/learn/docker
https://cloudacademy.com/blog/docker-vs-virtual-machines-differences-you-should-know/
https://www.cyberciti.biz/faq/how-to-install-curl-command-on-a-ubuntu-linux/
https://github.com/nodesource/distributions/blob/master/README.md
https://linuxhint.com/arch-linux-docker-tutorial/
https://wiki.archlinux.org/title/docker
https://kifarunix.com/install-and-run-mariadb-as-a-docker-container/
https://stackoverflow.com/questions/63262613/docker-postgres-database-is-uninitialized-and-
superuser-password-is-not-specif
https://dev.to/neon_affogato/que-es-docker-y-para-que-sirve-explicacion-5h2n
https://cerebro-digital.com/panel/knowledgebase/63/Comandos-frecuentes-de-Docker.html
https://docs.docker.com/docker-for-windows/install/
https://docs.docker.com/docker-for-mac/install/
https://es.wikipedia.org/wiki/Docker_(software)

Contacto:
LinkedIn: Martyn C.
Telegram: @MartynCastagno

Martin Castagnolo – San Carlos de Bariloche, Río Negro.

23/23