Docker-Compose 简介及常用命令

一. Docker-Compose 简介

1. Docker-Compose 简介

​ Docker-Compose项目是Docker官方的开源项目，负责实现对Docker容器集群的快速编排。

• Docker-Compose将所管理的容器分为三层，分别是工程（project），服务（service）以及容器（container）。
• Docker-Compose运行目录下的所有文件（docker-compose.yml，extends文件或环境变量文件等）组成一个工程，若无特殊指定工程名即为当前目录名。一个工程当中可包含多个服务，每个服务中定义了容器运行的镜像，参数，依赖。一个服务当中可包括多个容器实例，Docker-Compose并没有解决负载均衡的问题，因此需要借助其它工具实现服务发现及负载均衡。
  Docker-Compose的工程配置文件默认为docker-compose.yml，可通过环境变量COMPOSE_FILE或-f参数自定义配置文件，其定义了多个有依赖关系的服务及每个服务运行的容器。使用一个Dockerfile模板文件，可以让用户很方便的定义一个单独的应用容器。在工作中，经常会碰到需要多个容器相互配合来完成某项任务的情况。例如要实现一个Web项目，除了Web服务容器本身，往往还需要再加上后端的数据库服务容器，甚至还包括负载均衡容器等。Docker-Compose允许用户通过一个单独的docker-compose.yml模板文件（YAML 格式）来定义一组相关联的应用容器为一个项目（project）。
  Docker-Compose项目由Python编写，调用Docker服务提供的API来对容器进行管理。因此，只要所操作的平台支持Docker API，就可以在其上利用Compose来进行编排管理。

2. Docker-Compose安装

可以直接使用pip 进行安装

建议先更新pip 然后在进行安装

pip 更新命令

pip install --upgrade pip

安装命令

pip install docker-compose

安装过后以下命令查看是否安装成功

docker-compose --version

3. Docker-Compose 卸载

卸载命令

pip uninstall docker-compose

二. Docker-Compose常用命令

1. Docker-Compose 命令格式

docker-compose [-f <arg>] [options][command][args]

常用命令选项如下：

-f -file FILE 可指定Compose 模版文件，默认为 docker-compose.yml

-p -project-name NAME指定项目名称，默认将使用所在目录名称为项目名

-v --version 打印版本并退出

-verbose 输出调试信息

-x-network-driver 使用 Docker 的可插拔网络后端特性(需要 Docker 1.9+版本，可操作性有待商榷)

-x-network-deover DRIVER指定网络后端的驱动，默认为 bridge(需要 Docker 1.9+版本)

2. Docker-Compose 拉取服务镜像

docker-compose pull [options] [SERVICE...]

命令选项如下：

–ignore-pull-failures，忽略拉取镜像过程中的错误
–parallel，多个镜像同时拉取
–quiet，拉取镜像过程中不打印进度信息

拉取服务依赖的镜像

docker-compose pull

3. Docker-Compose 构建服务

docker-compose build [options] [--build-arg key=val...] [SERVICE...]

命令选项包括：
–compress 通过gzip压缩构建上下环境
–force-rm 删除构建过程中的临时容器
–no-cache 构建镜像过程中不使用缓存
–pull 始终尝试通过拉取操作来获取更新版本的镜像
-m, –memory MEM为构建的容器设置内存大小
–build-arg key=val为服务设置build-time变量
服务容器一旦构建后，将会带上一个标记名。可以随时在项目目录下运行docker-compose build来重新构建服务

4. Docker-Compose 启动容器

docker-compose start [SERVICE...]

启动已经存在的服务容器

docker-compose start

5. Docker-compose 构建并启动容器

docker-compose up [option][--scale SERVICE=NUM...][SERVICE...]

常用命令选项如下：

-d 在后台运行服务器

-t -timeout TIMEOUT 停止容器是的超时(默认为 10 秒)

-f -file FILE 可指定Compose 模版文件，默认为 docker-compose.yml

-build 在启动容器前自动构建服务镜像

-no-build 不自动构建缺失的镜像

常用命令实例

启动所有服务

docker-compose up

在后台启动所有服务

docker-compose up -d

重新构建镜像

docker-compose up -d --build

-f 使用指定的 Compose 模版文件启动服务,默认为 docker-compose.yml 文件

docker-compose -f docker-compose.yml up

6. Docker-Compose 查看容器

docker-compose ps [options][SERVICE...]

查看项目中运行中的容器

docker-compose ps

查看当前项目中的所有容器

docker-compose ps -a

7. Docker-Compose 停止容器

docker-compose stop [options] [SERVICE...]

命令选项如下：

-t —timeout TIMEOUT停止容器时候的超时(默认为 10 秒)

停止正在运行的容器

docker-compose stop

可使用以下命令再次启动

docker-compose start

通过发送 SIGKILL 信号强制停止服务容器

docker-compsoe kill [options] [SERVICE]

命令选项如下：

-s 指定发送的信号

8. Docker-Compose 移除容器

docker-compose rm [options] [SERVICE...]

命令选项如下：

–f, –force，强制直接删除，包括非停止状态的容器
-v 删除容器所挂载的数据卷

先停止容器

docker-compose stop

删除所有停止状态下的容器

docker-compose rm

9. Docker-Compose 停用移除所有容器以及网络相关

docker-compose down [options]

命令选项如下：

-rmi type，删除镜像、类型必须是：all，删除 compose 文件中定义的所有镜像

​ local， 删除镜像名为空的镜像

-v -volumes 删除已经在 compose 文件中定义的和匿名的附在容器上的数据卷

-remove-orphans 删除服务中没有在 compose 中定义的容器

10. Docker-Compose 查看输出日志

docker-compose logs [options][SERVICE...]

默认情况下，docker-compsoe 将对不同的服务输出使用不同的颜色用以区分，但是可以通过-no-color 关闭颜色

查看服务容器的输出

docker-compose logs

11. Docker-Compose 重启服务

docker-compose restart [options] [SERVICE...]

命令选项如下：

-t –timeout TIMEOUT 指定重启前停止容器的超时（默认为10秒）

重启项目服务

docker-compose restart

12. Docker-Compose 暂停、恢复容器

暂停容器

docker-compose pause [SERVICE...]

恢复处于暂停状态的容器

docker-compsoe unpause [SERVICE...]

13. Docker-Compose 执行命令

docker-compose run [options] [-v VOLUME...] [-p PORT...] [-e KEY=VAL...] SERVICE [COMMAND] [ARGS...]

在指定容器执行 ping 命令

docker-compose run Ubuntu ping www.baidu.com

14. Docker-Compose 指定运行容器数量

设置指定服务运行的容器个数

docker-compose scale web=3 db=2

15. Docker-Compose 推送镜像

docker-compsoe push [options][SERVICE...]

命令选项如下：

–ignore-push-failures 忽略推送镜像过程中的错误