Puede ejecutar Compose en macOS, Windows y Linux de 64 bits.

Prerrequisitos

Docker Compose se basa en Docker Engine para cualquier trabajo significativo, así que asegúrese de tener Docker Engine instalado de forma local o remota, según su configuración.

  • En sistemas de escritorio como Docker Desktop para Mac y Windows, Docker Compose se incluye como parte de esas instalaciones de escritorio.

  • En sistemas Linux, primero instale el Estibador para su sistema operativo como se describe en la página Obtener Docker, luego regrese aquí para obtener instrucciones sobre cómo instalar Compose en sistemas Linux.

  • Para ejecutar Compose como un usuario no root, consulte Administrar Docker como un usuario no root.

Instalar Redactar

Siga las instrucciones a continuación para instalar Compose en sistemas Mac, Windows, Windows Server 2016 o Linux, o descubra alternativas como usar el pip Administrador de paquetes de Python o instalar Compose como contenedor.

Instalar una versión diferente

Las instrucciones a continuación describen la instalación de la versión estable actual (v1.24.1) de Redactar. Para instalar una versión diferente de Compose, reemplace el número de versión proporcionado por el que desee. Las versiones de Compose también se enumeran y están disponibles para su descarga directa en el Redactar la página de lanzamiento del repositorio en GitHub. Para instalar un prelanzamiento de Compose, consulte la sección de instalación de compilaciones preliminares.

Instalar Compose en macOS

Docker Desktop para Mac y Caja de herramientas de Docker ya incluye Compose junto con otras aplicaciones de Docker, por lo que los usuarios de Mac no necesitan instalar Compose por separado. Las instrucciones de instalación de Docker para estos están aquí:

Instalar Compose en sistemas de escritorio Windows

Docker Desktop para Windows y Caja de herramientas de Docker ya incluye Compose junto con otras aplicaciones de Docker, por lo que la mayoría de los usuarios de Windows no necesitan instalar Compose por separado. Las instrucciones de instalación de Docker para estos están aquí:

Si está ejecutando el daemon y el cliente de Docker directamente en Microsoft Windows Server, siga las instrucciones en la pestaña Windows Server.

Instalar Compose en Windows Server

Siga estas instrucciones si está ejecutando el demonio y el cliente de Docker directamente en Microsoft Windows Server con Motor de Docker: empresay desea instalar Docker Compose.

  1. Inicie un PowerShell “elevado” (ejecútelo como administrador). Busque PowerShell, haga clic con el botón derecho y elija Ejecutar como administrador. Cuando se le pregunte si desea permitir que esta aplicación realice cambios en su dispositivo, haga clic en sí.

  2. En PowerShell, dado que GitHub ahora requiere TLS1.2, ejecute lo siguiente:

    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

    Luego, ejecute el siguiente comando para descargar la versión estable actual de Compose (v1.24.1):

    Invoke-WebRequest "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-Windows-x86_64.exe" -UseBasicParsing -OutFile $Env:ProgramFilesDockerdocker-compose.exe

Nota: En Windows Server 2019, puede agregar el ejecutable Compose a $Env:ProgramFilesDocker. Porque este directorio está registrado en el sistema PATH, puedes ejecutar el docker-compose --version comando en el paso siguiente sin configuración adicional.

> To install a different version of Compose, substitute `1.24.1`
> with the version of Compose you want to use.

  1. Prueba la instalación.

    docker-compose --version

docker-compose version 1.24.1, build 01110ad01

Instalar Compose en sistemas Linux

En Linux, puede descargar el binario de Docker Compose desde el Redactar la página de lanzamiento del repositorio en GitHub. Siga las instrucciones del enlace, que implican ejecutar el curl comando en su terminal para descargar los binarios. Estas instrucciones paso a paso también se incluyen a continuación.

Para alpine, se necesitan los siguientes paquetes de dependencia: py-pip, python-dev, libffi-dev, openssl-dev, gcc, libc-dev, y make.

  1. Ejecute este comando para descargar la versión estable actual de Docker Compose:

    sudo curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

    Para instalar una versión diferente de Compose, sustituya 1.24.1 con la versión de Compose que desee utilizar.

    Si tiene problemas para instalar con curl, consulte la pestaña Opciones de instalación alternativas más arriba.

  2. Aplicar permisos ejecutables al binario:

    sudo chmod +x /usr/local/bin/docker-compose

Nota: Si el comando docker-compose falla después de la instalación, verifique su ruta. También puede crear un enlace simbólico para /usr/bin o cualquier otro directorio en su ruta.

Por ejemplo:

sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

  1. Opcionalmente, instale la finalización del comando para el bash y zsh cascarón.

  2. Prueba la instalación.

    $ docker-compose --version
docker-compose version 1.24.1, build 1110ad01

Opciones de instalación alternativas

  • Instalar usando pip
  • Instalar como contenedor

Instalar usando pip

Para alpine, se necesitan los siguientes paquetes de dependencia: py-pip, python-dev, libffi-dev, openssl-dev, gcc, libc-dev, y make.

Compose se puede instalar desde pypi utilizando pip. Si instala usando pip, le recomendamos que utilice un virtualenv porque muchos sistemas operativos tienen paquetes de sistema de Python que entran en conflicto con las dependencias de Docker-compose. Ver el tutorial virtualenv Para empezar.

pip install docker-compose

Si no está usando virtualenv,

sudo pip install docker-compose

Se requiere la versión 6.0 o superior de pip.

Instalar como contenedor

Compose también se puede ejecutar dentro de un contenedor, desde un pequeño contenedor de script bash. Para instalar compose como un contenedor, ejecute este comando:

$ sudo curl -L --fail https://github.com/docker/compose/releases/download/1.24.1/run.sh -o /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose

Instalar compilaciones preliminares

Si está interesado en probar una compilación previa al lanzamiento, puede descargar candidatos de lanzamiento del Redactar la página de lanzamiento del repositorio en GitHub. Siga las instrucciones del enlace, que implica ejecutar el curl comando en su terminal para descargar los binarios.

Las versiones preliminares creadas a partir de la rama “maestra” también están disponibles para descargar en https://dl.bintray.com/docker-compose/master/.

Las compilaciones previas al lanzamiento le permiten probar nuevas funciones antes de su lanzamiento, pero pueden ser menos estables.

Actualización

Si está actualizando desde Compose 1.2 o una versión anterior, elimine o migre sus contenedores existentes después de actualizar Compose. Esto se debe a que, a partir de la versión 1.3, Compose usa etiquetas de Docker para realizar un seguimiento de los contenedores, y es necesario volver a crear sus contenedores para agregar las etiquetas.

Si Compose detecta contenedores que se crearon sin etiquetas, se niega a ejecutarse, por lo que no termina con dos conjuntos de ellos. Si desea seguir usando sus contenedores existentes (por ejemplo, porque tienen volúmenes de datos que desea preservar), puede usar Compose 1.5.x para migrarlos con el siguiente comando:

docker-compose migrate-to-labels

Alternativamente, si no le preocupa conservarlos, puede eliminarlos. Compose solo crea otros nuevos.

docker container rm -f -v myapp_web_1 myapp_db_1 ...

Desinstalación

Para desinstalar Docker Compose si lo instaló usando curl:

sudo rm /usr/local/bin/docker-compose

Para desinstalar Docker Compose si lo instaló usando pip:

pip uninstall docker-compose

¿Tiene un error de “Permiso denegado”?

Si obtiene un error de “Permiso denegado” utilizando cualquiera de los métodos anteriores, probablemente no tenga los permisos adecuados para eliminar docker-compose. Para forzar la eliminación, anteponga sudo a cualquiera de los comandos anteriores y vuelva a ejecutarlo.

A donde ir después

  • Guía del usuario
  • Empezando
  • Empiece con Django
  • Empiece con Rails
  • Empiece con WordPress
  • Referencia de línea de comando
  • Redactar referencia de archivo

componer, orquestación, Instalar en pc, instalación, estibador, documentación