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 curl, wget, 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 |