Как установить docker compose
Install Docker Compose
Estimated reading time: 8 minutes
Accelerating new features in Docker Desktop
Docker Desktop helps you build, share, and run containers easily on Mac and Windows as you do on Linux. Docker handles the complex setup and allows you to focus on writing the code. Thanks to the positive support we received on the subscription updates, we’ve started working on Docker Desktop for Linux which is the second-most popular feature request in our public roadmap. If you are interested in early access, sign up for our Developer Preview program.
This page contains information on how to install Docker Compose. You can run Compose on macOS, Windows, and 64-bit Linux.
Prerequisites
Docker Compose relies on Docker Engine for any meaningful work, so make sure you have Docker Engine installed either locally or remote, depending on your setup.
On desktop systems like Docker Desktop for Mac and Windows, Docker Compose is included as part of those desktop installs.
On Linux systems, first install the Docker Engine for your OS as described on the Get Docker page, then come back here for instructions on installing Compose on Linux systems.
To run Compose as a non-root user, see Manage Docker as a non-root user.
Install Compose
Follow the instructions below to install Compose on Mac, Windows, Windows Server 2016, or Linux systems, or find out about alternatives like using the pip Python package manager or installing Compose as a container.
The instructions below outline installation of the current stable release (v1.29.2) of Compose. To install a different version of Compose, replace the given release number with the one that you want. For instructions to install Compose 2.0.0 on Linux, see Install Compose 2.0.0 on Linux.
Compose releases are also listed and available for direct download on the Compose repository release page on GitHub. To install a pre-release of Compose, refer to the install pre-release builds section.
Install Compose on macOS
Docker Desktop for Mac includes Compose along with other Docker apps, so Mac users do not need to install Compose separately. For installation instructions, see Install Docker Desktop on Mac.
Install Compose on Windows desktop systems
Docker Desktop for Windows includes Compose along with other Docker apps, so most Windows users do not need to install Compose separately. For install instructions, see Install Docker Desktop on Windows.
If you are running the Docker daemon and client directly on Microsoft Windows Server, follow the instructions in the Windows Server tab.
Install Compose on 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.
Start an “elevated” PowerShell (run it as administrator). Search for PowerShell, right-click, and choose Run as administrator. When asked if you want to allow this app to make changes to your device, click Yes.
In PowerShell, since GitHub now requires TLS1.2, run the following:
Then run the following command to download the current stable release of Compose (v1.29.2):
Test the installation.
Install Compose on Linux systems
On Linux, you can download the Docker Compose binary from the Compose repository release page on GitHub. Follow the instructions from the link, which involve running the curl command in your terminal to download the binaries. These step-by-step instructions are also included below.
Run this command to download the current stable release of Docker Compose:
To install a different version of Compose, substitute 1.29.2 with the version of Compose you want to use.
Apply executable permissions to the binary:
Note: If the command docker-compose fails after installation, check your path. You can also create a symbolic link to /usr/bin or any other directory in your path.
Optionally, install command completion for the bash and zsh shell.
Test the installation.
Alternative install options
Install using pip
If you are not using virtualenv,
pip version 6.0 or greater is required.
Install as a container
Compose can also be run inside a container, from a small bash script wrapper. To install compose as a container run this command:
Install pre-release builds
If you’re interested in trying out a pre-release build, you can download release candidates from the Compose repository release page on GitHub. Follow the instructions from the link, which involves running the curl command in your terminal to download the binaries.
Pre-releases built from the “master” branch are also available for download at https://dl.bintray.com/docker-compose/master/.
Pre-release builds allow you to try out new features before they are released, but may be less stable.
Upgrading
If you’re upgrading from Compose 1.2 or earlier, remove or migrate your existing containers after upgrading Compose. This is because, as of version 1.3, Compose uses Docker labels to keep track of containers, and your containers need to be recreated to add the labels.
If Compose detects containers that were created without labels, it refuses to run, so that you don’t end up with two sets of them. If you want to keep using your existing containers (for example, because they have data volumes you want to preserve), you can use Compose 1.5.x to migrate them with the following command:
Alternatively, if you’re not worried about keeping them, you can remove them. Compose just creates new ones.
Uninstallation
To uninstall Docker Compose if you installed using curl :
To uninstall Docker Compose if you installed using pip :
Got a “Permission denied” error?
Использование Docker Compose
Docker Compose — это средство, разработанное для помощи в определении и совместном использовании многоконтейнерных приложений. С помощью средства Compose можно создать файл YAML для определения служб и с помощью одной команды запускать и останавливать все, что нужно.
Большим преимуществом использования Compose является то, что можно определить стек приложения в файле, сохранить его в корне репозитория проекта (теперь поддерживается управление версиями) и легко предоставить другому пользователю возможность участвовать в проекте. Другому пользователю достаточно будет только клонировать репозиторий и начать создание приложения. Фактически в GitHub и GitLab можно увидеть достаточно много проектов, использующих эту возможность.
С чего же начать работу?
Установка Docker Compose
Если вы установили Docker Desktop для Windows или Mac, то у вас уже есть Docker Compose. В экземплярах «Play-with-Docker» уже установлен Docker Compose. Если вы используете компьютер Linux, необходимо установить Docker Compose с помощью приведенных здесь инструкций.
После установки вы сможете запустить следующую команду и просмотреть сведения о версии.
Создание файла Compose
Написание файла Compose начнем с определения версии схемы. В большинстве случаев лучше использовать последнюю поддерживаемую версию. Текущие версии схемы и матрицу совместимости см. в справочнике по файлу Compose.
Затем определим список служб (или контейнеров), которые требуется использовать как часть приложения.
Теперь приступим к переносу службы в файл Compose.
Определение службы приложений
Напомним, что эту команду вы использовали для определения контейнера приложения (замените в Windows PowerShell символы \ на символы ` ).
Сначала определите запись службы и образ для контейнера. Для службы можно выбрать любое имя. Имя будет автоматически преобразовано в сетевой псевдоним, что будет полезно при определении службы MySQL.
Одним из преимуществ определений томов Docker Compose является использование относительных путей из текущего каталога.
Определение службы MySQL
Теперь пора определить службу MySQL. Для этого контейнера использовалась следующая команда (замените в Windows PowerShell символы \ на символы ` ).
Наконец, осталось указать переменные среды.
На этом этапе полный файл docker-compose.yml должен выглядеть следующим образом.
Запуск стека приложений
После запуска должны отобразиться примерно следующие выходные данные.
Вы увидите, что том был создан, так же как и сеть. По умолчанию Docker Compose автоматически создает сеть специально для стека приложений (поэтому мы не определили его в файле Compose).
Если вы еще этого не сделали, вы увидите следующий результат.
Ожидание базы данных перед запуском приложения. При запуске приложения оно фактически ожидает, пока MySQL будет готов к работе, прежде чем попытаться подключиться к нему. В Docker отсутствует встроенная поддержка, позволяющая ожидать, пока другой контейнер будет полностью готов, запущен и подготовится к запуску другого контейнера. Для проектов на основе узлов можно использовать зависимость wait-port. Аналогичные проекты существуют для других языков и платформ.
На этом этапе вы сможете открыть приложение и увидеть, что оно запускается. И постойте! Вы сделали это с помощью одной команды!
Просмотр стека приложений в расширении Docker
Если взглянуть на расширение Docker, там можно изменить параметры группировки с помощью меню «шестеренки» и пункта «Group By» (группировать). В нашем случае необходимо просмотреть контейнеры, сгруппированные по имени проекта Compose.
Если развернуть сеть, вы увидите два контейнера, которые вы определили в файле Compose.
Завершение работы
Когда необходимо завершить работу, просто выполните команду docker-compose down или щелкните правой кнопкой мыши приложение в списке контейнеров в расширении Docker VS Code и выберите Compose Down (завершить Compose). Контейнеры будут остановлены, а сеть удалена.
После завершения работы можно переключиться на другой проект, запустить docker-compose up и подготовиться к работе с этим проектом. На самом деле нет ничего проще!
Резюме
В этом разделе вы узнали о средстве Docker Compose и о том, как оно помогает значительно упростить определение и совместное использование приложений с несколькими службами. Вы создали файл Compose, переведя команды в соответствующий формат.
Сейчас начинается завершающий этап обучения. Однако есть несколько рекомендаций по созданию образов, которые необходимо осветить, поскольку есть большая проблема с Dockerfile, который вы использовали. Так что давайте взглянем на это.
Установка и использование Docker Compose в Ubuntu 20.04
Published on July 16, 2020
Введение
Docker упрощает управление процессами приложений в контейнерах. Хотя контейнеры в некоторых отношениях аналогичны виртуальным машинам, они более компактные и более эффективно используют ресурсы. Это позволяет разработчикам разбить среду приложения на несколько изолированных служб.
Если приложение использует несколько служб, организация совместного запуска, взаимодействия и отключения всех контейнеров быстро станет неудобной. Docker Compose — инструмент, позволяющий запускать среды приложений с несколькими контейнерами на основе определений, задаваемых в файле YAML. Он использует определения служб для построения полностью настраиваемых сред с несколькими контейнерами, которые могут использовать общие сети и тома хранения данных.
В этом обучающем модуле мы покажем, как установить Docker Compose на сервере под управлением Ubuntu 20.04 и начать использовать этот инструмент.
Предварительные требования
Для его выполнения вам потребуется следующее:
Шаг 1 — Установка Docker Compose
Чтобы получить самую последнюю стабильную версию Docker Compose, мы загрузим это программное обеспечение из официального репозитория Github.
Затем необходимо задать правильные разрешения, чтобы сделать команду docker-compose исполняемой:
Чтобы проверить успешность установки, запустите следующую команду:
Вывод будет выглядеть следующим образом:
Установка Docker Compose успешно выполнена. В следующем разделе мы покажем, как настроить файл docker-compose.yml и запустить контейнерную среду с помощью этого инструмента.
Шаг 2 — Настройка файла docker-compose.yml
Чтобы продемонстрировать настройку файла docker-compose.yml и его работу с Docker Compose, мы создадим среду веб-сервера, используя официальный образ Nginx из Docker Hub, публичного реестра Docker. Контейнерная среда будет обслуживать один статичный файл HTML.
Для начала создайте новый каталог в домашнем каталоге и перейдите в него:
Настройте в этом каталоге папку приложения, которая будет выступать в качестве корневого каталога документов для вашей среды Nginx:
Создайте в предпочитаемом текстовом редакторе новый файл index.html в папке app :
Вставьте в файл следующее содержимое:
Затем создайте файл docker-compose.yml :
Вставьте в файл docker-compose.yml следующее содержимое:
Сохраните и закройте файл.
Мы настроили демонстрационную страницу и файл docker-compose.yml для создания контейнерной среды веб-сервера, которая будет обслуживать ее. На следующем шаге мы запустим эту среду с помощью Docker Compose.
Шаг 3 — Запуск Docker Compose
Docker Compose будет вначале искать заданный образ в локальной системе, и если не найдет его, загрузит его из Docker Hub. Вывод будет выглядеть следующим образом:
Теперь ваша среда запущена в фоновом режиме. Для проверки активности контейнера используйте следующую команду:
Эта команда покажет вам информацию о работающих контейнерах и их состоянии, а также о действующей переадресации портов:
Страница будет выглядеть следующим образом:
На следующем шаге вы увидите, как управлять контейнерной средой с помощью команд Docker Compose.
Шаг 4 — Знакомство с командами Docker Compose
Чтобы посмотреть журналы контейнера Nginx, используйте команду logs :
Вывод будет выглядеть следующим образом:
Если вы хотите приостановить работу среды без изменения текущего состояния ваших контейнеров, используйте команду:
Чтобы возобновить работу после приостановки, используйте команду:
Команда stop останавливает выполнение контейнера, но не уничтожает данные, связанные с вашими контейнерами:
Если вы хотите удалить контейнеры, сети и тома, связанные с контейнерной средой, используйте команду down :
Обратите внимание, что при этом не будет удален базовый образ, используемый Docker Compose для запуска нашей среды (в нашем примере nginx:alpine ). Так, при повторном запуске среды с помощью команды docker-compose up процесс будет намного быстрее, поскольку образ уже находится в вашей системе.
Если вы хотите удалить из системы базовый образ, используйте команду:
Примечание. Чтобы получить более подробное описание команд Docker, ознакомьтесь с нашим руководством по установке и использованию Docker.
Заключение
В этом обучающем модуле мы рассмотрели процедуры установки Docker Compose и настройки контейнерной среды на базе образа веб-сервера Nginx. Также мы увидели, как можно управлять этой средой с помощью команд Compose.
Полный справочник всех доступных команд docker-compose можно найти в официальной документации.
Как установить Docker Compose в Ubuntu 18.04
Шаги для установки Docker Compose в Ubuntu
Обновление программных репозиториев и пакетов
Начните с обновления репозиториев программного обеспечения и пакетов программ. Откройте окно терминала и введите следующее:
Система должна реагировать, как показано на рисунке ниже:
Чтобы установить curl, введите следующее:
Загрузите последнюю версию Docker Compose
Эта команда загрузит Docker Container последней версии. (На момент написания этой статьи, Docker Compose 1.25.5 является последней версией.)
Вам не нужно запускать скрипт установки для Docker Compose. После загрузки программное обеспечение готово к использованию.
Проверка установлен ли Docker Compose
Чтобы проверить успешность установки, проверьте версию с помощью:
Вывод должен выглядеть примерно так:
Как удалить Docker Compose
Чтобы удалить Docker Compose, просто удалите бинарный файл:
Если вы установили Docker Compose с помощью apt-get, используйте следующую команду для удаления пакета:
Начало работы с Docker Compose
Запустите контейнер для примера с Docker Compose
YAML – это тип файла конфигурации. Этот файл создаст контейнер с именем test-file на основе образа Hello World в Docker Hub.
Если в вашей системе уже есть образы, вы можете отобразить список с помощью команды:
Выполнение этой команды сейчас создаст пустой список. Docker автоматически загрузит образ на основе этого файла конфигурации.
Docker-compose теперь создает контейнер и запускает программу hello. Это действие подтверждает, что установка работает.
Он также отображает объяснение выполненных действий:
После завершения этой операции Docker закрывает контейнер. Вы должны увидеть командную строку в конце вывода.
Список Docker изображений и контейнеров
Чтобы отобразить список всех изображений Docker, хранящихся локально:
Для просмотра списка всех контейнеров используйте:
Чтобы просмотреть все запущенные в данный момент контейнеры:
Обратите внимание, что этот список пуст. Это показывает, что как только образ hello-world завершается, он автоматически закрывается.
Удалить образ Docker и контейнер
Чтобы удалить изображение Docker, вам нужно знать его IMAGE ID. Используйте команду для перечисления изображений из отрывка выше, чтобы скопировать эту информацию.
Получив идентификатор, запустите следующий синтаксис, чтобы стереть это изображение:
Вы также можете использовать эту команду для удаления нескольких образов Docker:
Для удаления контейнера Docker используйте:
Замените [CONTAINER_ID] фактическим идентификатором контейнера.
Поскольку это тест, нам не нужно связывать дисковое пространство со старыми образами. Вот почему мы сотрем пример изображения. Вы не сможете удалить изображение, пока не удалите все контейнеры, связанные с ним.
Сначала удалите контейнер:
Поскольку вы использовали только один контейнер, вы сможете удалить изображение:
Вывод
Теперь вы знаете, как установить и использовать Docker Compose в Ubuntu 18.04. Начните создавать и управлять новыми контейнерами.
Установка Docker Compose в Ubuntu 20.04
Docker – очень полезный инструмент, который упрощает управление процессами и приложениями в контейнерах. Контейнеры во многом похожи на виртуальные машины, но они гораздо легче и потребляют меньше ресурсов.
При работе со сложными приложениями, зависящими от нескольких сервисов, управлять контейнерами и синхронизировать их работу – задача довольно непростая. Docker Compose – это инструмент, разработанный сообществом, который позволяет вам запускать мультиконтейнерные приложения, основанные на определениях из фала YAML. Определения сервисов позволяют собирать гибкие пользовательские среды с большим количеством контейнеров, которые могут совместно использовать сети и тома данных.
Данный мануал поможет установить Docker Compose в Ubuntu 20.04 и научит использовать его.
Требования
1: Установка Docker Compose
Установить Docker Compose можно из официального репозитория Ubuntu, однако тогда вы получите не самую свежую версию, потому лучше установить программу из GitHub-репозитория Docker.
Найдите ссылку на свежий релиз на этой странице. На данный момент это версия 1.26.0.
Следующая команда загрузит эту версию и сохранит исполняемый файл в /usr/local/bin/docker-compose, что сделает его глобально доступным как docker-compose:
Теперь установите права и сделайте файл исполняемым:
sudo chmod +x /usr/local/bin/docker-compose
Запросите версию программы, чтобы убедиться, что установка прошла успешно:
Команда должна вернуть:
docker-compose version 1.26.0, build 8a1c60f6
Инструмент Docker Compose успешно установлен. Теперь можно настроить файл docker-compose.yml, чтобы инструмент смог запускать контейнеризованные системы.
2: Настройка docker-compose.yml
Чтобы продемонстрировать, как настроить файл docker-compose.yml и работать с Docker Compose, мы создадим тестовую среду для веб-сервера, используя официальный образ Nginx из Docker Hub, публичного реестра Docker. Эта контейнерная среда будет обслуживать один статический HTML-файл.
Создайте в домашнем каталоге новый каталог, а затем перейдите в него:
В этом каталоге создайте папку приложения, которая будет корневым каталогом для вашей среды Nginx:
Используя любой удобный текстовый редактор, создайте новый файл index.html в папке app:
Поместите в этот файл следующий контент:
This is a Docker Compose Demo Page.
This content is being served by an Nginx container.