Docker Compose 介绍 、安装 、命令

一、单机编排之Docker Compose 介绍
当在宿主机启动较多的容器时候,如果都是手动操作会觉得比较麻烦而且容易出错,此时推荐使用docker 单机编排工具 docker-compose

docker-compose 是 docker 容器的一种单机编排服务,docker-compose 是一个管理多个容器的工具,比如:可以解决容器之间的依赖关系,
就像启动一个nginx 前端服务的时候会调用后端的tomcat,那就得先启动tomcat,但是启动tomcat 容器还需要依赖数据库,
那就还得先启动数据库,docker-compose 可以用来解决这样的嵌套依赖关系,并且可以替代docker命令对容器进行创建、
启动和停止等手工的操作因此,如果说docker命令就像linux的命令,docker compse就像shell脚本,可以自动的执行容器批量操作,
从而实现自动化的容器管理,或者说docker命令相当于ansible命令,那么docker compose文件,就相当于ansible-playbook的yaml文件

docker-compose 项目是Docker 官方的开源项目,负责实现对Docker 容器集群的快速编排,docker-compose 将所管理的容器分为三层,
分别是工程(project),服务(service)以及容器(container)(swarm中有介绍)


二、安装Docker Compose
方法1:通过pip安装
python-pip 包将安装一个 pip 的命令,pip 命令是一个pyhton 安装包的安装工具,其类似于ubuntu 的apt 或者 redhat 的yum,
但是pip 只安装 python 相关的安装包,可以在多种操作系统安装和使用pip
# yum install python3-pip
# pip3 install --upgrade pip
# pip3 install docker-compose

方法2:直接从github下载安装对应版本
wget  https://github.com/docker/compose/releases/download/1.25.3/docker-compose   -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

方法3:直接从包仓库安装
此方法安装的版本较旧,不推荐使用

#ubuntu安装
[root@ubuntu1804 ~]#apt -y install docker-compose
[root@ubuntu1804 ~]#docker-compose --version
docker-compose version 1.17.1, build unknown

#CentOS7安装,依赖EPEL源
[root@centos7 ~]#yum -y install docker-compose
[root@centos7 ~]#docker-compose --version
docker-compose version 1.18.0, buil 8dd22a9




三、docker-compose  命令和参数
	-f,–file FILE指定Compose模板文件,默认为docker-compose.yml,可以多次指定。
	-p,–project-name NAME指定项目名称,默认将使用所在目录名称作为项目名。
	-x-network-driver 使用Docker的可拔插网络后端特性(需要Docker 1.9+版本)
	-x-network-driver DRIVER指定网络后端的驱动,默认为bridge(需要Docker 1.9+版本)
	-verbose输出更多调试信息
	-v,–version打印版本并退出
	 --log-level LEVEL #定义日志级别 (DEBUG, INFO, WARNING, ERROR, CRITICAL) 
	 --no-ansi #不显示 ANSI 控制字符

多个配置文件
我们可以为同一个项目配置多个compose文件,使用多个 Compose 文件使您能够针对不同的环境或不同的工作流程自定义 Compose 应用程序。
默认情况下,Compose 读取两个文件,docker-compose.yml和一个可选的docker-compose.override.yml文件。按照惯例,
docker-compose.yml包含您的基本配置。override.yml 文件,顾名思义,就是包含现有服务或全新服务的配置覆盖。
如果在两个文件中都定义了服务,Compose 会使用 override 进行合并配置。
要使用多个覆盖文件或具有不同名称的覆盖文件,您可以使用该-f选项来指定文件列表。Compose 按照在命令行中指定的顺序合并文件。
当您使用多个配置文件时,您必须确保文件中的所有路径都相对于基本 Compose 文件( 指定的第一个 Compose 文件-f)
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d  build       Build or rebuild services
 

命令参数 
build       #从docker-compose 构建(重新构建)项目中的服务容器
bundle      #从当前 docker compose 文件生成一个以当前目录为名称的从 Compose 文件生成一个分布式应用程序捆绑包(DAB)
config      #查看当前配置,没有错误不输出任何信息 
create      #创建服务
down        #停止并删除容器、网络、图像和卷
events      #从容器接收实时事件,可以指定 json 日志格式,如 docker-compose events --json
exec        #进入指定容器进行操作 
help        #获取有关命令的帮助
images      #显示当前服务器的 docker 镜像信息 
kill        #强制终止运行中的容器
logs        #查看容器的日志
pause       #暂停服务
port        #打印端口绑定的公共端口
ps          #列出容器
pull        #拉取服务映像
push        #推送(上传)服务映像
restart     #重新启动服务
rm          #删除停止的容器
run         #运行一次性命令,等于 docker run --rm 
scale       #设置指定服务运行的容器个数 docker-compose scale nginx=2
start       #启动服务
stop        #停止服务
top         #显示正在运行的进程
unpause     #取消暂停服务
up          #创建和启动容器
version     #显示Docker Compose版本信息


1、启动服务容器
docker-compose up [options] [–scale SERVICE=NUM…] [SERVICE…]
选项包括:
	-d 在后台运行服务容器
	–no-color 不使用颜色来区分不同的服务的控制输出
	–no-deps 不启动服务所链接的容器
	–force-recreate 强制重新创建容器,不能与–no-recreate同时使用
	–no-recreate 如果容器已经存在,则不重新创建,不能与–force-recreate同时使用
	–no-build 不自动构建缺失的服务镜像
	–build 在启动容器前构建服务镜像
	–abort-on-container-exit 停止所有容器,如果任何一个容器被停止,不能与-d同时使用
	-t, –timeout TIMEOUT 停止容器时候的超时(默认为10秒)
	–remove-orphans 删除服务中没有在compose文件中定义的容器
	–scale SERVICE=NUM 设置服务运行容器的个数,将覆盖在compose中通过scale指定的参数
	-f 指定使用的Compose模板文件,默认为docker-compose.yml,可以多次指定。

docker-compose -f docker-compose.yml up -d


2、显示正在运行的进程:
docker-compose top


3、 列出项目中目前的所有容器
docker-compose ps [options] [SERVICE…]


4、停止容器
docker-compose stop [options] [SERVICE…]
选项包括:
	-t, –timeout TIMEOUT 停止容器时候的超时(默认为10秒)

5、停止和删除容器、网络、卷、镜像。 
docker-compose down [options]
选项包括:
	–rmi type,删除镜像,类型必须是:all,删除compose文件中定义的所有镜像;local,删除镜像名为空的镜像
	-v, –volumes,删除已经在compose文件中定义的和匿名的附在容器上的数据卷
	–remove-orphans,删除服务中没有在compose中定义的容器


docker-compose logs [options] [SERVICE…]
查看服务容器的输出。默认情况下,docker-compose将对不同的服务输出使用不同的颜色来区分。可以通过–no-color来关闭颜色。


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来重新构建服务


docker-compose pull [options] [SERVICE…]
拉取服务依赖的镜像。
选项包括:
	–ignore-pull-failures,忽略拉取镜像过程中的错误
	–parallel,多个镜像同时拉取
	–quiet,拉取镜像过程中不打印进度信息


docker-compose restart [options] [SERVICE…]
重启项目中的服务。 选项包括:
	-t, –timeout TIMEOUT,指定重启前停止容器的超时(默认为10秒)
	

docker-compose rm [options] [SERVICE…]
删除所有(停止状态的)服务容器。 选项包括:
	–f, –force,强制直接删除,包括非停止状态的容器
	-v,删除容器所挂载的数据卷


docker-compose run [options] [-v VOLUME…] [-p PORT…] [-e KEY=VAL…] SERVICE [COMMAND] [ARGS…]
在指定服务上执行一个命令。 在指定容器上执行一个ping命令。
docker-compose run ubuntu ping www.baidu.com

docker-compose scale
设置指定服务运行的容器个数。通过service=num的参数来设置数量
docker-compose scale web=3 db=2


docker-compose pause [SERVICE…]
暂停一个服务容器


docker-compose kill [options] [SERVICE…]
通过发送SIGKILL信号来强制停止服务容器。
支持通过-s参数来指定发送的信号,例如通过如下指令发送SIGINT信号:
docker-compose kill -s SIGINT


docker-compose config [options]
验证并查看compose文件配置。
选项包括:
	–resolve-image-digests 将镜像标签标记为摘要
	-q, –quiet 只验证配置,不输出。 当配置正确时,不输出任何内容,当文件配置错误,输出错误信息
	–services 打印服务名,一行一个
	–volumes 打印数据卷名,一行一个

docker-compose create [options] [SERVICE…]
为服务创建容器。
选项包括:
	–force-recreate:重新创建容器,即使配置和镜像没有改变,不兼容–no-recreate参数
	–no-recreate:如果容器已经存在,不需要重新创建,不兼容–force-recreate参数
	–no-build:不创建镜像,即使缺失
	–build:创建容器前,生成镜像
	

docker-compose exec [options] SERVICE COMMAND [ARGS…]
选项包括:
	-d 分离模式,后台运行命令。
	–privileged 获取特权。
	–user USER 指定运行的用户。
	-T 禁用分配TTY,默认docker-compose exec分配TTY。
	–index=index,当一个服务拥有多个容器时,可通过该参数登陆到该服务下的任何服务,例如:docker-compose exec –index=1 web /bin/bash ,web服务中包含多个容器


docker-compose port [options] SERVICE PRIVATE_PORT
显示某个容器端口所映射的公共端口。
选项包括:
	–protocol=proto,指定端口协议,TCP(默认值)或者UDP
	–index=index,如果同意服务存在多个容器,指定命令对象容器的序号(默认为1)


docker-compose push [options] [SERVICE…]
推送服务依的镜像。
选项包括:
  –ignore-push-failures 忽略推送镜像过程中的错误
  

docker-compose unpause [SERVICE…]
恢复处于暂停状态中的服务。















        

  

posted @ 2022-11-15 15:32  yuanbangchen  阅读(210)  评论(0编辑  收藏  举报