Comandos básicos de docker

Estos son algunos de los comandos básicos para comenzar a trabajar con docker

En esta entrada vamos a hacer un repaso de algunos comandos que se utilizan en docker, esto puede valer como apuntes para la operativa normal con los contenedores, como es borrarlos, crearlos, listarlos, ver imágenes, étc…

Borrar contenedor:

docker rm id

Borrar imagen:

docker rmi id

Contenedores en funcionamiento:

docker ps -a

Para contenedor:

docker stop id

Construir dockerfile:

docker build -t example/nginx:latest [location]

Crear contenedor:

docker run -d -p 8080:80 –name [images_name]

Ver imagenes:

docker images

Contenedor interactivo:

docker run -i -t –name debian debian /bin/bash

Logueo en docker hub:

docker login

Push y pull de imagen:

docker push|pull [image]

Hacemos una imagen a nueva a partir de un contenedor ya en funcionamiento:

docker commit [container_name] [new_name]:[tag]

Ejecutar comando en un contenedor:

docker exec -ti [container] [command]

Reiniciar contendor:

docker restart [container]

Mostrar procesos dentro de un contenedor:

docker top [container] [ps options]

Volúmenes docker:

Crear:

docker volume create [name]

Listar:

docker volume ls

Borrar los que no estén en uso:

docker volume prune

Borrar:

docker volume rm [name]

Uso masivo:

Estos comandos los ha sugerido @EvaristoGZ para el eliminado y parado de contenedores de forma rápida:

docker stop $(docker ps -aq)

docker rm $(docker ps -aq)

Esta entrada está relacionada con la instalación de Docker y además vendrá una entrada posterior con los parámetros que se pueden utilizar dentro de un Dockerfile para la construcción de imágenes.

Construir una imagen:

docker build –build-arg -t <nombre_imagen> .

Construir una imagen detrás de un proxy:

docker build –build-arg http_proxy=http://<proxy>:<port> –build-arg https_proxy=http://<proxy>:<port> -t <nombre_imagen> .

Hacer pull de una imagen ya construida:

docker pull nginx:1.13-alpine

Añadir un TAG a una imagen:

docker tag <nombre_imagen> <nombre_imagen>:<tag>

Inspeccionar una imagen:

docker inspect <nombre_imagen>

Guardar imagen en un fichero TAR:

docker save <nombre_imagen> > <fichero>.tar

Eliminar imagen:

docker rmi <nombre_imagen>:<TAG>

Eliminar todas las imágenes:

docker rmi `docker images -q`

Ejecutar contenedor:

docker run -v <unidad_host>:<unidad_docker> -it –name <nombre_contenedor> -d <nombre_imagen>

Eliminar contenedor:

docker rm <nombre_contenedor>

Eliminar todos los contenedores parados:

docker rm `docker ps -a -q`

Lista de imágenes:

docker images

Ver contenido de una imagen:

docker run -it image_name sh

Lista contenedores en ejecución:

docker ps -a

Conectar a un contenedor en ejecución:

docker exec -i -t a9ddb677957f /bin/bash

Build Docker-Compose:

docker-compose build

Up Docker-Compose:

docker-compose up

Up Docker-Compose segundo plano:

docker-compose up -d

Ver salida de Docker-Compose:

docker-compose logs -f -t

Detener un Docker-Compose:

docker-compose down

Detener un Docker-Compose y eliminar volúmenes:

docker-compose down -v

Ver Docker-Compose en ejecución:

docker-compose ps

Eliminar Docker-Compose detenidos:

docker-compose rm

Listado de todas las máquinas virtuales de VirtualBox donde tenemos docker

1

2

3

$ docker-machine ls

NAME      ACTIVE   DRIVER       STATE     URL                         SWARM

default   *        virtualbox   Running   tcp://192.168.99.100:2376

IP de una de las máquinas virtuales de VirtualBox donde tenemos docker

1

2

$ docker-machine ip default

192.168.99.100

Crear un contenedor docker con una imagen de nginx

1

2

$ docker run -dP nginx

23d0bc5a0f529d3d79e44cfdf0d1c01e32ab4fdd09e4113fa5fdab2a11d7a81b

Donde,

  • -d, la imagen se ejecutará como daemon
  • -P, mapeo automático de puertos entre el contenedor ejecutando la imagen y docker host (recordemos en windows el docker host es una máquina virtual de VirtualBox y en Linux es nuestra propia máquina)

Listado de los contenedores ejecutando algún proceso

1

2

3

$ docker ps

CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                                           NAMES

23d0bc5a0f52        nginx               “nginx -g ‘daemon off”   10 seconds ago      Up 8 seconds        0.0.0.0:32771->80/tcp, 0.0.0.0:32770->443/tcp   big_aryabhata

Listado de los mapeos de puertos de todos los contenedores

Es el mismo comando anterior.

1

2

3

$ docker ps

CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                                           NAMES

29409f8390b7        nginx               “nginx -g ‘daemon off”   6 seconds ago       Up 6 seconds        0.0.0.0:32769->80/tcp, 0.0.0.0:32768->443/tcp   tiny_noyce

Listado de los mapeos de puertos de un contenedor

Mapeo de todos los puertos

1

2

3

$ docker port 29409f8390b7

443/tcp -> 0.0.0.0:32768

80/tcp -> 0.0.0.0:32769

Mapeo de un puerto

1

2

$ docker port 29409f8390b7 443

0.0.0.0:32768

Listado de los procesos que se están ejecutando en un contenedor de docker

1

2

3

4

$ docker top 23d0bc5a0f52

PID                 USER                COMMAND

28802               root                nginx: master process nginx -g daemon off;

28809               104                 nginx: worker process

Salida estándar de uno de los contenedores de docker

Arrancamos un contenedor de docker a partir de la última imagen nginx y queremos ver los logs de la salida estandar de nginx en la consola. Lo mismo que hariamos con el comando tail -f.

1

2

3

4

5

6

$ docker ps

CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                                           NAMES

23d0bc5a0f52        nginx               “nginx -g ‘daemon off”   10 seconds ago      Up 8 seconds        0.0.0.0:32771->80/tcp, 0.0.0.0:32770->443/tcp   big_aryabhata

 

$ docker logs -f 23d0bc5a0f52

192.168.99.1 – – [04/Dec/2015:10:39:31 +0000] “GET /favicon.ico HTTP/1.1” 404 168 “-” “Mozilla/5.0 (Windows NT 6.1; WOW64; rv:42.0) Gecko/20100101 Firefox/42.0” “-“

Obtener información detallada de un contenedor en ejecución

La información es devuelta en formato JSON. Esta información nos devuelve todos los detalles del contenedor, como el ID, la IP donde se encuentra disponible, la MAC address, el hostname, etc

1 $ docker inspect 23d0bc5a0f52

Y si queremos filtrar solo algún tipo de información, lo podemos hacer utilizando una pantilla del lenguaje go.

1 $ docker inspect -f “Host name: {{.Config.Hostname}}, Identificador: {{.ID}}” 23d0bc5a0f52

Parar un contenedor

1

2

$ docker stop 23d0bc5a0f52

23d0bc5a0f52

Arrancar un contededor

1

2

$ docker start 23d0bc5a0f52

23d0bc5a0f52

Borrar un contenedor

Una vez hemos terminado de utilizar un contenedor, lo podemos eliminar si ya no nos hace falta. Previamente lo tenemos que parar. Una vez lo hemos borrado, dejaremos de tenerlo en la lista de contenedores.

1

2

$ docker rm 23d0bc5a0f52

$ docker ps -a

Listado de las imágenes descargadas localmente

Todas esta las imágenes las hemos descargado desde Docker Hub.

1

2

3

4

5

6

$ docker images

REPOSITORY          TAG                 IMAGE ID            CREATED             VIRTUAL SIZE

nginx               latest              198a73cfd686        2 weeks ago         132.8 MB

ubuntu              14.04               e9ae3c220b23        3 weeks ago         187.9 MB

ubuntu              latest              e9ae3c220b23        3 weeks ago         187.9 MB

hello-world         latest              0a6ba66e537a        7 weeks ago         960 B

Descargar de una imagen

Cada vez que ejecutamos una imagen que no tenemos, la imagen se descarga y se crea el contenedor donde se ejecuta esa imagen. Pero en ocasiones queremos tener ya la imagen descargada para no tener que esperar a su descarga, en ese caso lo hacemos con docker pull.

1 $ docker pull elasticsearch:2.1.0

Y una vez la tenemos descargada podemos en cualquier momento crear el contenedor para esa imagen y ejecutarlo. En este caso vamos a ejecutar un contenedor de elasticsearch y verificar su estado.

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

$ docker run -dP elasticsearch:2.1.0

f13efab1bbbe1f09509e72e03ad9627e2649a46c9c94076b9707104f0c130177

 

$ docker port f13efab1bbbe

9200/tcp -> 0.0.0.0:32771

9300/tcp -> 0.0.0.0:32770

 

$ docker-machine ip default

192.168.99.100

 

$ curl http://192.168.99.100:32771/

{

“name” : “Bennet du Paris”,

“cluster_name” : “elasticsearch”,

“version” : {

“number” : “2.1.0”,

“build_hash” : “72cd1f1a3eee09505e036106146dc1949dc5dc87”,

“build_timestamp” : “2015-11-18T22:40:03Z”,

“build_snapshot” : false,

“lucene_version” : “5.3.1”

},

“tagline” : “You Know, for Search”

}

Crear una nueva imagen

Cuando una imagen no se adapta a nuestras necesidades, podemos crear una nueva imagen a partir de esa imagen. Por ejemplo, en la imagen ubuntu:14.04 no tenemos los comandos curlwget, etc. Podemos crear una nueva imagen a partir de la original añadiendo los comandos o herramientas que necesitamos.

Creamos un contenedor a partir de la imagen que vamos a modificar

1

2

$ docker run -it ubuntu:14.04 bash

root@c33a2339ca21:/#

Donde

  • -it, indicamos a docker que deje un terminal abierto (-t) para trabajar de forma interactiva (-i) con el contenedor

Instalamos los comandos o herramientas que necesitamos y salimos del contenedor

1

2

3

root@c33a2339ca21:/# apt-get update

root@c33a2339ca21:/# apt-get install curl wget

root@c33a2339ca21:/# exit

Creamos la nueva imagen

1

2

$ docker commit -m “comandos curl y wget” -a “me” c33a2339ca21 ubuntu14.04/utils:0.0.1

074f77447d43f92aa8006ba97b54a26a187782224392d4a5ea3798dcb860060c

Verificamos la nueva imagen recién creada

1

2

3

4

$ docker images

REPOSITORY          TAG                 IMAGE ID            CREATED             VIRTUAL SIZE

ubuntu14.04/utils   0.0.1               074f77447d43        14 minutes ago      221.3 MB

myrepo/myapp        1.0                 f4702680b832        6 days ago          259.3 MB

Creamos el nuevo contenedor a partir de la nueva imagen

1

2

3

4

$ docker run -it ubuntu14.04/utils:0.0.1

root@866b066b913a:/# curl http://localhost

curl: (7) Failed to connect to localhost port 80: Connection refused

root@866b066b913a:/# exit

Una vez lo hemos creado, ya podemos volver a ejecutarlo cuando lo necesitemos.

Verificamos el contenedor recién creado

1

2

3

4

$ docker ps -a

CONTAINER ID        IMAGE                     COMMAND                  CREATED              STATUS

866b066b913a        ubuntu14.04/utils:0.0.1   “bash”                   About a minute ago   Exited (7) About a minute ago

c33a2339ca21        ubuntu:14.04              “bash”                   31 minutes ago       Exited (4) 19 minutes ago

Ejecutamos el contenedor recién creado y nos conectamos a el

1

2

3

4

5

6

$ docker start 866b066b913a

$ docker exec -it 866b066b913a bash

root@866b066b913a:/# curl http://localhost

curl: (7) Failed to connect to localhost port 80: Connection refused

root@866b066b913a:/# exit

$ docker stop 866b066b913a

Crear una nueva imagen utilizando el fichero Dockerfile

Lo más habitual es que terminemos creando una nueva imagen a partir de una existente utilizando un fichero dockerfile. Este fichero es el que utiliza el comando docker build para generar la nueva imagen. Es mucho mas versátil y sencillo crear imágenes de esta manera.

A continuación vamos a crear la misma imagen del paso anterior pero esta vez utilizando un fichero dockerfile. Es decir, una imagen basada en Ubuntu 14.04 con los comandos curl y wget instalados.

Creamos el fichero Dockerfile

1

2

3

4

5

$ mkdir -p mis_imagenes/utils

$ cd mis_imagenes/utils

 

$ touch Dockerfile

$ view Dockerfile

Y añadimos el siguiente contenido

1

2

3

FROM ubuntu:14.04

MAINTAINER me me@mydomain.com

RUN apt-get update && apt-get install -y curl wget

Como vemos estamos indicando la imagen de partida (FROM), el creador de la nueva imagen (MAINTAINER), y cada uno de los comandos (RUN) que queremos ejecutar en la nueva imagen.

Construimos la nueva imagen

Para ello utilizaremos el comando docker build, al que le indicaremos el

  • directorio donde se encuentra el fichero dockerfile
  • el nombre (repositorio y tag) de la nueva imagen

En cada uno de los pasos ejecutados por docker build se están generando imágenes intermedias. Todas estas imágenes serán eliminadas una vez tengamos creada la imagen final.

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

$ docker build -t ubuntu14.04/utils:0.0.2 .

Sending build context to Docker daemon 2.048 kB

Step 1 : FROM ubuntu:14.04

—> e9ae3c220b23

Step 2 : MAINTAINER me me@mydomain.com

—> Running in ca92d89310f3

—> facc5c7efd6d

Removing intermediate container ca92d89310f3

Step 3 : RUN apt-get update && apt-get install -y curl wget

—> Running in a5c20645fa15

Ign http://archive.ubuntu.com trusty InRelease

Get:1 http://archive.ubuntu.com trusty-updates InRelease [64.4 kB]

Get:2 http://archive.ubuntu.com trusty-security InRelease [64.4 kB]

Hit http://archive.ubuntu.com trusty Release.gpg

Hit http://archive.ubuntu.com trusty Release

Get:3 http://archive.ubuntu.com trusty-updates/main Sources [311 kB]

Processing triggers for libc-bin (2.19-0ubuntu6.6) …

Processing triggers for ca-certificates (20141019ubuntu0.14.04.1) …

Updating certificates in /etc/ssl/certs… 173 added, 0 removed; done.

Running hooks in /etc/ca-certificates/update.d….done.

—> 2c87ba841537

Removing intermediate container a5c20645fa15

Successfully built 2c87ba841537

La imagen creada se corresponde con

  • el nombre (repositorio y tag) ubuntu14.04/utils:0.0.2 y
  • el ID 2c87ba841537.

Verificamos y arrancamos la nueva imagen recién creada

Como siempre para arrancar una imagen tenemos que crear el contenedor a partir de la misma.

Verificamos la imagen recién creada

1

2

3

4

5

6

$ docker images

REPOSITORY          TAG                 IMAGE ID            CREATED             VIRTUAL SIZE

ubuntu14.04/utils   0.0.2               2c87ba841537        6 minutes ago       221.3 MB

ubuntu14.04/utils   0.0.1               074f77447d43        31 hours ago        221.3 MB

myrepo/myapp        1.0                 f4702680b832        8 days ago          259.3 MB

elasticsearch       2.1.0               14d91f1920dc        2 weeks ago         345.7 MB

Creamos el contenedor a partir de la imagen

1

2

3

4

5

6

$ docker run -it ubuntu14.04/utils:0.0.2 bash

root@27ebe51743fc:/# which curl  wget

/usr/bin/curl

/usr/bin/wget

root@27ebe51743fc:/# exit

exit

Utilizamos el contenedor

El contenedor basado en nuestra imagen se corresponde con

  • el ID 27ebe51743fc y con
  • el nombre elated_borg.
1

2

3

4

5

6

7

8

9

10

11

12

13

$ docker ps -a

CONTAINER ID        IMAGE                     COMMAND                  CREATED             STATUS                      PORTS                                           NAMES

27ebe51743fc        ubuntu14.04/utils:0.0.2   “bash”                   45 seconds ago      Exited (0) 14 seconds ago                                                   elated_borg

 

$ docker start elated_borg

elated_borg

 

$ docker exec -it elated_borg bash

root@27ebe51743fc:/# which curl wget

/usr/bin/curl

/usr/bin/wget

root@27ebe51743fc:/# exit

exit

Borrar una imagen

Podemos borrar la imagen a partir de su identificado (ID) o a partir de su nombre (repositorio y tag).

Listamos las imagenes

1

2

3

4

$ docker images

REPOSITORY          TAG                 IMAGE ID            CREATED             VIRTUAL SIZE

ubuntu14.04/utils   0.0.2               2c87ba841537        18 hours ago        221.3 MB

ubuntu14.04/utils   0.0.1               074f77447d43        2 days ago          221.3 MB

Borramos la imagen que no necesitamos

1

2

3

$ docker rmi ubuntu14.04/utils:0.0.1

Untagged: ubuntu14.04/utils:0.0.1

Deleted: 074f77447d43f92aa8006ba97b54a26a187782224392d4a5ea3798dcb860060c

Borramos todas las imagenes de un determinado repositorio

1 $ docker rmi ubuntu14.04/utils