Разделы документации

Установка Docker Compose

На этой странице содержится информация о том, как установить Docker Compose. Вы можете запустить Compose на macOS, Windows и 64-битной Linux.

Требования

Docker Compose использует Docker Engine, поэтому убедитесь, что Docker Engine установлен локально или удаленно, в зависимости от вашей конфигурации.

  • В десктоп системах, таких как Docker Desktop для Mac и Windows, Docker Compose входит в состав установки.

  • В системах Linux сначала установите Docker Engine для вашей ОС, как описано на странице установки Docker, а затем вернитесь сюда для продолжения установки Compose на Linux-системах.

  • Чтобы запустить Compose от имени пользователя без права root, см. раздел Управление Docker от имени пользователя без права root. (добавить ссылку)

Установка Compose

Следуйте инструкциям ниже, чтобы установить Compose на Mac, Windows, Windows Server или Linux, или узнайте об альтернативах, таких как менеджер пакетов pip для Python или установки Compose в качестве контейнера.

Установка Compose на macOS

Docker Desktop для Mac включает в себя Compose вместе с другими приложениями Docker, поэтому пользователям Mac не нужно устанавливать Compose отдельно.

Установка Compose на Windows

Docker Desktop для Windows включает в себя Compose вместе с другими приложениями Docker, по этому пользователям Windows нет необходимости устанавливать Compose отдельно.

Если вы запускаете демон Docker и клиент на Microsoft Windows Server, следуйте инструкциям на вкладке Windows Server.

Установка Compose на Windows Server

Follow these instructions if you are running the Docker daemon and client directly on Microsoft Windows Server and want to install Docker Compose.

  1. Запустите от имени администратора PowerShell. Правый клик по ярлыку PowerShell, а затем выбирите Запустить от имени администратора. Ответьте Да на вопрос разрешить ли приложению делать изменения на устройстве.

  2. Поскольку GitHub теперь требует TLS1.2 выполните в PowerShell слудующую команду:

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

    Затем загрузите последнюю версию Compose командой:

    Invoke-WebRequest "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-Windows-x86_64.exe" -UseBasicParsing -OutFile $Env:ProgramFiles\Docker\docker-compose.exe

Примечание: В Windows Server 2019, вы можете добавить испольняемый файл Compose в $Env:ProgramFiles\Docker. Поскольку этот каталог зарегистрирован в системном PATH, вы можете выполнить команду docker-compose --version на последующем шаге без дополнительной настройки.

Для установки другой версии Compose, замените 1.29.2 на версию Compose, которую вы хотите использовать.

  1. Проверка установки
docker-compose --version
docker-compose version 1.29.2, build 01110ad01

Установка Docker Compose на Linux

В Linux бинарный файл Docker Compose можно загрузить со страницы релиза репозитория Compose на GitHub. Следуйте инструкциям по ссылке, которые включают в себя выполнение команды curl в терминале, чтобы загрузить двоичные файлы. Эти инструкции также описаны ниже.

Для alpine необходимы следующие пакеты: py-pip, python3-dev, libffi-dev, openssl-dev, gcc, libc-dev, rust, cargo и make.

  1. Выполните эту команду для загрузки Docker Compose:

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

    Для установки другой версии замените 1.29.2 на нужный вам номер.

    Если у вас возникли сложности с установкой с помощью curl, читайте альтернативные способы установки.

  2. Дайте права на выполнение бинарному файлу:

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

Примечание: Если после установки команда docker-compose не срабатывает, проверьте путь установки. Вы также можете создать символическую ссылку на /usr/bin или любой другой каталог.

Пример:

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

  1. Опционально существует возможность установить автозаполнение в оболочках bash и zsh.

  2. Проверка установки.

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

Альтернативная установка

Установка с помощью pip

Для alpine необходимы следующие пакеты: py-pip, python3-dev, libffi-dev, openssl-dev, gcc, libc-dev, rust, cargo, and make.

Compose можно установить с сайта pypi с помощью pip. Если вы устанавливаете с помощью pip, мы рекомендуем вам использовать virtualenv, поскольку многие операционные системы системы имеют системные пакеты python, которые конфликтуют с docker-compose зависимостями. Смотрите virtualenv учебник, чтобы начать.

$ pip install docker-compose

Если вы не пользуетесь virtualenv,

$ sudo pip install docker-compose

Минимально необходимая версия pip 6.0.

Установка в контейнере

Compose также можно запустить внутри контейнера, используя небольшую обертку из bash-скрипта. Чтобы установить compose как контейнер, выполните эту команду:

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

Установка пре-релиза

Если вы хотите попробовать предварительную сборку, вы можете загрузить релиз кандидаты со страницы релиза репозитория Compose на GitHub. Следуйте инструкциям по ссылке, которые включают в себя выполнение команды curl в терминале, чтобы загрузить двоичные файлы.

Предварительные версии, собранные из ветки "master", также доступны для загрузки по адресу https://dl.bintray.com/docker-compose/master/.

Предварительные сборки позволяют вам опробовать новые возможности до их выпуска, но могут быть менее стабильными.

Обновление

Если вы переходите с версии Compose 1.2 или более ранней, удалите или мигрируйте существующие контейнеры после обновления Compose. Это связано с тем, что, начиная с версии 1.3, Compose использует метки Docker для отслеживания контейнеров, и ваши контейнеры должны быть созданы заново, чтобы добавить метки.

Если Compose обнаружит контейнеры, которые были созданы без меток, он откажется запускаться. Если вы хотите продолжать использовать существующие контейнеры (например, потому что они содержат данные, которые вы хотите сохранить), вы можете использовать Compose 1.5.x для их миграции с помощью следующей команды:

$ docker-compose migrate-to-labels

Кроме того, если вас не беспокоит их сохранение, вы можете удалить их. Compose просто создает новые.

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

Удаление

Для удаления Docker Compose если вы устанавливали с помощью curl выполните:

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

Для удаления Docker Compose установленного с помощью pip:

$ pip uninstall docker-compose

Увидели ошибку "Permission denied"?

Если вы видите ошибку "Permission denied" при использовании любого из вышеуказанных методов, у вас, вероятно, нет соответствующих прав для удаления docker-compose. Чтобы принудительно удалить, добавьте sudo к любой из вышеуказанных команд и запустите ее снова.

Комментарии:

Комментариев нет, желаете стать первым?

Пожалуйста, авторизуйтесь что бы оставлять комментарии.