安装与卸载

Compose 支持 Linux、macOS、Windows 10 三大平台。

Compose 可以通过 Python 的包管理工具 pip 进行安装,也可以直接下载编译好的二进制文件使用,甚至能够直接在 Docker 容器中运行。

前两种方式是传统方式,适合本地环境下安装使用;最后一种方式则不破坏系统环境,更适合云计算场景。

Docker for MacDocker for Windows 自带 docker-compose 二进制文件,安装 Docker 之后可以直接使用。

  1. $ docker-compose --version
  2. docker-compose version 1.17.1, build 6d101fb

Linux 系统请使用以下介绍的方法安装。

二进制包

在 Linux 上的也安装十分简单,从 官方 GitHub Release 处直接下载编译好的二进制文件即可。

例如,在 Linux 64 位系统上直接下载对应的二进制包。

  1. $ sudo curl -L https://github.com/docker/compose/releases/download/1.17.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
  2. $ sudo chmod +x /usr/local/bin/docker-compose

PIP 安装

注: x86_64 架构的 Linux 建议按照上边的方法下载二进制包进行安装,如果您计算机的架构是 ARM (例如,树莓派),再使用 pip 安装。

这种方式是将 Compose 当作一个 Python 应用来从 pip 源中安装。

执行安装命令:

  1. $ sudo pip install -U docker-compose

可以看到类似如下输出,说明安装成功。

  1. Collecting docker-compose
  2. Downloading docker-compose-1.17.1.tar.gz (149kB): 149kB downloaded
  3. ...
  4. Successfully installed docker-compose cached-property requests texttable websocket-client docker-py dockerpty six enum34 backports.ssl-match-hostname ipaddress

bash 补全命令

  1. $ curl -L https://raw.githubusercontent.com/docker/compose/1.8.0/contrib/completion/bash/docker-compose > /etc/bash_completion.d/docker-compose

容器中执行

Compose 既然是一个 Python 应用,自然也可以直接用容器来执行它。

  1. $ curl -L https://github.com/docker/compose/releases/download/1.8.0/run.sh > /usr/local/bin/docker-compose
  2. $ chmod +x /usr/local/bin/docker-compose

实际上,查看下载的 run.sh 脚本内容,如下

  1. set -e
  2. VERSION="1.8.0"
  3. IMAGE="docker/compose:$VERSION"
  4. # Setup options for connecting to docker host
  5. if [ -z "$DOCKER_HOST" ]; then
  6. DOCKER_HOST="/var/run/docker.sock"
  7. fi
  8. if [ -S "$DOCKER_HOST" ]; then
  9. DOCKER_ADDR="-v $DOCKER_HOST:$DOCKER_HOST -e DOCKER_HOST"
  10. else
  11. DOCKER_ADDR="-e DOCKER_HOST -e DOCKER_TLS_VERIFY -e DOCKER_CERT_PATH"
  12. fi
  13. # Setup volume mounts for compose config and context
  14. if [ "$(pwd)" != '/' ]; then
  15. VOLUMES="-v $(pwd):$(pwd)"
  16. fi
  17. if [ -n "$COMPOSE_FILE" ]; then
  18. compose_dir=$(dirname $COMPOSE_FILE)
  19. fi
  20. # TODO: also check --file argument
  21. if [ -n "$compose_dir" ]; then
  22. VOLUMES="$VOLUMES -v $compose_dir:$compose_dir"
  23. fi
  24. if [ -n "$HOME" ]; then
  25. VOLUMES="$VOLUMES -v $HOME:$HOME -v $HOME:/root" # mount $HOME in /root to share docker.config
  26. fi
  27. # Only allocate tty if we detect one
  28. if [ -t 1 ]; then
  29. DOCKER_RUN_OPTIONS="-t"
  30. fi
  31. if [ -t 0 ]; then
  32. DOCKER_RUN_OPTIONS="$DOCKER_RUN_OPTIONS -i"
  33. fi
  34. exec docker run --rm $DOCKER_RUN_OPTIONS $DOCKER_ADDR $COMPOSE_OPTIONS $VOLUMES -w "$(pwd)" $IMAGE "$@"

可以看到,它其实是下载了 docker/compose 镜像并运行。

卸载

如果是二进制包方式安装的,删除二进制文件即可。

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

如果是通过 pip 安装的,则执行如下命令即可删除。

  1. $ sudo pip uninstall docker-compose