Install Docker Compose

预计阅读时间:8分钟

加速 Docker Desktop 中的新功能

Docker Desktop 可帮助您在 Mac 和 Windows 上轻松构建、共享和运行容器,就像在 Linux 上一样. Docker 处理复杂的设置并允许您专注于编写代码. 感谢我们在订阅更新方面获得的积极支持,我们已经开始着手开发适用于 Linux 的 Docker Desktop,这是我们公共路线图中第二受欢迎的功能请求. 如果您对抢先体验感兴趣,请注册我们的开发者预览计划.

此页面包含有关如何安装 Docker Compose 的信息. 您可以在 macOS、Windows 和 64 位 Linux 上运行 Compose.

Prerequisites

Docker Compose 依赖 Docker Engine 来完成任何有意义的工作,因此请确保您在本地或远程安装了 Docker Engine,具体取决于您的设置.

  • 在 Docker Desktop for Mac 和 Windows 等桌面系统上,Docker Compose 包含在这些桌面安装中.

  • 在 Linux 系统上,您可以使用便捷脚本安装 Docker Compose 和 Docker 引擎. 为您的发行版选择安装 Docker Engine 页面,然后查找有关使用便捷脚本进行安装的说明.
    否则,您应该首先为您的操作系统安装Docker 引擎,然后参阅此页面以获取有关在 Linux 系统上安装 Compose 的说明.

  • 要以非 root 用户身份运行 Compose,请参阅以非 root 用户身份管理 Docker .

Install Compose

按照以下说明在 Mac、Windows、Windows Server 或 Linux 系统上安装 Compose.

安装不同的版本

以下说明概述了 Compose 当前稳定版本 ( v2.5.0 ) 的安装. 要安装不同版本的 Compose,请将给定的版本号替换为您想要的版本号.

还列出了 Compose 版本,可在 GitHub 上的 Compose 存储库发布页面上直接下载.

要安装 Compose 的 Python 版本,请按照Compose v1 GitHub 分支中的说明进行操作.

Install Compose on macOS

Docker Desktop for Mac包括 Compose 以及其他 Docker 应用程序,因此 Mac 用户无需单独安装 Compose. 有关安装说明,请参阅在 Mac 上安装 Docker Desktop .

Install Compose on Windows desktop systems

Docker Desktop for Windows包括 Compose 以及其他 Docker 应用程序,因此大多数 Windows 用户不需要单独安装 Compose. 有关安装说明,请参阅在 Windows 上安装 Docker Desktop .

如果您直接在 Microsoft Windows Server 上运行 Docker 守护程序和客户端,请按照 Windows Server 选项卡中的说明进行操作.

Install Compose on Windows Server

如果您直接在 Microsoft Windows Server 上运行 Docker 守护程序和客户端并且想要安装 Docker Compose,请按照这些说明进行操作.

  1. 启动一个"提升的"PowerShell(以管理员身份运行). 搜索 PowerShell,右键单击并选择Run as administrator . 当系统询问您是否要允许此应用对您的设备进行更改时,请单击.

  2. 在 PowerShell 中,由于 GitHub 现在需要 TLS1.2,请运行以下命令:

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

    然后运行以下命令下载 Compose 的当前稳定版本(v2.5.0):

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

    Note

    在 Windows Server 2019 上,您可以将 Compose 可执行文件添加到$Env:ProgramFiles\Docker . 由于此目录已在系统PATH中注册,因此您可以在后续步骤中运行docker-compose --version命令,无需额外配置.

    要安装不同版本的 Compose, v2.5.0替换为您要使用的 Compose 版本.

  3. 测试安装.

    $ docker compose version
    Docker Compose version v2.5.0
    

Install Compose on Linux systems

您可以根据需要以不同的方式安装 Docker Compose:

Install using the convenience script

由于 Docker Compose 现在是 Docker CLI 的一部分,因此可以通过带有 Docker Engine 和 CLI 的便捷脚本进行安装.
选择您的 Linux 发行版并按照说明进行操作.

Install using the repository

如果您已经按照说明安装 Docker Engine,则应该已经安装了 Docker Compose.
否则,您可以按照 Docker Engine 安装中的说明设置 Docker 存储库,选择您的 Linux 发行版并转到Set up the repository部分.

等结束了

  1. 更新apt包索引,安装最新版本的 Docker Compose,或者进入下一步安装特定版本:

     $ sudo apt-get update
     $ sudo apt-get install docker-compose-plugin
    
  2. 要安装特定版本的 Docker Engine,请在 repo 中列出可用版本,然后选择并安装:

    一种. 列出您的存储库中可用的版本:

    $ apt-cache madison docker-compose-plugin
    
      docker-compose-plugin | 2.3.3~ubuntu-focal | https://download.docker.com/linux/ubuntu focal/stable arm64 Packages
    

    湾. 使用第二列中的版本字符串安装特定版本,例如2.3.3~ubuntu-focal .

    $ sudo apt-get install docker-compose-plugin=<VERSION_STRING>
    
  3. 通过检查版本来验证 Docker Compose 是否已正确安装.

    $ docker compose version
    Docker Compose version v2.3.3
    

Install the binary manually

在 Linux 上,您可以从GitHub 上的 Compose 存储库发布页面下载 Docker Compose 二进制文件,并将其作为 docker docker-compose复制到$HOME/.docker/cli-plugins中. 按照链接中的说明进行操作,其中涉及在终端中运行curl命令以下载二进制文件. 这些分步说明也包括在下面.

  1. 运行以下命令下载 Docker Compose 的当前稳定版本:

    $ DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
    $ mkdir -p $DOCKER_CONFIG/cli-plugins
    $ curl -SL https://github.com/docker/compose/releases/download/v2.5.0/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose
    

    此命令在$HOME目录下为活动用户安装 Compose. 要为系统上的所有用户安装 Docker Compose,请将~/.docker/cli-plugins替换为/usr/local/lib/docker/cli-plugins .

    要安装不同版本的 Compose, v2.5.0替换为您要使用的 Compose 版本.

  2. 对二进制文件应用可执行权限:

     $ chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose
    

    或者如果您选择为所有用户安装 Compose

     $ sudo chmod +x /usr/local/lib/docker/cli-plugins/docker-compose
    
  3. 测试安装.

     $ docker compose version
     Docker Compose version v2.5.0
    

Install Compose as standalone binary on Linux systems

您可以将 Compose 用作独立的二进制文件,而无需安装 Docker CLI.

  1. 运行以下命令下载 Docker Compose 的当前稳定版本:
  $ curl -SL https://github.com/docker/compose/releases/download/v2.5.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose

要安装不同版本的 Compose, v2.5.0替换为您要使用的 Compose 版本.

  1. 对二进制文件应用可执行权限:
  $ sudo chmod +x /usr/local/bin/docker-compose

Note:

如果安装后命令docker-compose失败,请检查您的路径. 您还可以创建指向/usr/bin或路径中任何其他目录的符号链接.

例如:

$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
  1. 测试安装.

     $ docker-compose --version
     Docker Compose version v2.5.0
    

Uninstallation

如果使用curl安装,要卸载 Docker Compose:

$ rm $DOCKER_CONFIG/cli-plugins/docker-compose

或者如果您选择为所有用户安装 Compose

$ sudo rm /usr/local/lib/docker/cli-plugins/docker-compose

收到"权限被拒绝"错误?

If you get a “Permission denied” error using either of the above methods, you probably do not have the proper permissions to remove docker-compose. To force the removal, prepend sudo to either of the above commands and run again.

Where to go next

compose, orchestration, install, installation, docker, documentation

by  icopy.site