¿Cómo instalar Docker Compose en Ubuntu?

Docker Compose es una herramienta que facilita la implementación y gestión de aplicaciones multicontenedor en entornos Docker. Permite a los programadores definir, configurar y ejecutar varios contenedores vinculados como una única pila de aplicaciones. Docker Compose simplifica la orquestación de aplicaciones complejas mediante el uso de un archivo YAML para definir los servicios, las redes y los volúmenes necesarios. Facilita la duplicación de tareas y el intercambio de entornos de desarrollo y producción coherentes. Se facilita la colaboración, se reducen los problemas de implementación y se mejora la portabilidad de las aplicaciones entre sistemas.

En este tutorial, aprenderás cómo instalar Docker Compose en el sistema Ubuntu 22.04.

Requisitos previos

Antes de continuar con la guía sobre cómo instalar Docker Compose en Ubuntu 22.04, asegúrate de que cumples los siguientes requisitos:

Acceso a Ubuntu 22.04: necesitas privilegios de root o de sudo.
Docker: debe estar instalado en tu sistema. Si aún no lo está, no te preocupes, te explicamos cómo instalarlo.
Consideraciones sobre el firewall: si usas Docker para exponer puertos de los contenedores, ten en cuenta que las herramientas de gestión del firewall como ufw o Firewalld pueden bloquearlos. Asegúrate de que la configuración de tu firewall permite los puertos necesarios.

Guía paso a paso: ¿Cómo instalar Docker Compose en Ubuntu 22.04?

Puedes instalar Docker Compose en Ubuntu 22.04 utilizando dos métodos diferentes:

Instalar Docker Compose desde el repositorio apt de Ubuntu.
Instalar Docker Compose utilizando el repositorio oficial de GitHub.

Antes de instalar Docker Compose, comprueba si tienes Docker instalado. Si no lo tienes, no te preocupes: también lo explicamos. ¡Empecemos!

Instalar Docker Compose en Ubuntu utilizando el repositorio apt

El método más cómodo es instalar Docker Compose utilizando el repositorio apt de Ubuntu. Para ello, primero hay que añadir el repositorio de Docker al sistema.

Paso 1: Instalar las dependencias necesarias de Docker Compose

En primer lugar, abre la terminal con el atajo «Ctrl + Alt + T» y actualiza la lista de paquetes:

$ sudo apt-get update

Después, instala las dependencias necesarias para Docker y Docker Compose:

$ sudo apt install lsb-release ca-certificates apt-transport-https software-properties-common

El comando anterior instalará todos los paquetes necesarios con los nombres «lsb-release», «ca-certificates», «apt-transport-https» y «software-properties-common» en la máquina Ubuntu 22.04.

Paso 2: Añadir el repositorio Docker a la lista de fuentes de Ubuntu

Para añadir el repositorio de Docker al sistema Ubuntu, es necesario importar la clave Docker GPG necesaria para conectarse al repositorio de Docker:

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Una vez importada la clave GPG, añade el repositorio de Docker a la lista de fuentes del sistema con el siguiente comando:

$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Paso 3: Instalar Docker Compose Ubuntu 22.04

Después de añadir el repositorio de Docker, actualiza todos los repositorios apt de Ubuntu.

$ sudo apt update

Verás que el repositorio de Docker aparece en la lista de orígenes.

Ahora puedes instalar Docker y el plugin de Docker Compose con el siguiente comando:

$ sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

Comprueba que el servicio de Docker está en ejecución:

$ sudo systemctl status docker

Ahora, comprueba la versión de Docker Compose:

$ docker compose version

Comprueba también la versión de Docker:

$ docker --version

Instalar Docker Compose en Ubuntu utilizando el repositorio oficial de GitHub

Antes de instalar Docker Compose, comprueba primero la última versión disponible de Docker Compose en la página de lanzamientos.

En el ejemplo se usa la versión v2.3.3; sustitúyela en la URL por la última versión publicada en esa página. A continuación, te ofrecemos una guía paso a paso para instalar Docker Compose en Ubuntu a través del repositorio oficial de GitHub.

Paso 1: Configurar el directorio

En primer lugar, crea un directorio con el comando «mkdir»:

$ mkdir -p ~/.docker/cli-plugins/

Paso 2: Descargar Docker Compose

Ahora, descarga Docker Compose desde el repositorio oficial de GitHub utilizando el comando «curl» o «wget»:

$ curl -SL https://github.com/docker/compose/releases/download/v2.3.3/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-compose

Este comando obtendrá la versión 2.3.3 para tu sistema. Si deseas instalar una versión diferente, simplemente ajusta el número de versión en la URL.

Paso 3: Haz que el archivo sea ejecutable

Haz que el archivo Docker-compose sea ejecutable utilizando el comando «chmod»:

$ chmod +x ~/.docker/cli-plugins/docker-compose

Paso 4: Verifica la instalación

Verifica la instalación anterior mostrando la versión de Docker Compose con el siguiente comando:

$ docker compose --version

Con los pasos anteriores, no estás limitado a los ordenadores personales, sino que también puedes instalar Docker Compose en los servidores BlueVPS.

¿Cómo utilizar Docker Compose en Ubuntu 22.04?

Después de instalar Docker Compose, necesitas un archivo docker-compose.yml que describa tus servicios. Empieza creando un directorio de proyecto en tu carpeta personal:

$ mkdir ~/compose-mongodemo
$ cd ~/compose-mongodemo

¿Cómo configurar el archivo «docker-compose.yml»?

En este tutorial, configuraremos un archivo docker-compose.yml para la imagen «Mongo Express». Crea y edita el archivo:

$ nano docker-compose.yml

Pega en él la siguiente configuración, basada en el ejemplo oficial de Docker Hub. Define dos servicios: la base de datos MongoDB y la interfaz web Mongo Express, publicada en el puerto 8081. Cambia el usuario y la contraseña de ejemplo por los tuyos:

services:
  mongo:
    image: mongo
    restart: always
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: example

  mongo-express:
    image: mongo-express
    restart: always
    ports:
      - 8081:8081
    environment:
      ME_CONFIG_MONGODB_ADMINUSERNAME: root
      ME_CONFIG_MONGODB_ADMINPASSWORD: example
      ME_CONFIG_MONGODB_URL: mongodb://root:example@mongo:27017/
      ME_CONFIG_BASICAUTH: "false"

Guarda los cambios con «Ctrl+O» y sal de nano con «Ctrl+X».

Para levantar los servicios definidos en docker-compose.yml, ejecuta:

$ docker compose up -d

Este comando extraerá las imágenes necesarias, incluyendo Mongo Express, e iniciará los contenedores.

Comprueba el estado de los contenedores:

$ docker compose ps

Ya puedes acceder a la interfaz de Mongo Express en:

http://localhost:8081 o http://your-server-ip:8081

Veamos algunos comandos más de Docker Compose que te ayudarán a ejecutar un entorno con varios contenedores.

Para ver los registros de los contenedores, usa el comando «logs»:

$ sudo docker compose logs

Para pausar y reanudar los contenedores en ejecución, usa estos comandos:

$ docker compose pause

$ docker compose unpause

Para detener y eliminar los contenedores y redes creados por Compose, usa el comando «down»:

$ docker compose down

Conclusión

En esta guía, has visto cómo instalar Docker Compose Ubuntu utilizando dos métodos diferentes: utilizando un repositorio apt y a través de GitHub. También hemos demostrado cómo configurar un entorno contenedorizado con MongoDB y Mongo Express. Por último, has aprendido a gestionar un entorno contenedorizado Docker Compose, utilizando diferentes comandos.

Si deseas obtener más información sobre Docker y Docker Compose, consulta la documentación oficial de Docker.

Blog