Aplica a: Cloud Server con Docker instalado · Tiempo estimado: lectura
¿Qué vas a lograr?
Verificar la instalación de Docker, desplegar tu primer contenedor y entender cómo usar Docker Compose para proyectos multi-contenedor.
Qué es Docker
Docker es una plataforma que permite crear contenedores de software — ambientes de ejecución aislados que incluyen una aplicación junto con sus dependencias y configuraciones. Los contenedores se despliegan a partir de imágenes que pueden descargarse de Docker Hub o generarse como parte de un proceso de CI/CD.
Podés instalar Docker en cualquier Cloud Server con Linux, o usar alguna de las imágenes Click&Go que incluyen Docker y docker-compose preinstalados. Para ejecutar comandos de Docker necesitás conectarte al servidor por SSH.
Verificar la instalación
El siguiente comando muestra la información de la versión de Docker, si está instalado correctamente:
docker --version
El siguiente comando muestra la versión de docker-compose, si está instalado como aplicación separada:
docker-compose --version
En caso que docker compose esté instalado como plugin de Docker (sin el guión) se puede verificar la versión instalada con el siguiente comando:
docker compose version
Desplegar un contenedor
Si no estás trabajando como root, todos los comandos de docker deben ir precedidos por sudo.
Este comando descarga y ejecuta un contenedor de prueba:
sudo docker run --rm hello-world
La opción --rm elimina el contenedor después de ejecutarlo — habitual en contenedores que se ejecutan una única vez.
Desplegar proyectos multi-contenedor con Docker Compose
Docker Compose permite desplegar varios contenedores como parte de un proyecto, con cada componente en un contenedor separado. Por ejemplo: un contenedor para una API en Laravel, otro para una base de datos PostgreSQL, otro para un front-end en React y otro para un proxy como Nginx.
Para crear un proyecto:
Creá un directorio para el proyecto e ingresá en él
Dentro del directorio, creá un archivo docker-compose.yml con la configuración de servicios, redes y volúmenes
Para iniciar todos los servicios:
docker-compose up -d
La opción -d ejecuta los servicios en segundo plano sin bloquear la terminal.
Para detener todos los servicios:
docker-compose down
Docker Compose está disponible como plugin (docker compose, sin guión) o como instalación separada (docker-compose, con guión). Ambas funcionan igual, pero se recomienda la versión plugin.