finid escribió una versión anterior de este tutorial.
Docker es una aplicación que simplifica el proceso de administración de procesos de aplicación en contenedores. Los contenedores le permiten ejecutar sus aplicaciones en procesos con aislamiento de recursos. Son similares a las máquinas virtuales, pero los contenedores son más portátiles, más flexibles con los recursos y más dependientes del sistema operativo host.
Para hallar una introducción detallada a los distintos componentes de un contenedor de Docker, consulte El ecosistema de Docker: Introducción a los componentes comunes.
A través de este tutorial, instalará y usará Docker Community Edition (CE) en Debian 9. Instalará el propio Docker, trabajará con contenedores e imágenes, e introducirá una imagen en un repositorio Docker.
Para completar este tutorial, necesitará lo siguiente:
Es posible que la versión del paquete de instalación de Docker disponible en el repositorio oficial de Debian no sea la más reciente. Para asegurarnos de contar con la versión más reciente, instalaremos Docker desde el repositorio oficial de Docker. Para hacerlo, agregaremos una nueva fuente de paquetes y la clave GPG de Docker para garantizar que las descargas sean válidas, y luego instalaremos el paquete.
Primero, actualice su lista de paquetes existente:
- sudo apt update
A continuación, instale algunos paquetes de requisitos previos que permitan a apt
usar paquetes a través de HTTPS:
- sudo apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common
Luego, añada la clave de GPG para el repositorio oficial de Docker en su sistema:
- curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
Agregue el repositorio de Docker a las fuentes de APT:
- sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
A continuación, actualice el paquete de base de datos con los paquetes de Docker del repositorio recién agregado:
- sudo apt update
Asegúrese de estar a punto de realizar la instalación desde el repositorio de Docker en lugar del repositorio predeterminado de Debian:
- apt-cache policy docker-ce
Si bien el número de versión de Docker puede ser distinto, verá un resultado como el siguiente:
docker-ce:
Installed: (none)
Candidate: 18.06.1~ce~3-0~debian
Version table:
18.06.1~ce~3-0~debian 500
500 https://download.docker.com/linux/debian stretch/stable amd64 Packages
Observe que docker-ce
no está instalado, pero la opción más viable para la instalación es del repositorio de Docker para Debian 9 (stretch
).
Por último, instale Docker:
- sudo apt install docker-ce
Con esto, Docker quedará instalado, el demonio se iniciará y el proceso se habilitará para ejecutarse en el inicio. Compruebe que funcione:
- sudo systemctl status docker
El resultado debe ser similar al siguiente, y mostrar que el servicio está activo y en ejecución:
Output● docker.service - Docker Application Container Engine
Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
Active: active (running) since Thu 2018-07-05 15:08:39 UTC; 2min 55s ago
Docs: https://docs.docker.com
Main PID: 21319 (dockerd)
CGroup: /system.slice/docker.service
├─21319 /usr/bin/dockerd -H fd://
└─21326 docker-containerd --config /var/run/docker/containerd/containerd.toml
La instalación de Docker ahora le proporcionará no solo el servicio de Docker (demonio) sino también la utilidad de línea de comandos docker
o el cliente de Docker. Más adelante, exploraremos la forma de usar el comando docker
en este tutorial.
Por defecto, el comando docker
solo puede ser ejecutado por el usuario root o un usuario del grupo docker, que se crea automáticamente durante el proceso de instalación de Docker. Si intenta ejecutar el comando docker
sin sudo
como prefijo o sin formar parte del grupo docker, obtendrá un resultado como este:
Outputdocker: Cannot connect to the Docker daemon. Is the docker daemon running on this host?.
See 'docker run --help'.
Si desea evitar escribir sudo
al ejecutar el comando docker
, agregue su nombre de usuario al grupo docker
:
- sudo usermod -aG docker ${USER}
Para aplicar la nueva membresía de grupo, cierre la sesión del servidor y vuelva a iniciarla o escriba lo siguiente:
- su - ${USER}
Para continuar, se le solicitará ingresar la contraseña de su usuario.
Confirme que ahora su usuario se agregó al grupo docker escribiendo lo siguiente:
- id -nG
Outputsammy sudo docker
Si debe agregar al grupo docker
un usuario con el que no inició sesión, declare dicho nombre de usuario de forma explícita usando lo siguiente:
- sudo usermod -aG docker username
Para el resto de este artículo, se supone que ejecutará el comando docker
como usuario del grupo docker. Si elige no hacerlo, incluya sudo
al principio de los comandos.
A continuación, exploremos el comando docker
.
El uso de docker
consiste en pasar a este una cadena de opciones y comandos seguida de argumentos. La sintaxis adopta esta forma:
- docker [option] [command] [arguments]
Para ver todos los subcomandos disponibles, escriba lo siguiente:
- docker
A partir de Docker 18, en la lista completa de subcomandos disponibles se incluye lo siguiente:
Output
attach Attach local standard input, output, and error streams to a running container
build Build an image from a Dockerfile
commit Create a new image from a container's changes
cp Copy files/folders between a container and the local filesystem
create Create a new container
diff Inspect changes to files or directories on a container's filesystem
events Get real time events from the server
exec Run a command in a running container
export Export a container's filesystem as a tar archive
history Show the history of an image
images List images
import Import the contents from a tarball to create a filesystem image
info Display system-wide information
inspect Return low-level information on Docker objects
kill Kill one or more running containers
load Load an image from a tar archive or STDIN
login Log in to a Docker registry
logout Log out from a Docker registry
logs Fetch the logs of a container
pause Pause all processes within one or more containers
port List port mappings or a specific mapping for the container
ps List containers
pull Pull an image or a repository from a registry
push Push an image or a repository to a registry
rename Rename a container
restart Restart one or more containers
rm Remove one or more containers
rmi Remove one or more images
run Run a command in a new container
save Save one or more images to a tar archive (streamed to STDOUT by default)
search Search the Docker Hub for images
start Start one or more stopped containers
stats Display a live stream of container(s) resource usage statistics
stop Stop one or more running containers
tag Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE
top Display the running processes of a container
unpause Unpause all processes within one or more containers
update Update configuration of one or more containers
version Show the Docker version information
wait Block until one or more containers stop, then print their exit codes
Si desea ver las opciones disponibles para un comando específico, escriba lo siguiente:
- docker docker-subcommand --help
Para ver información sobre Docker relacionada con todo el sistema, utilice lo siguiente:
- docker info
Exploremos algunos de estos comandos. Comenzaremos trabajando con imágenes.
Los contenedores de Docker se construyen con imágenes de Docker. Por defecto, Docker obtiene estas imágenes de Docker Hub, un registro de Docker gestionado por Docker, la empresa responsable del proyecto Docker. Cualquiera puede alojar sus imágenes en Docker Hub, de modo que la mayoría de las aplicaciones y las distribuciones de Linux que necesitará tendrán imágenes alojadas allí.
Para verificar si puede acceder a imágenes y descargarlas de Docker Hub, escriba lo siguiente:
- docker run hello-world
El resultado indicará que Docker funciona de forma correcta:
OutputUnable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
9db2ca6ccae0: Pull complete
Digest: sha256:4b8ff392a12ed9ea17784bd3c9a8b1fa3299cac44aca35a85c90c5e3c7afacdc
Status: Downloaded newer image for hello-world:latest
Hello from Docker!
This message shows that your installation appears to be working correctly.
...
Inicialmente, Docker no pudo encontrar la imagen de hello-world
a nivel local. Por ello la descargó de Docker Hub, el repositorio predeterminado. Una vez que se descargó la imagen, Docker creó un contenedor a partir de ella y de la aplicación dentro del contenedor ejecutado, y mostró el mensaje.
Puede buscar imágenes disponibles en Docker Hub usando el comando docker
con el subcomando search
. Por ejemplo, para buscar la imagen de Ubuntu, escriba lo siguiente:
- docker search ubuntu
El script rastreará Docker Hub y mostrará una lista de todas las imágenes cuyo nombre coincida con la cadena de búsqueda. En este caso, el resultado será similar a lo siguiente:
OutputNAME DESCRIPTION STARS OFFICIAL AUTOMATED
ubuntu Ubuntu is a Debian-based Linux operating sys… 8320 [OK]
dorowu/ubuntu-desktop-lxde-vnc Ubuntu with openssh-server and NoVNC 214 [OK]
rastasheep/ubuntu-sshd Dockerized SSH service, built on top of offi… 170 [OK]
consol/ubuntu-xfce-vnc Ubuntu container with "headless" VNC session… 128 [OK]
ansible/ubuntu14.04-ansible Ubuntu 14.04 LTS with ansible 95 [OK]
ubuntu-upstart Upstart is an event-based replacement for th… 88 [OK]
neurodebian NeuroDebian provides neuroscience research s… 53 [OK]
1and1internet/ubuntu-16-nginx-php-phpmyadmin-mysql-5 ubuntu-16-nginx-php-phpmyadmin-mysql-5 43 [OK]
ubuntu-debootstrap debootstrap --variant=minbase --components=m… 39 [OK]
nuagebec/ubuntu Simple always updated Ubuntu docker images w… 23 [OK]
tutum/ubuntu Simple Ubuntu docker images with SSH access 18
i386/ubuntu Ubuntu is a Debian-based Linux operating sys… 13
1and1internet/ubuntu-16-apache-php-7.0 ubuntu-16-apache-php-7.0 12 [OK]
ppc64le/ubuntu Ubuntu is a Debian-based Linux operating sys… 12
eclipse/ubuntu_jdk8 Ubuntu, JDK8, Maven 3, git, curl, nmap, mc, … 6 [OK]
darksheer/ubuntu Base Ubuntu Image -- Updated hourly 4 [OK]
codenvy/ubuntu_jdk8 Ubuntu, JDK8, Maven 3, git, curl, nmap, mc, … 4 [OK]
1and1internet/ubuntu-16-nginx-php-5.6-wordpress-4 ubuntu-16-nginx-php-5.6-wordpress-4 3 [OK]
pivotaldata/ubuntu A quick freshening-up of the base Ubuntu doc… 2
1and1internet/ubuntu-16-sshd ubuntu-16-sshd 1 [OK]
ossobv/ubuntu Custom ubuntu image from scratch (based on o… 0
smartentry/ubuntu ubuntu with smartentry 0 [OK]
1and1internet/ubuntu-16-healthcheck ubuntu-16-healthcheck 0 [OK]
pivotaldata/ubuntu-gpdb-dev Ubuntu images for GPDB development 0
paasmule/bosh-tools-ubuntu Ubuntu based bosh-cli 0 [OK]
...
En la columna de OFFICIAL,** OK** indica una imagen creada y avalada por la empresa responsable del proyecto. Una vez que identifique la imagen que desearía usar, puede descargarla a su computadora usando el subcomando pull
.
Ejecute el siguiente comando para descargar la imagen oficial de ubuntu
a su ordenador:
- docker pull ubuntu
Verá el siguiente resultado:
OutputUsing default tag: latest
latest: Pulling from library/ubuntu
6b98dfc16071: Pull complete
4001a1209541: Pull complete
6319fc68c576: Pull complete
b24603670dc3: Pull complete
97f170c87c6f: Pull complete
Digest: sha256:5f4bdc3467537cbbe563e80db2c3ec95d548a9145d64453b06939c4592d67b6d
Status: Downloaded newer image for ubuntu:latest
Una vez descargada una imagen, puede ejecutar un contenedor usando la imagen descargada con el subcomando run
. Como pudo ver en el ejemplo de hello-world
, si no se descargó una imagen al ejecutarse docker
con el subcomando run
, el cliente de Docker descargará primero la imagen y luego ejecutará un contenedor utilizándola.
Para ver las imágenes descargadas a su computadora, escriba lo siguiente:
- docker images
El resultado debe tener un aspecto similar al siguiente:
OutputREPOSITORY TAG IMAGE ID CREATED SIZE
ubuntu latest 16508e5c265d 13 days ago 84.1MB
hello-world latest 2cb0d9787c4d 7 weeks ago 1.85kB
Como verá más adelante en este tutorial, las imágenes que utilice para ejecutar contenedores pueden modificarse y utilizarse para generar nuevas imágenes que se pueden cargar posteriormente (“introducir” es el término técnico) a Docker Hub o a otros registros de Docker.
Veamos en mayor profundidad la forma de ejecutar los contenedores.
El contenedor hello-world
que ejecutó en el paso anterior es un ejemplo de un contenedor que se ejecuta y se cierra tras emitir un mensaje de prueba. Los contenedores pueden ofrecer una utilidad mucho mayor y ser interactivos. Después de todo, son similares a las máquinas virtuales, aunque más flexibles con los recursos.
Como ejemplo, ejecutemos un contenedor usando la imagen más reciente de Ubuntu. La combinación de los conmutadores -i y -t le proporcionan un acceso interactivo del shell al contenedor:
- docker run -it ubuntu
Su símbolo del sistema debe cambiar para reflejar el hecho de que ahora trabaja dentro del contenedor y debe adoptar esta forma:
Outputroot@d9b100f2f636:/#
Tenga en cuenta el ID del contenedor en el símbolo del sistema. En este ejemplo, es d9b100f2f636
. Más adelante, necesitará ese ID de contenedor para identificar el contenedor cuando desee eliminarlo.
Ahora puede ejecutar cualquier comando dentro del contenedor. Por ejemplo, actualicemos la base de datos del paquete dentro del contenedor. No es necesario prefijar ningún comando con sudo
, ya que realiza operaciones dentro del contenedor como el usuario root:
- apt update
Luego, instale cualquier aplicación en él. Probemos con Node.js:
- apt install nodejs
Con esto, se instala Node.js en el contenedor desde el repositorio oficial de Ubuntu. Cuando finalice la instalación, verifique que Node.js esté instalado:
- node -v
Verá el número de versión en su terminal:
Outputv8.10.0
Cualquier cambio que realice dentro del contenedor solo se aplica a este.
Para cerrar el contenedor, escriba exit
a línea de comandos.
A continuación, veremos la forma de administrar los contenedores en nuestro sistema.
Después de usar Docker durante un tiempo, tendrá muchos contenedores activos (en ejecución) e inactivos en su computadora. Para ver **los **activos, utilice lo siguiente:
- docker ps
Verá una salida similar a la siguiente:
OutputCONTAINER ID IMAGE COMMAND CREATED
A través de este tutorial, inició dos contenedores: uno de la imagen hello-world
y otro de la imagen ubuntu
. Ambos contenedores ya no están en ejecución, pero aún existen en su sistema.
Para ver todos los contenedores, activos e inactivos, ejecute docker ps
con el conmutador -a
:
- docker ps -a
Visualizará un resultado similar a esto:
d9b100f2f636 ubuntu "/bin/bash" About an hour ago Exited (0) 8 minutes ago sharp_volhard
01c950718166 hello-world "/hello" About an hour ago Exited (0) About an hour ago festive_williams
Para ver el último contenedor que creó, páselo al conmutador -l
:
- docker ps -l
- CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
- d9b100f2f636 ubuntu "/bin/bash" About an hour ago Exited (0) 10 minutes ago sharp_volhard
Para iniciar un contenedor detenido, utilice docker start
, seguido del o el nombre ID del contenedor. Iniciemos el contenedor basado en Ubuntu con el ID de d9b100f2f636
:
- docker start d9b100f2f636
El contenedor se iniciará y podrá usar docker ps
para ver su estado:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
d9b100f2f636 ubuntu "/bin/bash" About an hour ago Up 8 seconds sharp_volhard
Para detener un contenedor en funcionamiento, utilice docker stop
, seguido del ID o nombre del contenedor. Esta vez usaremos el nombre que Docker asignó al contenedor, que es sharp_volhard
:
- docker stop sharp_volhard
Una vez que decidida que ya no necesita un contenedor, elimínelo con el comando docker rm
y use nuevamente el ID o el nombre del contenedor. Utilice el comando docker ps -a
para encontrar el ID o nombre del contenedor asociado con la imagen hello-world
y elimínelo.
- docker rm festive_williams
Puede iniciar un nuevo contenedor y darle un nombre usando el conmutador --name
. También podrá usar el conmutador de --rm
para crear un contenedor que se elimine de forma automática cuando se detenga. Consulte el comando docker run help
para obtener más información sobre estas y otras opciones.
Los contenedores pueden convertirse en imágenes que podrá usar para crear contenedores nuevos. Veamos cómo funciona esto.
Cuando inicie una imagen de Docker, podrá crear, modificar y eliminar archivos del mismo modo que con una máquina virtual. Los cambios que realice solo se aplicarán al contenedor en cuestión. Podrá iniciarlo y detenerlo, pero una vez que lo destruya con el comando docker rm
, los cambios se perderán por completo.
En esta sección verá la forma de guardar el estado de un contenedor como una nueva imagen de Docker.
Después de instalar Node.js dentro del contenedor de Ubuntu, dispondrá de un contenedor que se ejecuta a partir de una imagen, pero este es diferente de la imagen que utilizó para crearlo. Sin embargo, quizá desee reutilizar este contenedor Node.js como base de nuevas imágenes posteriormente.
Luego, confirme los cambios en una nueva instancia de imagen de Docker utilizando el siguiente comando:
- docker commit -m "What you did to the image" -a "Author Name" container_id repository/new_image_name
El conmutador -m es para el mensaje de confirmación que le permite a usted y a otros a saber qué cambios realizaron, mientras que -a se utiliza para especificar el autor. El container_id
es el que observó anteriormente en el tutorial cuando inició la sesión interactiva de Docker. A menos que haya creado repositorios adicionales en Docker Hub, repository
generalmente corresponde a su nombre de usuario de Docker Hub.
Por ejemplo, para el usuario** sammy**, con el ID de contenedor d9b100f26f636
, el comando sería el siguiente:
- docker commit -m "added Node.js" -a "sammy" d9b100f2f636 sammy/ubuntu-nodejs
Cuando *confirme *una imagen, la nueva imagen se guardará a nivel local en su computadora. Más adelante, en este tutorial, aprenderá a introducir una imagen en un registro de Docker como Docker Hub para que otros puedan acceder a ella.
Listar las imágenes de Docker de nuevo mostrará la nueva imagen, así como la anterior de la que se derivó:
- docker images
Verá resultados como este:
OutputREPOSITORY TAG IMAGE ID CREATED SIZE
sammy/ubuntu-nodejs latest 7c1f35226ca6 7 seconds ago 179MB
ubuntu latest 113a43faa138 4 weeks ago 81.2MB
hello-world latest e38bc07ac18e 2 months ago 1.85kB
En este ejemplo ubuntu-nodejs
es la nueva imagen, derivada de la imagen ubuntu
existente de Docker Hub. La diferencia de tamaño refleja los cambios realizados. En este ejemplo, el cambio fue la instalación de NodeJS. Por ello, la próxima vez que deba ejecutar un contenedor usando Ubuntu con NodeJS preinstalado, podrá usar simplemente la nueva imagen.
También podrá crear imágenes de un Dockerfile
, lo cual le permitirá automatizar la instalación de software en una nueva imagen. Sin embargo, eso queda fuera del alcance de este tutorial.
Ahora, compartiremos la nueva imagen con terceros para que puedan crear contenedores a partir de ella.
El siguiente paso lógico después de crear una nueva imagen a partir de una imagen existente es compartirla con algunos de sus amigos, con todo el mundo en Docker Hub, o en otro registro de Docker al que tenga acceso. Para introducir una imagen a Docker Hub o a cualquier otro registro de Docker, deberá tener una cuenta en el sistema.
En esta sección verá cómo introducir una imagen de Docker en Docker Hub. Para aprender a crear su propio registro privado de Docker, consulte Cómo configurar un registro de Docker privado en Ubuntu 14.04.
Para introducir su imagen, primero inicie sesión en Docker Hub.
- docker login -u docker-registry-username
Se le solicitará autenticarse usando su contraseña de Docker Hub. Si especificó la contraseña correcta, la autenticación tendrá éxito.
Nota: Si su nombre de usuario de registro de Docker es diferente del nombre de usuario local que usó para crear la imagen, deberá etiquetar su imagen con su nombre de usuario de registro. Para el ejemplo que se muestra en el último paso, deberá escribir lo siguiente:
- docker tag sammy/ubuntu-nodejs docker-registry-username/ubuntu-nodejs
Luego podrá introducir su propia imagen usando lo siguiente:
- docker push docker-registry-username/docker-image-name
Para introducir la imagen ubuntu-nodejs
en el repositorio de sammy, el comando sería el siguiente:
- docker push sammy/ubuntu-nodejs
El proceso puede tardar un tiempo en completarse cuando se suben las imágenes, pero una vez que finalice el resultado será el siguiente:
OutputThe push refers to a repository [docker.io/sammy/ubuntu-nodejs]
e3fbbfb44187: Pushed
5f70bf18a086: Pushed
a3b5c80a4eba: Pushed
7f18b442972b: Pushed
3ce512daaf78: Pushed
7aae4540b42d: Pushed
...
Una vez que introduce una imagen en un registro, esta debe aparecer en el panel de su cuenta, como se muestra en la siguiente captura:
Si un intento de introducción produce un error de este tipo, es probable que no haya iniciado sesión:
OutputThe push refers to a repository [docker.io/sammy/ubuntu-nodejs]
e3fbbfb44187: Preparing
5f70bf18a086: Preparing
a3b5c80a4eba: Preparing
7f18b442972b: Preparing
3ce512daaf78: Preparing
7aae4540b42d: Waiting
unauthorized: authentication required
Inicie sesión con docker login
y repita el intento de introducción. Luego, compruebe que exista en su página de repositorios de Docker Hub.
Ahora podrá usar docker pull sammy/ubuntu-nodejs
para introducir la imagen en una nueva máquina y usarla para ejecutar un nuevo contenedor.
A través de este tutorial, instaló Docker, trabajó con imágenes y contenedores e introdujo una imagen modificada en Docker Hub. Ahora que conoce los aspectos básico, explore los otros tutoriales de Docker de la Comunidad de DigitalOcean.
Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.
This textbox defaults to using Markdown to format your answer.
You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!