====== Primeros pasos (Docker avanzado) ======

Contenido perteneciente al curso [[informatica:sistemas_operativos:cursos:docker_avanzado|Docker avanzado]].

===== El comando ''docker'' =====

El comando ''docker'' es nuestra herramienta para interactuar con toda la arquitectura de Docker

La sintaxis es la siguiente:

<code>
docker [option] [command] [arguments]
</code>

Si introducimos únicamente el comando ''docker'' en la terminal nos responderá con la lista de todos los subcomandos de los que dispone:

<code>
docker
</code>

Lo primero que podemos hacer es verificar la versión de Docker que tenemos instalada en nuestro equipo

<code>
docker versión
</code>

O consultar los detalles de la instalación y el host:

<code>
docker info
</code>

==== Hello, world! ====

Y como no, todo empieza con un “Hello World”:

<code>
docker run hello-world
</code>

==== Busybox ====

Busybox es una imagen Docker mínima que nos permite trastear de forma rápida

Para ejecutar un único comando dentro de una imagen podemos usar lo siguiente:

<code>
docker run busybox echo Hola mundo
</code>

Si lo que queremos es abrir una terminal para trastear más en detalle:

<code>
docker run -it busybox sh
</code>

==== Iniciar un ubuntu ====

De igual modo si queremos iniciar un contenedor con Ubuntu es tan sencillo como usar el comando:

<code>
docker run -it ubuntu /bin/bash
</code>

Veremos que se descarga la imagen desde el registro y se inicia el contenedor. Podemos verificar la versión concreta que está montando:

<code>
cat /etc/lsb-reléase
</code>

Si lo preferimos podemos especificar la versión concreta de ubuntu que queremos iniciar:

<code>
docker run –it ubuntu:14.04 /bin/bash
</code>

<WRAP center round info 60%>
Podríamos ejecutar de nuevo docker run y se creará un nuevo contenedor, pero la imagen será la misma.
</WRAP>

===== Práctica: explorando el entorno =====

Inicia un contenedor interactivo de Ubuntu:

<code>
docker run –it ubuntu /bin/bash
</code>

Explora tu entorno:

<code>
hostname
</code>

<code>
cat /etc/hosts
</code>

<code>
ifconfig
</code>

Instala el editor de textos ''vim'':

<code>
apt-get update
apt-get install vim
</code>

Sal del entorno con el comando exit y repite el paso 1. ¿Tenemos el comando ''vim''?

===== Listando contenedores =====

Con el subcomando ''ps'' podemos listar la información de todos los contenedores en ejecución:

<code>
docker ps
</code>

Si incorporamos la opción ''–a'' obtendremos la lista incluyendo los contenedores ya finalizados:

<code>
docker ps -a
</code>

Si solo necesitamos los IDs de los contenedores podemos usar la opción ''-q'':

<code>
docker ps -aq
</code>

===== run, start, attach =====

Podemos especificar un nombre para nuestro contenedor ''[a-zA-Z0-9_.-]''

<code>
docker run --name myUbuntu -it ubuntu /bin/bash
</code>

Podemos reiniciar un contenedor parado anteriormente:

<code>
docker start {ID}
</code>

Por ejemplo:

<code>
docker start myUbuntu
</code>

Para arrancar el contenedor con los parámetros iniciales podemos usar ''attach'':

<code>
docker attach {ID}
</code>

También es posible crear un contenedor e iniciar como un demonio (en segundo plano) con la opción ''-d'':

<code>
docker run --name myDaemon -d ubuntu /bin/sh -c "while true; do echo hello world; sleep 1; done"
</code>

===== Contenedores con nombre personalizado =====

Por defecto, Docker genera un nombre aleatorio para cada contenedor que creemos.

Sin embargo, podemos especificar un nombre para nuestro contenedor con la opción ''%%--%%name'':

<code>
docker run --name myUbuntu -it ubuntu /bin/bash
</code>

Podemos dar cualquier nombre mientras usemos alguno de los siguientes caracteres de acuerdo a la expresión regular: ''[a-zA-Z0-9_.-]''
===== logs, top =====

Para ver lo que está pasando dentro de un contenedor podemos usar el comando ''logs'':

<code>
docker logs <ID_CONTENEDOR>|<NOMBRE_CONTENEDOR>
</code>

<WRAP center round important 60%>
Estos //logs// no se refiere a los logs del sistema operativo sino a la salida por pantalla de los contenedores.  Los logs del contenedor depende de cómo haya sido creada la imagen.
</WRAP>

Podemos abrir el streaming para verlo en tiempo real con la opción ''-f'':

<code>
docker logs -f myDaemon
</code>

Ver los últimos 10 mensajes:

<code>
docker logs –f –-tail 10 myDaemon
</code>

Podemos pedir que incluya la marca temporal (''-t''):

<code>
docker logs -ft myDaemon
</code>

También podemos consultar los procesos en ejecución:

<code>
docker top myDaemon
</code>

===== stop, rm =====

Si se necesita terminar un contenedor de forma externa tenemos el subcomando ''stop'':

<code>
docker stop {ID}
</code>

Si lo que queremos es parar todos los contenedores en ejecución:

<code>
docker stop $(docker ps -q)
</code>

  * ''-q'': muestra solo el identificador del contenedor

Para eliminar los contenedores de forma definitiva:

<code>
docker rm {ID}
</code>

<WRAP center round important 60%>
La opción de borrado es irreversible. Por seguridad, no se pueden eliminar contenedores que no estén parados ni con volúmenes asociados.
</WRAP>


Para eliminar todos los contenedores:

<code>
docker rm $(docker ps -aq)
</code>

  * ''-q'': muestra solo el identificador del contenedor

===== inspect =====

Para obtener más detalle sobre el contenedor tenemos ''inspect'':

<code>
docker inspect {ID}
</code>

Podemos usar ''%%–-%%format'' para obtener detalles concretos:

<code>
docker inspect --format='{{.State.Running}}' myDaemon
</code>

<WRAP center round info 60%>
La sintaxis es [[https://support.smartbear.com/alertsite/docs/monitors/api/endpoint/jsonpath.html|JSONPath]].
</WRAP>


<code>
docker inspect -f='{{.NetworkSettings.IPAddress}}' myDaemon
</code>

Podemos consultar múltiples contenedores indicando sus nombre uno detrás de otro:

<code>
docker inspect --format='{{.Name}} {{.State.Running}}' $(docker ps -aq)
</code>

===== docker pull =====

A diferencia del comando ''run'', ''docker pull'' descarga la imagen y no hace nada más.

<code>
docker pull ubuntu:23.04
</code>
===== docker images =====

Para ver las imágenes que tenemos descargadas:

<code>
docker images
</code>

Ejemplo de salida:

<code>
REPOSITORY                         TAG         IMAGE ID       CREATED         SIZE
ubuntu                             latest      3565a89d9e81   2 weeks ago     77.8MB
lscr.io/linuxserver/kavita         latest      8d78b59f517b   6 weeks ago     388MB
</code>

<WRAP center round important 60%>
El kernel de las imágenes debe ser compatible con el kernel que usa Docker Engine.
</WRAP>

===== Práctica =====

Crear un contenedor con Ubuntu 23.04 y desde otra terminal detenerlo.

<code>
docker run --name paquito -it ubuntu:23.04 /bin/bash
</code>

Para detenerlo:

<code>
docker stop paquito
</code>
===== Recursos =====

  * https://killercoda.com/: diferentes escenarios para trabajar con contenedores.