На этой странице содержится информация о том, как установить 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 на Mac, Windows, Windows Server или Linux, или узнайте об альтернативах, таких как менеджер пакетов pip
для Python или установки Compose в качестве контейнера.
Docker Desktop для Mac включает в себя Compose вместе с другими приложениями Docker, поэтому пользователям Mac не нужно устанавливать Compose отдельно.
Docker Desktop для Windows включает в себя Compose вместе с другими приложениями Docker, по этому пользователям Windows нет необходимости устанавливать Compose отдельно.
Если вы запускаете демон Docker и клиент на Microsoft Windows Server, следуйте инструкциям на вкладке 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.
Запустите от имени администратора PowerShell. Правый клик по ярлыку PowerShell, а затем выбирите Запустить от имени администратора. Ответьте Да на вопрос разрешить ли приложению делать изменения на устройстве.
Поскольку 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, которую вы хотите использовать.
docker-compose --version
docker-compose version 1.29.2, build 01110ad01
В Linux бинарный файл Docker Compose можно загрузить со
страницы релиза репозитория Compose на GitHub. Следуйте инструкциям по ссылке, которые включают в себя выполнение команды curl
в терминале, чтобы загрузить двоичные файлы. Эти инструкции
также описаны ниже.
Для
alpine
необходимы следующие пакеты:py-pip
,python3-dev
,libffi-dev
,openssl-dev
,gcc
,libc-dev
,rust
,cargo
иmake
.
Выполните эту команду для загрузки 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
, читайте альтернативные способы установки.
Дайте права на выполнение бинарному файлу:
$ sudo chmod +x /usr/local/bin/docker-compose
Примечание: Если после установки команда
docker-compose
не срабатывает, проверьте путь установки. Вы также можете создать символическую ссылку на /usr/bin или любой другой каталог.
Пример:
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
Опционально существует возможность установить автозаполнение в оболочках bash
и zsh
.
Проверка установки.
$ docker-compose --version
docker-compose version , build 1110ad01
Для
alpine
необходимы следующие пакеты:py-pip
,python3-dev
,libffi-dev
,openssl-dev
,gcc
,libc-dev
,rust
,cargo
, andmake
.
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
к любой из вышеуказанных команд и запустите ее снова.
Комментарии:
Пожалуйста, авторизуйтесь что бы оставлять комментарии.