User Tools

Site Tools


apuntes:docker

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
apuntes:docker [2017/09/20 01:17] – [Trabajar con Docker] Santiago Faciapuntes:docker [2023/04/14 11:06] (current) – [Eliminar la caché] Santiago Faci
Line 4: Line 4:
  
 ===== ¿Qué es Docker? ===== ===== ¿Qué es Docker? =====
 +
 +Docker es una plataforma para desarrollar, lanzar y ejecutar aplicaciones. Permite separar las aplicaciones desarrolladas de la infraestructura donde se desarrollan y trabajar así más comoda y rapidamente. 
 +
 +Docker permite empaquetar y lanzar una aplicación en un entorno totalmente aislado llamado contenedor. Estos contenedores se ejecutan directamente sobre el kernel de la máquina por lo que son mucho más ligeros que las máquinas virtuales. De esa manera podemos ejecutar mucho más contenedores para el mismo equipo que si éstos fueran maquina virtuales. De esta manera, podemos probar rapidamente uestra aplicación web, por ejemplo, en múltiples entornos distintos al de donde nos encontramos desarrollando. Realmente es mucho más rápido que hacerlo en una máquina virtual, puesto que reduce el tiempo de carga y el espacio requerido por cada uno de estos contenedores o máquinas.
 +
 +Incluso existe un repositorio, el [[http://hub.docker.com|Hub de Docker]], donde podemos encontrar imágenes de máquinas que podemos directamente descargar y ejecutar como contenedores. De esa forma, podemos, con un solo comando, lanzar una máquina con la configuración exacta a la que necesitamos para probar nuestro sitio web, aplicación web o cualquier desarrollo en el que estemos trabajando. 
 +
 +En las siguienes imágenes se compara la arquitectura de Docker y la de un sistema basado en máquinas virtuales. Se puede observar que, al eliminar la necesidad de un Sistema Operativo invitado, los contenedores de Docker son mucho más ligeros. En la práctica, se puede apreciar claramente como la velocidad de creación y arranque de estos contenedores es claramente superior a la de cualquier máquina virtual, sobre todo porque en cada contenedor podremos decidir que capas instalar contando sólo con lo estrictamente necesario.
  
 <figure> <figure>
Line 11: Line 19:
 <caption>Máquina virtual vs Contenedor</caption></figure> <caption>Máquina virtual vs Contenedor</caption></figure>
  
-==== Instalación ====+<figure> 
 +{{ apuntes:arquitectura_docker.png }} 
 +<caption>Arquitectura de Docker</caption></figure> 
 + 
 +===== Instalación =====
  
-[[http://www.docker.com/|Docker]]+Una vez hayamos descargado [[http://www.docker.com|Docker]] para su instalación, podemos ejecutar el siguiente comando para comprobar que todo se ha instalado y funciona correctamente. Básicamente ejecuta un contenedor llamado //hello-world// que se ejecuta sobre nuestra máquina y muestra un mensaje. Si todo sale bien significa que nuestra instalación de Docker funciona sin problemas.
  
 <code bash> <code bash>
Line 27: Line 39:
 . . . . . .
 </code> </code>
 +
 +Si queremos comprobar la versión de Docker podemos hacerlo de la siguiente manera. A veces puede ser útil puesto que se pueden haber añadido nuevas características en las versiones posteriores y podemos necesitar saber en cuál estamos nosotros.
  
 <code bash> <code bash>
Line 33: Line 47:
 </code> </code>
  
-==== Trabajar con Docker ====+===== Imágenes =====
  
-=== Lanzar un contenedor ===+Las imágenes son una serie de capas software que definen la estructura que tendrá el contenedor que se cree a partir de ella.
  
-<code bash> +==== Crear una imagen ====
-santi@zenbook:$ docker run -it debian bash +
-Unable to find image 'debian:latest' locally +
-latest: Pulling from library/debian +
-219d2e45b4af: Pull complete  +
-Digest: sha256:126052225b62db18c32f03a4462a92fad2ef243c6509371edb82. . . +
-Status: Downloaded newer image for debian:latest +
-root@94565ea1af31:/#  +
-</code>+
  
-  santi@zenbook:$ docker run -it -v /ruta/completa/host:/ruta/completa/contenedor debian bash+Normalmente se crean a través de un fichero donde se definen las características que se quieren añadir a dicha imagen, creando un fichero llamado ''Dockerfile'' como el siguiente. En nuestro caso hemos definido que queremos una máquina con soporte para PHP 7.0 y que disponga de un servidor web Apache. Además, se copiará el contenido de nuestra carpeta ''src'' (imaginemos que tenemos alli código PHP que queremos probar) a la carpeta ''/var/www/html'' del contenedor, que es justo la carpeta donde se copia el contenido que queremos que Apache sirva. 
 + 
 +<file vim Dockerfile> 
 +FROM php:7.0-apache 
 +COPY src /var/www/html 
 +</file> 
 + 
 +De esta forma tendremos una carpeta cuyo contenido será el fichero ''Dockerfile'' que acabamos de crear y la carpeta ''src'' con el sitio web que queremos probar
  
 <code bash> <code bash>
-santi@zenbook:docker run -d -v /var/www/unsitioweb:/var/www debian+santi@zenbook:ls 
 +Dockerfile src
 </code> </code>
  
-=== Listar los contenedores en ejecución ===+A continuación, ya podemos crear la imagen, ejecutando el siguiente comando, donde aprovechamos para etiquetarla como ''miapache-php'':
  
 <code bash> <code bash>
-santi@zenbook:$ docker ps +santi@zenbook:$ docker build -t miapache-php . 
-CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES +Sending build context to Docker daemon  3.584kB 
-a859e3fdc573        debian              "bash"              10 seconds ago      Up seconds                            laughing_goldstine+Step 1/2 : FROM php:7.0-apache 
 +7.0-apache: Pulling from library/php 
 +aa18ad1a0d33: Already exists  
 +29d5f85af454: Pull complete  
 +eca642e7826b: Pull complete  
 +3638d91a9039: Pull complete  
 +3646a95ab677: Pull complete  
 +628b8373e193: Pull complete  
 +c24a2b2280ed: Pull complete  
 +f968b84cbbbc: Pull complete  
 +d9ca89480aeb: Pull complete  
 +9d506ea407af: Pull complete  
 +3e07f2e31260: Pull complete  
 +cddaac5f61ab: Pull complete  
 +1d7adb8f245d: Pull complete  
 +Digest: sha256:917ceda30c70ebb682536a1f091f25a8364d61c72c3323. . . 
 +Status: Downloaded newer image for php:7.0-apache 
 + ---> b123b973e3e8 
 +Step 2/2 : COPY src /var/www/html 
 + ---> 8a6954795b9f 
 +Removing intermediate container dc20be7a4288 
 +Successfully built 8a6954795b9f 
 +Successfully tagged miapache-php:latest
 </code> </code>
  
-=== Listar todos los contenedores ===+Ahora sólo nos queda lanzar un contenedor de esa imagen para ponerla en marcha. En este caso mapeamos el puerto 80 de la máquina
  
 <code bash> <code bash>
-santi@zenbook:$ docker ps -a +santi@zenbook:$ docker run -p 5555:80 miapache-php 
-CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS                      PORTS               NAMES +AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 172.17.0.2. Set the 'ServerName' directive globally to suppress this message 
-5248cf319258        debian              "bash"              7 seconds ago       Exited (0seconds ago                        silly_wiles +AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 172.17.0.2. Set the 'ServerName' directive globally to suppress this message 
-78d990ba4591        hello-world         "/hello"            17 seconds ago      Exited (0) 14 seconds ago                       vibrant_mccarthy+[Wed Sep 20 11:25:14.857530 2017] [mpm_prefork:notice] [pid 1] AH00163: Apache/2.4.10 (DebianPHP/7.0.23 configured -- resuming normal operations 
 +[Wed Sep 20 11:25:14.857575 2017] [core:notice] [pid 1] AH00094: Command line: 'apache2 -D FOREGROUND'
 </code> </code>
  
-=== Listar las imágenes locales ===+Podemos ver como ha arracando un servidor web Apache y, por el mapeo de puertos que hemos establecido, podemos visitar la URL ''http://localhost:5555'' para visitar el sitio web. 
 + 
 +==== Listar las imágenes locales ===
 + 
 +Además, es posible comprobar que imágenes tenemos disponibles localmente. Serán las imágenes de las que hayamos creado contenedores en algún momento, independientemente de que éstos todavía existan.
  
 <code bash> <code bash>
 santi@zenbook:$ docker images santi@zenbook:$ docker images
 REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
 +miapache-php        latest              8a6954795b9f        5 minutes ago       390MB
 debian              latest              72ef1cf971d1        6 days ago          100MB debian              latest              72ef1cf971d1        6 days ago          100MB
 hello-world         latest              05a3bd381fc2        7 days ago          1.84kB hello-world         latest              05a3bd381fc2        7 days ago          1.84kB
 </code> </code>
  
-=== Eliminar un contenedor ===+==== Eliminar una imagen ====
  
-<code bash> +Si no necesitamos una imagen, y ésta no tiene contenedores creados, podemos eliminarla del sistema.
-santi@zenbook:$ docker rm 78d990ba4591 +
-78d990ba4591 +
-</code> +
- +
-=== Eliminar una imagen ===+
  
 <code bash> <code bash>
Line 96: Line 133:
 </code> </code>
  
-=== Lanzar un contenedor con Apache ===+===== Contenedores ===== 
 + 
 +==== Lanzar un contenedor ===
 + 
 +Como ya hemos visto un poco más arriba, el comando ''docker run'' crea y lanza un contenedor a partir de una imagen dada. En el caso anterior utilizabamos una imagen previamente preparada y descargada. A la imagen la habiamos llamado //miapache-php// y podíamos utilizar ese nombre para lanzar un contenedor. Además, al lanzar el contenedor mapeabamos el puerto 80 del contenedor con el puerto 5555 de nuestra máquina. 
 + 
 +<code bash> 
 +santi@zenbook:$ docker run -p 5555:80 miapache-php 
 +</code> 
 + 
 +Ahora veremos como también podemos lanzar contenedores indicando una imagen de la que todavía no disponemos (por ejemplo una imagen de [[https://hub.docker.com|Hub de Docker]] que contiene una máquina debian). Docker se encargará de descargar la imagen y, posteriormente, lanzará el contenedor. Además, al final del comando pasaremos como argumento el comando que queremos que docker ejecute sobre el contenedor en cuanto este inicie. En este caso queremos iniciar una sesión de ''bash''
 + 
 +<code bash> 
 +santi@zenbook:$ docker run -it debian bash 
 +Unable to find image 'debian:latest' locally 
 +latest: Pulling from library/debian 
 +219d2e45b4af: Pull complete  
 +Digest: sha256:126052225b62db18c32f03a4462a92fad2ef243c6509371edb82. . . 
 +Status: Downloaded newer image for debian:latest 
 +root@94565ea1af31:/#  
 +</code> 
 + 
 +Ahora veamos un ejemplo en el que queramos desplegar una página web en un servidor web Apache. Queremos crear un contenedor con un servidor Apache desde el que podamos comprobar que la página funciona correctamente. 
 + 
 +Con el siguiente comando crearemos y lanzaremos un contenedor con las siguientes características: 
 +  * El contenedor tendrá asociado el nombre //miapache// que podrá ser utilizando a partir de su creación para realizar cualquier operación sobre él 
 +  * Se ha mapeado el puerto 80 del contenedor sobre el puerto 5555 de la máquina real. De esa manera, conectándonos al puerto 5555 de nuestro equipo podremos ver que ocurre en el 80 del contenedor, justamente donde estará escuchando el Apache del mismo 
 +  * Hemos mapeado la ruta actual de nuestro equipo con la ruta ''/usr/local/apache2/htdocs'' del contenedor, que es donde Apache va a ir a buscar la web que aloje. Suponemos que el directorio actual de mi máquina tengo el sitio web que quiero testear 
 +  * Indicamos que queremos crear y lanzar un contenedor utilizando la imagen del [[http://hub.docker.com|Hub de Docker]], concretamente con la versión 2.4 
 +  * También hemos indicado con la opción ''-d'' que queremos que la máquina se lance en segundo plano
  
 <code bash> <code bash>
Line 113: Line 179:
 444c11d75d0a1e424c5c24668e62357af74de8b801e75d37c1e014e0423c9a2c 444c11d75d0a1e424c5c24668e62357af74de8b801e75d37c1e014e0423c9a2c
 </code> </code>
 +
 +Una vez lanzado y puesto en marcha podemos ir a la dirección ''http://localhost:5555'' con nuestro navegador y visitar nuestro sitio web funcionando desde el contenedor.
 +
 +Podemos ver cómo está el contenedor en ejecución con el comando ''docker ps'' que, puesto que se ha lanzado en segundo plano, sigue en funcionamiento.
  
 <code bash> <code bash>
Line 119: Line 189:
 444c11d75d0a        httpd:2.4           "httpd-foreground"   21 seconds ago      Up 19 seconds       0.0.0.0:5555->80/tcp   miapache 444c11d75d0a        httpd:2.4           "httpd-foreground"   21 seconds ago      Up 19 seconds       0.0.0.0:5555->80/tcp   miapache
 </code> </code>
 +
 +==== Listar los contenedores en ejecución ====
 +
 +Si dejamos el contenedor en marcha y lanzamos el comando ''docker ps'' desde otra consola podremos ver como el contenedor se encuentra en ejecución.
 +
 +<code bash>
 +santi@zenbook:$ docker ps
 +CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
 +a859e3fdc573        debian              "bash"              10 seconds ago      Up 7 seconds                            laughing_goldstine
 +</code>
 +
 +==== Listar todos los contenedores ====
 +
 +También podemos listar todos los contenedores, estén o no iniciados.
 +
 +<code bash>
 +santi@zenbook:$ docker ps -a
 +CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS                      PORTS               NAMES
 +5248cf319258        debian              "bash"              7 seconds ago       Exited (0) 2 seconds ago                        silly_wiles
 +78d990ba4591        hello-world         "/hello"            17 seconds ago      Exited (0) 14 seconds ago                       vibrant_mccarthy
 +</code>
 +
 +==== Eliminar un contenedor ====
 +
 +Podemos eliminar un contenedor con el comando ''docker rm'' pasando su ''CONTAINER ID'' como argumento. También podríamos haberle asociado un nombre al crearlo para poder referirnos a él. Lo veremos más adelante.
 +
 +<code bash>
 +santi@zenbook:$ docker rm 78d990ba4591
 +78d990ba4591
 +</code>
 +
 +==== Detener un contenedor ====
 +
 +Y ahora podemos detener y/o volver a iniciar el contenedor refiriéndonos a ella a través del nombre asociado.
  
 <code bash> <code bash>
Line 124: Line 228:
 miapache miapache
 </code> </code>
 +
 +==== Iniciar un contenedor ====
 +
 +El contenedor queda ya asociado y simplemente lo tengo que lanzar con el siguiente comando cada vez que lo quiera poner en marcha
  
 <code bash> <code bash>
Line 129: Line 237:
 miapache miapache
 </code> </code>
 +
 +==== Mostrar la información de un contenedor ====
 +
 +También podemos mostrar toda la información sobre un contenedor existente
  
 <code bash> <code bash>
-santi@zenbook:$+santi@zenbook:docker inspect miapache 
 +
 +    { 
 +        "Id": "444c11d75d0a1e424c5c24668e62357af74de8b801e75d37c1e014e0423c9a2c", 
 +        "Created": "2017-09-20T01:15:37.043910145Z", 
 +        "Path": "httpd-foreground", 
 +        "Args": [], 
 +        "State":
 +            "Status": "running", 
 +            "Running": true, 
 +            "Paused": false, 
 +            "Restarting": false, 
 +            "OOMKilled": false, 
 +            "Dead": false, 
 +            "Pid": 9146, 
 +            "ExitCode": 0, 
 +            "Error": "", 
 +            "StartedAt": "2017-09-20T01:17:16.277707412Z", 
 +            "FinishedAt": "2017-09-20T01:16:36.545679645Z" 
 +        }, 
 +        "Image": "sha256:d2327de7e695e105d1f764c5c291c3305cb1b2168960fab9afd2df2e71343532", 
 +        "ResolvConfPath": "/var/lib/docker/containers/444c11d75d0a1e424c5c24668e62357af74de8b801e75d37c1e014e0423c9a2c/resolv.conf", 
 +        "HostnamePath": "/var/lib/docker/containers/444c11d75d0a1e424c5c24668e62357af74de8b801e75d37c1e014e0423c9a2c/hostname", 
 +        "HostsPath": "/var/lib/docker/containers/444c11d75d0a1e424c5c24668e62357af74de8b801e75d37c1e014e0423c9a2c/hosts", 
 +        "LogPath": "/var/lib/docker/containers/444c11d75d0a1e424c5c24668e62357af74de8b801e75d37c1e014e0423c9a2c/444c11d75d0a1e424c5c24668e62357af74de8b801e75d37c1e014e0423c9a2c-json.log", 
 +        "Name": "/miapache", 
 +        "RestartCount": 0, 
 +        "Driver": "devicemapper", 
 +        "MountLabel": "", 
 +        "ProcessLabel": "", 
 +        "AppArmorProfile": "", 
 +        "ExecIDs": null, 
 +        "HostConfig":
 +            "Binds":
 +                "/var/www/unsitioweb:/usr/local/apache2/htdocs" 
 +            ], 
 +            "ContainerIDFile": "", 
 +. . . 
 +. . . 
 +. . .
 </code> </code>
 +
 +Como se puede ver, la información que se muestra, es muy exhaustiva. En ocasiones, si sabemos lo que buscamos, podemos directamente aplicar un filtro para indicar que partes de la configuración queremos que se muestren.
 +
 +En este caso queremos simplemente ver la configuración del contenedor (el que hemos creado anteriormente con nombre //miapache//) en lo que a la red y el montaje de volúmenes se refiere.
  
 <code bash> <code bash>
-santi@zenbook:$+santi@zenbook:docker inspect --format "{{.NetworkSettings.Ports}}{{ .Mounts}}" miapache 
 +map[80/tcp:[{0.0.0.0 5555}]][{bind  /var/www/unsitioweb /usr/local/apache2/htdocs   true }]
 </code> </code>
 +
 +===== Varios =====
 +
 +==== Eliminar la caché ====
 +
 +Eliminará la cache del proceso de construcción de las imágenes. Asi podemos forzar que vuelva a descargar todos los ficheros y realizar todos los pasos como si fuera la primera vez.
 +
 +<code bash>
 +santi@zenbook:$ docker builder prune
 +</code>
 +
 +----
 +
 +(c) 2017 Santiago Faci
apuntes/docker.1505870264.txt.gz · Last modified: 2019/01/04 13:02 (external edit)