Docker-Compose 简介及常用命令

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 更新命令

1
pip install --upgrade pip

安装命令

1
pip install docker-compose

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

1
docker-compose --version

3. Docker-Compose 卸载

卸载命令

1
pip uninstall docker-compose

二. Docker-Compose常用命令

1. Docker-Compose 命令格式

1
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 拉取服务镜像

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

命令选项如下:

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

拉取服务依赖的镜像

1
docker-compose pull

3. Docker-Compose 构建服务

1
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 启动容器

1
docker-compose start [SERVICE...]

启动已经存在的服务容器

1
docker-compose start

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

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

常用命令选项如下:

-d 在后台运行服务器

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

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

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

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

常用命令实例

启动所有服务

1
docker-compose up

在后台启动所有服务

1
docker-compose up -d

重新构建镜像

1
docker-compose up -d --build

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

1
docker-compose -f docker-compose.yml up

6. Docker-Compose 查看容器

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

查看项目中运行中的容器

1
docker-compose ps

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

1
docker-compose ps -a

7. Docker-Compose 停止容器

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

命令选项如下:

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

停止正在运行的容器

1
docker-compose stop

可使用以下命令再次启动

1
docker-compose start

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

1
docker-compsoe kill [options] [SERVICE]

命令选项如下:

-s 指定发送的信号

8. Docker-Compose 移除容器

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

命令选项如下:

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

先停止容器

1
docker-compose stop

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

1
docker-compose rm

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

1
docker-compose down [options]

命令选项如下:

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

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

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

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

10. Docker-Compose 查看输出日志

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

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

查看服务容器的输出

1
docker-compose logs

11. Docker-Compose 重启服务

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

命令选项如下:

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

重启项目服务

1
docker-compose restart

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

暂停容器

1
docker-compose pause [SERVICE...]

恢复处于暂停状态的容器

1
docker-compsoe unpause [SERVICE...]

13. Docker-Compose 执行命令

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

在指定容器执行 ping 命令

1
docker-compose run Ubuntu ping www.baidu.com

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

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

1
docker-compose scale web=3 db=2

15. Docker-Compose 推送镜像

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

命令选项如下:

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


本博客所有文章除特别声明外,均采用 CC BY-SA 4.0 协议 ,转载请注明出处!